DSM/Tape Catalog Operator Interface (MEDIACOM) Manual Abstract This manual explains how to run a MEDIACOM session and describes the purpose and syntax of the MEDIACOM commands. Product Version DSM/TC H01 Supported Release Version Updates (RVUs) This manual supports G06.23 and all subsequent G-series RVUs, H06.03 and all subsequent H-series RVUs, and J06.03 and all subsequent J-series RVUs, until otherwise indicated by its replacement publication.
Document History Part Number Product Version Published 429828-005 DSM/TC G06 September 2004 429828-006 DSM/TC G06 February 2006 429828-007 DSM/TC H01 February 2008 429828-008 DSM/TC H01 May 2010 429828-010 DSM/TC H01 February 2013
Legal Notices Copyright 2013 Hewlett-Packard Development Company L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice.
DSM/Tape Catalog Operator Interface (MEDIACOM) Manual Index Figures Tables Legal Notices What’s New in This Manual vii Manual Information vii New and Changed Information viii About This Manual xi Audience xi Manual Organization xii Related Manuals xii Notation Conventions xii 1.
Contents 2. MEDIACOM Commands (continued) 2.
Contents 2. MEDIACOM Commands (continued) 2.
Contents B. Labeling and Density Guidelines B. Labeling and Density Guidelines C. Syntax Summary MEDIACOM Syntax C-1 Index Figures Figure 2-1. Figure 2-2. Figure 2-3. Figure 2-4. Figure 2-5. Figure 2-6. Figure 2-7. Figure 2-8. Figure 2-9. Figure 2-10. Figure 2-11. Figure 2-12. Figure 2-13.
Contents Table A-6. Table B-1.
Contents DSM/Tape Catalog Operator Interface (MEDIACOM) Manual—429828-010 vi
What’s New in This Manual Manual Information DSM/Tape Catalog Operator Interface (MEDIACOM) Manual Abstract This manual explains how to run a MEDIACOM session and describes the purpose and syntax of the MEDIACOM commands. Product Version DSM/TC H01 Supported Release Version Updates (RVUs) This manual supports G06.23 and all subsequent G-series RVUs, H06.03 and all subsequent H-series RVUs, and J06.03 and all subsequent J-series RVUs, until otherwise indicated by its replacement publication.
What’s New in This Manual New and Changed Information New and Changed Information Changes to the H06.26/J06.15 Updated the following sections with LTO5 tape product: ADD POOL Command (Super Group Only) on page 2-9. ADD TAPEVOLUME Command (Super Group Only) on page 2-28. ALTER POOL Command (Super Group Only) on page 2-50. ALTER TAPEVOLUME Command (Super Group Only) on page 2-68. LABEL TAPEVOLUME Command (Super Group Only) on page 2-142. MEDIACOM Syntax on page C-1.
What’s New in This Manual Changes to the H06.13 Manual DRIVE TYPES-supported MEDIA TYPES on page 2-181 DRIVE TYPE-default MEDIA TYPE on page 2-181 Added table Behavior of the CART3480 Media Type Tapevolume on page 2-182. Changes to the H06.13 Manual Modified the description of ALTER TAPEVOLUME on page 2-4.
What’s New in This Manual Changes to the G06.23 Manual Added options for the TYPE attribute in: ADD POOL command on page C-1 ADD TAPEVOLUME command on page C-2 ALTER POOL command on page C-3 LABEL TAPEVOLUME command on page C-6 Changes to the G06.23 Manual This edition of the DSM/Tape Catalog Operator Interface (MEDIACOM) Manual contains the following changes: Clarity was added to the RECOVER DISKFILE Command on page 2-152.
About This Manual MEDIACOM is an operator interface for labeled-tape operations. MEDIACOM is also the operator interface to the Distributed Systems Management/Tape Catalog (DSM/TC) system. You can run this interactive program from any node in the DSM/TC system. When operating in a DSM/TC environment, the catalog entries in the DSM/TC databases are automatically created, maintained, and deleted. However, there are situations when you must manually add, revise, or delete a catalog entry.
About This Manual Manual Organization Manual Organization This manual provides a description of how to run MEDIACOM and explains the language elements and syntax of the MEDIACOM commands. The material is organized in reference format, not in step-by-step descriptions of how to use the commands. Related Manuals You should have three other manuals for DSM/TC: DSM/Tape Catalog User’s Guide—Describes the DSM/TC product.
About This Manual General Syntax Notation computer type. Computer type letters within text indicate C and Open System Services (OSS) keywords and reserved words. Type these items exactly as shown. Items not enclosed in brackets are required. For example: myfile.c italic computer type. Italic computer type letters within text indicate C and Open System Services (OSS) variable items that you supply. Items not enclosed in brackets are required. For example: pathname [ ] Brackets.
About This Manual General Syntax Notation Punctuation. Parentheses, commas, semicolons, and other symbols not previously described must be typed as shown. For example: error := NEXTFILENAME ( file-name ) ; LISTOPENS SU $process-name.#su-name Quotation marks around a symbol such as a bracket or brace indicate the symbol is a required character that you must type as shown. For example: "[" repetition-constant-list "]" Item Spacing.
About This Manual Notation for Messages !o:i. In procedure calls, the !o:i notation follows an output buffer parameter that has a corresponding input parameter specifying the maximum length of the output buffer in bytes. For example: error := FILE_GETINFO_ ( filenum , [ filename:maxlen ] ) ; !i !o:i Notation for Messages This list summarizes the notation conventions for the presentation of displayed messages in this manual. Bold Text. Bold text in an example indicates user input typed at the terminal.
About This Manual Notation for Management Programming Interfaces either vertically, with aligned braces on each side of the list, or horizontally, enclosed in a pair of braces and separated by vertical lines. For example: obj-type obj-name state changed to state, caused by { Object | Operator | Service } process-name State changed from old-objstate to objstate { Operator Request. } { Unknown. } | Vertical Line.
About This Manual Change Bar Notation Change Bar Notation Change bars are used to indicate substantive differences between this manual and its preceding version. Change bars are vertical rules placed in the right margin of changed portions of text, figures, tables, examples, and so on. Change bars highlight new or revised information. For example: The message types specified in the REPORT clause are different in the COBOL85 environment and the Common Run-Time Environment (CRE).
About This Manual Change Bar Notation DSM/Tape Catalog Operator Interface (MEDIACOM) Manual—429828-010 xviii
1 Using MEDIACOM MEDIACOM is an interactive interface. MEDIACOM commands executed during a session take effect immediately on the node specified. Command syntax lets you specify a node. To start a MEDIACOM session, enter a run command at the command interpreter prompt. The three running modes are: Executeand-quit MEDIACOM executes specified commands and then returns control to the command interpreter.
Using MEDIACOM RUN Command Syntax CPU cpu is the processor in which the MEDIACOM process is to run. Specify cpu as a number in the range 0 through 15. If you omit this option, the command interpreter randomly chooses a processor. IN in-file is the file that MEDIACOM uses as a command input file. If you omit this option, MEDIACOM uses the IN file currently defined for your command interpreter (usually your home terminal). As an IN file, you can specify an EDIT file containing MEDIACOM commands.
Using MEDIACOM RUN Command Syntax OUT [ out-file ] specifies a file that MEDIACOM uses as an output file. MEDIACOM writes all input commands and command responses to its current output file. Specify a disk file name or process name for out-file. If out-file does not exist, MEDIACOM creates an EDIT-format file (file code 101) and writes its output to that file. If out-file already exists, MEDIACOM overwrites that file. If you include OUT with no out-file, MEDIACOM produces no output text.
Using MEDIACOM Common Language Elements Common Language Elements Many syntax elements in the MEDIACOM command language are common to several commands: Element Name Used in Command Syntax Page Device name $device 1-4 Disk file name disk-file-name 1-4 Disk subvolume name subvolume 1-5 Disk volume name $volume 1-5 File catalog name file-catalog-name 1-6 Node name \node 1-6 Output file name out-file 1-6 Pool name pool-name 1-7 Tape drive name $tape 1-7 Tape file name tape-file-i
Using MEDIACOM Disk Subvolume Names $volume is the name of a disk volume. It begins with a $ character, followed by 1 through 7 alphanumeric characters. The first character after $ must be alphabetic. If a node name is not given, the default is the name set by the VOLUME command. subvolume is the name of a subdivision of a disk volume. It is 1 through 8 alphanumeric characters long. The first character must be alphabetic. If a subvolume name is not given, the default is the name set by the VOLUME command.
Using MEDIACOM File Catalog Names Examples $SALES $DEPT34G File Catalog Names A file catalog name, referred to as file-catalog-name in command syntax, is the logical name of the NonStop SQL/MP database in which catalog entries for tape and disk files are stored. It is 1 through 21 characters long. The first character must be alphabetic.
Using MEDIACOM Pool Names Examples $SPL33 MYSTUFF $TERM22 (process name) (disk file-ID) (device name) Pool Names A pool name, referred to as pool-name in command syntax, is the logical name of a pool within a volume catalog. It is 1 through 30 alphanumeric characters long. The first character must be alphabetic.
Using MEDIACOM Tape File Names Numbers 0 through 9 Group A special characters: ! question mark > greater-than sign ‘ single quotation mark = equal sign % percent sign ? question mark * asterisk # pound sign . period _ underscore + plus sign : colon - minus sign / slash < less-than sign “ double quotation mark When you use Group A characters in a tape file name, the name does not have to be enclosed by quotation marks in command syntax.
Using MEDIACOM Tape Names space , comma ( right parenthesis ) left parenthesis ; semicolon & ampersand When you use Group B characters in a tape file name, enclose the name in double quotation marks in the command syntax. Examples MONTHLY_BACKUP_FOR_APRIL_1993 45_RECORDS STOCK_PRICES_FOR_MAY/13/1993 CASH_FLOW_REPORT_'CONFIDENTIAL' STOCK"PRICES OUTSTANDING ACCTS_(3RD QUARTER ONLY) CORPORATE&FIELD_EMPLOYEES The last two names contain Group B special characters.
Using MEDIACOM Tape Names * asterisk # pound sign . period _ underscore + plus sign : colon - minus sign / slash < less-than sign “ double quotation mark When you use Group A characters in a tape name, the name does not have to be enclosed by quotation marks in command syntax.
Using MEDIACOM ) left parenthesis ; semicolon & ampersand Volume Catalog Names When using Group B characters in a tape name, enclose the name in double quotation marks in command syntax. Examples 445902 %OP330 T/113 T"60 TAP 01 &PAY23 The last two names contain Group B special characters.
Using MEDIACOM Wild-Card Characters Wild-Card Characters MEDIACOM allows wild-card characters in various names. The command descriptions in Section 2, MEDIACOM Commands, indicate when you can use wild-card characters. You cannot use them if wild-card characters are not mentioned in an element’s description. These wild-card characters are supported: * An asterisk matches any number of characters (zero, one, or more). ? A question mark matches a single character.
2 MEDIACOM Commands This section describes the MEDIACOM commands in detail. Table 2-1 through Table 2-8 on page 2-5 summarize the commands by various management tasks, such as configuring a DSM/TC system and manually changing a catalog entry. Managing the Session Environment Many of the commands listed in Table 2-1 are used in every MEDIACOM session. In general, they manage details of the session environment, such as setting default values that apply to that session only. Table 2-1.
MEDIACOM Commands Managing Tape Mounts Managing Tape Mounts Table 2-2 lists the commands that control various aspects of tape mount requests and tape console devices. They are frequently used on a daily basis to handle tape requests. Table 2-2.
MEDIACOM Commands Managing Disk File Entries Managing Disk File Entries Usually, catalog entries for disk files of backup tapes are created, maintained, and deleted by the DSM/TC system. However, sometimes you need to manually change the status of a disk file entry or retrieve catalog information for an entry. Use the commands in Table 2-4 for these occasional operations. Use the RECOVER DISKFILE command to copy a file from a backup tape to disk by invoking the RESTORE utility on behalf of the user.
MEDIACOM Commands Managing Tapes and Pools Managing Tapes and Pools Use the commands in Table 2-6 to manage tapes cataloged in the DSM/TC system. Table 2-6.
MEDIACOM Commands Configuring DSM/TC Configuring DSM/TC Use the commands in Table 2-8 mainly when configuring a DSM/TC system for the first time. From time to time you might also need them to change some aspect of your configuration. Table 2-8.
MEDIACOM Commands TAPECOM Equivalent Commands Table 2-9.
MEDIACOM Commands Continuing a Command Line Continuing a Command Line When an ampersand (&) appears at the end of a MEDIACOM command, it signals that a continuation of that line follows on the next physical line. MEDIACOM displays three greater-than characters (>>>) at the beginning of each continued line. Individual keywords, strings, and other values can be broken across lines. They need not be continued on a single command line.
MEDIACOM Commands ACCEPT TAPEMOUNT Command (Super Group Only) You need not enter the commands this way. Shorter command examples appear on one line: MC> ALTER MEDIADEFS, RESET EXPIRATION ACCEPT TAPEMOUNT Command (Super Group Only) ACCEPT TAPEMOUNT lets an application use the tape drive it requests when: The tape drive request is for bypass label processing (BLP) mode on a tape drive with the BLPCHECK option set to on.
MEDIACOM Commands ADD POOL Command (Super Group Only) Example In this example, a tape drive request is made for bypass label processing. The tape drive has BLPCHECK set to on. This message appears on the tape console: ... $ZSVR : 0005 *MC* REQUEST TO USE $TD002 WITH NO LABEL PROTECTION To determine what action to take next: MC> STATUS TAPEMOUNT 5 Tape Mount ----5 Tape Name ---**BLP Tape Type ---REQUEST** Node or Device -------------\SKY.
MEDIACOM Commands ADD POOL Command (Super Group Only) APPEND { ON | OFF } designates whether tape volumes of LABELS type BACKUP can contain multiple tape files. This option does not affect tapes of LABELS type ANSI and IBM, which can always contain multiple tape files. APPEND is not allowed on open-reel tape drives since this drive type does not have the technology needed to support APPEND. Thus, a setting of APPEND ON has no effect on pools of TYPE OPEN.
MEDIACOM Commands ADD POOL Command (Super Group Only) ANY All label types are permitted. The default is ANY. BACKUP The label is in a special format used by BACKUP and BACKCOPY. For more information on this label type, see Considerations on page 2-12. IBM The label is in IBM-MVS format. For detailed information on this label format, see Appendix A, Tape Label Formats.
MEDIACOM Commands ADD POOL Command (Super Group Only) DLTIII Only DLTIII tapes are permitted. DLTIV Only DLTIV tapes are permitted. LTO1 Only LTO1 tapes are permitted. LTO2 Only LTO2 tapes are permitted. LTO3 Only LTO3 tapes are permitted. LTO4 Only LTO4 tapes are permitted. LTO5 Only LTO5 tapes are permitted. OPEN Only open-reel tapes are permitted. SDLT Only SDLT tapes are permitted.
MEDIACOM Commands ADD POOL Command (Super Group Only) Considerations Density conflict when writing a tape The density of all tapes in a pool must agree with the pool’s density if the pool was assigned a density other than ANY. The tape’s density is used when writing data to it. If you specify a density in a TAPECATALOG DEFINE that is different from the density of the tape, a conflict arises over which density to use.
MEDIACOM Commands ADD POOL Command (Super Group Only) cannot use ALTER POOL to change the search space attribute. To change an existing pool’s search space attribute: 1. Use INFO TAPEVOLUME to find out the status of the tapes in the pool. 2. Use DELETE TAPEFILE and then DELETE TAPEVOLUME, if applicable, to remove the pool entries for tapes of status assigned. 3. Use DELETE TAPEVOLUME to remove the pool entries for tapes of status scratch, released, or bad. 4.
MEDIACOM Commands ADD TAPEFILE Command (Super Group Only) ADD TAPEFILE Command (Super Group Only) ADD TAPEFILE manually catalogs a tape file from a tape created by BACKUP, BACKCOPY, or other processes. The tape must belong to a pool and volume catalog before you execute ADD TAPEFILE. If it does not, add it to a pool with ADD TAPEVOLUME, specifying the tape’s status as scratch. ADD TAPEFILE changes the tape’s status to assigned in the volume catalog as it catalogs the tape file in the file catalog.
MEDIACOM Commands ADD TAPEFILE Command (Super Group Only) the tape’s label. When tape-file-id is not given, the file name in the tape’s label is used for the catalog entry. You must specify tape-file-id when there is no tape file-ID in the tape label. For more information, see Considerations on page 2-19. MODE { BACKFILE | BACKVOLUME | USER } specifies the origin of the tape file: BACKFILE The tape file was created by BACKUP in file mode or copied by BACKCOPY from a file-mode backup tape set.
MEDIACOM Commands ADD TAPEFILE Command (Super Group Only) month is the month of the year, entered as jan, feb, mar, apr, may, jun, jul, aug, sep, oct, nov, or dec. day is the day of the month, entered as a number in the range 1 through 31. year is the century and year, entered as a 4-digit number; for example, 1993 or 2046. FILECAT \node.file-catalog-name is the logical name of the file catalog in which to create the entry. Include \node when the file catalog is not on your current default node.
MEDIACOM Commands ADD TAPEFILE Command (Super Group Only) OFF Polling is performed immediately by the tape drive. This message is sent to the current default output file (usually your home terminal): \node.$tape: not ready -- beginning to poll ... When the tape is mounted, ADD TAPEFILE continues processing. TAPEDRIVE \node.$tape is a tape drive name. Include \node when the tape drive is not on your current default node. The default is the name set by the TAPEDRIVE command.
MEDIACOM Commands ADD TAPEFILE Command (Super Group Only) Considerations Tape file names At the time a tape file is created, its name is written to the tape’s label and to the file catalog entry. The tape label can store a maximum of 17 characters, so for tape file names of 1 through 17 characters, the tape labels and the catalog entries contain the same names. However, a TAPECATALOG DEFINE can specify a tape file name of up to 60 characters.
MEDIACOM Commands ADD TAPEFILE Command (Super Group Only) Using the VOLUMEINDEX option When cataloging a tape file written on two or more tapes, you must know the order that the tapes were used so you can mount them in the correct order for the ADD TAPEFILE commands and specify the correct sequence value for the VOLUMEINDEX option. (VOLUMEINDEX accounts for tape order in the catalog.
MEDIACOM Commands ADD TAPEFILE Command (Super Group Only) The cataloged tape file, FIRST_QTR_93_SUMMARY_DATA, expired in the catalog on February 1, 1993. However, it should remain cataloged for another six months.
MEDIACOM Commands ADD TAPELABEL Command (Super Group Only) ADD TAPELABEL Command (Super Group Only) ADD TAPELABEL performs these operations on a tape: Creates a standard ANSI tape label Creates a standard IBM-MVS tape label Creates a tape label used by BACKUP Overwrites an existing label with new values (referred to as relabeling a tape) Changes an unexpired labeled tape’s status to scratch Automatically loads and unloads tapes to be labeled The main purpose of ADD TAPELABEL is to initializ
MEDIACOM Commands ADD TAPELABEL Command (Super Group Only) When labeling a large number of unlabeled tapes with the same label format and information, you can give multiple tape names rather than entering ADD TAPELABEL for each tape. A maximum of 100 names is permitted. If you are using the NEWNAME option (described in this subsection), only one tape-name is allowed. DENSITY { 1600 | 6250 } defines the density for the tape. The default for open-reel tape is 1600. (There is no default for cartridge tapes.
MEDIACOM Commands ADD TAPELABEL Command (Super Group Only) Any data on the tape becomes inaccessible. Use this option only with the TAPEDRIVE, PROMPT, and UNLOAD options. If a tape in DSM/TC has the same name as this command specifies (for example, tape-name), this option cannot be used. OVERRIDE { ON | OFF } determines whether to check if the tape is labeled and to check the system search space for a duplicate tape name.
MEDIACOM Commands ADD TAPELABEL Command (Super Group Only) Press the RETURN key to start the polling process. When the tape is mounted, ADD TAPELABEL continues processing. The default is ON. To end ADD TAPELABEL without further processing, you can enter stop rather than press the RETURN key. OFF Polling is performed immediately by the tape drive. This message is sent to the current default output file (usually your home terminal): \node.$tape: not ready -- beginning to poll ...
MEDIACOM Commands ADD TAPELABEL Command (Super Group Only) Premounting tapes If you mount a new tape before issuing the ADD TAPELABEL command, DSM/TC generates this mount request: *unreadable tape* $tape accept or reject tapemount Although you can accept or reject the tapemount, if you initiate and complete the ADD TAPELABEL command, this mount request is cleared. (It does not appear in the display from a STATUS TAPEMOUNT.
MEDIACOM Commands >>> >>> ADD TAPELABEL Command (Super Group Only) OVERRIDE ON,& LABELS ANSI TAPE TAPE TAPE TAPE TAPE VOLUME VOLUME VOLUME VOLUME VOLUME ANSI01 ANSI02 ANSI03 ANSI04 ANSI05 INITIALIZED INITIALIZED INITIALIZED INITIALIZED INITIALIZED 3. To label two IBM tape volumes: MC> ADD TAPELABEL (IBM001, IBM002),& >>> TAPEDRIVE $TAPE0,& >>> OVERRIDE ON,& >>> LABELS IBM TAPE VOLUME IBM001 INITIALIZED TAPE VOLUME IBM002 INITIALIZED 4.
MEDIACOM Commands ADD TAPEVOLUME Command (Super Group Only) 8. This example changes three tapes that contain unexpired files to scratch tapes. Each tape is mounted on the default tape drive for the session. MC> ADD TAPELABEL (V11233, V11244, V20055),& >>> SCRATCH ADD TAPEVOLUME Command (Super Group Only) ADD TAPEVOLUME manually catalogs a tape in a pool and volume catalog if the tape satisfies the pool’s attributes and the tape name is not duplicated in the system search space.
MEDIACOM Commands ADD TAPEVOLUME Command (Super Group Only) This option is intended for cataloging a large quantity of tapes that were consecutively named when labeled. Specify one tape-name that is composed of all numbers or ends in a number, such as TAP001. After tape-name is cataloged, it is incremented by 1 for the second tape-name to catalog, and so on. Before ADD TAPEVOLUME begins cataloging any of the tapes, it checks to make sure the tape naming convention works for the number of tapes specified.
MEDIACOM Commands ADD TAPEVOLUME Command (Super Group Only) OFF catalogs the tape when no duplicate name is found in the entire system search space. If the entire system search space is not available, ADD TAPEVOLUME does not execute. The default is OFF. STATUS { RELEASED | SCRATCH } is the tape’s status: RELEASED All files on the tape might be expired, but the tape should not be reused until its status in the catalog is manually changed to scratch with ALTER TAPEVOLUME.
MEDIACOM Commands ADD TAPEVOLUME Command (Super Group Only) DDS3 Only DDS3 tapes are permitted. DLTIII Only DLTIII tapes are permitted. DLTIV Only DLTIV tapes are permitted. LTO1 Only LTO1 tapes are permitted. LTO2 Only LTO2 tapes are permitted. LTO3 Only LTO3 tapes are permitted. LTO4 Only LTO4 tapes are permitted. LTO5 Only LTO5 tapes are permitted. OPEN Only open-reel tapes are permitted. SDLT Only SDLT tapes are permitted.
MEDIACOM Commands ALTER CONSOLE Command (Super Group Only) Usually you need to change the TAPECATALOG DEFINE to remove or revise its DENSITY attribute before rerunning the application. Cartridge tapes in a tape library Cartridge tapes stored in a tape library should be cataloged in the same pool with a type of cart3480. Such tapes should always be kept in the tape library unless they are removed for long-term storage or because they are defective.
MEDIACOM Commands ALTER CONSOLE Command (Super Group Only) If you use this command without any options, the current device (the device from which you are running MEDIACOM and this command) becomes the console. ALTER CONSOLE [ \node ] [ , DEVICE [ \node.]$device ] [ , RESET DEVICE ] \node is the name of a node other than the current default node. When not given, your current default node is used. DEVICE [\node.]$device defines the device to be the console.
MEDIACOM Commands ALTER CONSOLE Command (Super Group Only) In this example, the terminal assigned as the tape console is dedicated to tape related messages with the PAUSE command: MC> ALTER CONSOLE, DEVICE $TERM5 1 console altered.
MEDIACOM Commands ALTER DISKFILE Command (Super Group Only) ALTER DISKFILE Command (Super Group Only) Occasionally a disk file written to tape by the Backup utility (T9074) or BACKCOPY should not be used by RECOVER DISKFILE. Something might be wrong with the disk file’s data, or the tape might be unreadable where the file was written on the tape. If the disk files for a backup tape are cataloged, you can keep track of unsuitable disk files by marking their entries invalid with ALTER DISKFILE.
MEDIACOM Commands ALTER DISKFILE Command (Super Group Only) ALL changes all generations of the tape file entries that own a disk file entry for disk-file-name. STATUS { INVALID | VALID } is the status of the disk file entry: INVALID This entry represents a disk file that RECOVER DISKFILE should not use. VALID This entry represents a disk file that RECOVER DISKFILE can use. FILECAT \node.file-catalog-name is the logical name of the file catalog that owns the entry to alter.
MEDIACOM Commands ALTER DISKFILE Command (Super Group Only) This option specifies which physical copy is associated with tape-file-id (and disk-file-name): physical changes the disk file entry based on a physical copy number. Specify physical as a number in the range 1 through 99. The default is 1. If physical refers to a pair of tape sets from a parallel BACKUP or parallel BACKCOPY run, only entries for logical copy 1 of the pair are changed if you do not use the LOGICAL option with the PHYSICAL option.
MEDIACOM Commands >>> >>> ALTER FILECAT Command (Super Group Only) PHYSICAL ALL,& LOGICAL ALL A file of test data should no longer be used for recovery purposes. Because BACKUP was run daily and weekly on the volume where the test file resided, backup tapes are cataloged as TEST_DAILY_BACKUP and TEST_WEEKLY_BACKUP. This command changes the status for the test file in all generations of those backup tapes, including all physical and logical copies. MC> ALTER DISKFILE $TEST.QA1.
MEDIACOM Commands ALTER MEDIADB Command (Super Group Only) SECURE "code" defines the new security level for the file catalog. Specify code as a character string representing operating system security levels for read, write, execute, and purge access. Enclose the string in quotation marks. For information on security levels, see the Guardian User’s Guide. Consideration Take care when changing the values of the security level or owner of a file catalog.
MEDIACOM Commands ALTER MEDIADEFS Command (Super Group or SECURITY-MEDIA-ADMIN Only) ALTER MEDIADEFS Command (Super Group or SECURITY-MEDIA-ADMIN Only) Note. If configured, this command can only be executed by SECURITY-MEDIA-ADMIN group users. If not, only Super group users can execute this command. For information on SECURITY-MEDIA-ADMIN group, see the DSM/Tape Catalog User's Guide. Use ALTER MEDIADEFS primarily to configure various aspects of the DSM/TC system after installing DSM/TC.
MEDIACOM Commands ALTER MEDIADEFS Command (Super Group or SECURITY-MEDIA-ADMIN Only) In addition to configuring system defaults, creating system search lists, and setting the tape level support, use ALTER MEDIADEFS to confirm that the automatic clean-up process can run after an error condition occurs.
MEDIACOM Commands ALTER MEDIADEFS Command (Super Group or SECURITY-MEDIA-ADMIN Only) PERMANENT keeps the entry until it is erased with DELETE TAPEFILE. A permanent entry can subsequently be given an expiration date with ALTER TAPEFILE, in which case it remains in the catalog until it expires. RESET ABENDRETENTION changes the current ABENDRETENTION value to 1.
MEDIACOM Commands ALTER MEDIADEFS Command (Super Group or SECURITY-MEDIA-ADMIN Only) RESET COMPRESSION changes the current COMPRESSION value to OFF. FILECAT \node.file-catalog-name is the logical name of the file catalog to use when it is not given in a TAPECATALOG DEFINE. This also becomes the session default name for a file catalog when one is not explicitly set with a FILECAT command. Include \node when the file catalog is not on your current default node.
MEDIACOM Commands ALTER MEDIADEFS Command (Super Group or SECURITY-MEDIA-ADMIN Only) TPTM At this level, the TPTM is used, and DSM/TC is not consulted. Labeled and unlabeled tape processing is permitted, but only CLASS TAPECATALOG DEFINEs are allowed. TPTMCOMPATIBLE At this level, the TPTM is used, and DSM/TC is not consulted. Labeled and unlabeled tape processing is permitted. Both CLASS TAPE and TAPECATALOG DEFINEs are allowed. RESET LEVEL changes the current tape support level to NOCATALOG.
MEDIACOM Commands ALTER MEDIADEFS Command (Super Group or SECURITY-MEDIA-ADMIN Only) SSLIST { \command-node } { ( \command-node [ , \remote-node ] ... ) } creates the system search list for a node. If DSM/TC is installed on only one node, specify command-node only. If DSM/TC is installed on several nodes, specify command-node and the remote node names in any order in the list. Note. The SSLIST on all nodes must be the same for interoperability among nodes.
MEDIACOM Commands ALTER MEDIADEFS Command (Super Group or SECURITY-MEDIA-ADMIN Only) the chances of finding a tape in the tape library to satisfy a mount request for a scratch tape. With AUTOMATED ON, $ZSVR automatically requests DSM/TC to select another scratch tape from the pool named in the DEFINE if the first one selected is unavailable in the tape library. If the second tape is unavailable, $ZSVR makes another request of DSM/TC. This cycle can repeat up to nine times after the initial request.
MEDIACOM Commands UNLABELED ALTER MEDIADEFS Command (Super Group or SECURITY-MEDIA-ADMIN Only) Unlabeled tape processing only is permitted. No DEFINEs can be used. If DEFINEs are used, you receive this error message: 113 DEFINE class or attributes are not valid for the attempted function NOCATALOG Unlabeled and labeled tape processing is permitted. Only TAPE DEFINEs or TAPECATALOG DEFINEs with the CATALOG attribute set to OFF are recognized. No cataloging takes place even if DSM/TC is installed.
MEDIACOM Commands ALTER MEDIADEFS Command (Super Group or SECURITY-MEDIA-ADMIN Only) TMF and DSM/TC If your site uses TMF, it functions as usual after DSM/TC is installed. However, TMF does not work at the lowest tape support level (UNLABELED). It works at tape support levels NOCATALOG, COMPATIBLE, and MEDIACAT.
MEDIACOM Commands >>> >>> ALTER MEDIADEFS Command (Super Group or SECURITY-MEDIA-ADMIN Only) RETENTION 90,& ABENDRETENTION 0 MC> ALTER MEDIADEFS \STAR,& >>> SSLIST (\SKY, \SEA, \STAR),& >>> FILECAT \STAR.FILE_CATALOG_STAR,& >>> VOLCAT \SKY.MASTER_TAPE_CATALOG,& >>> POOL TAPES_FOR_STAR,& >>> LEVEL COMPATIBLE,& >>> RETENTION 90,& >>> ABENDRETENTION 0 DSM/TC is in full operation on \SKY, \SEA, and \STAR after a two-month conversion process.
MEDIACOM Commands ALTER POOL Command (Super Group Only) ALTER POOL Command (Super Group Only) ALTER POOL changes one or more attributes of an existing pool. If the new attribute conflicts with any tape in the pool, the attribute is not changed. The conflicting tapes must be removed from the pool with DELETE TAPEVOLUME (for scratch tapes) or DELETE TAPEFILE, and then DELETE TAPEVOLUME (for assigned tapes) before you rerun ALTER POOL. You cannot change the search space attribute with this command.
MEDIACOM Commands ALTER POOL Command (Super Group Only) ON indicates that the tape volume of LABELS BACKUP can contain multiple tape files. OFF stipulates that tape volumes can contain a single tape file. The default is OFF. RESET APPEND changes the current APPEND value to OFF. AUTOSCRATCH { ON | OFF } determines the status of a tape in the pool after all the catalog entries for its files have expired: ON A tape’s status is changed to scratch, meaning it is considered empty.
MEDIACOM Commands ALTER POOL Command (Super Group Only) BACKUP The label is in a special format used by BACKUP and BACKCOPY. IBM The label is in IBM-MVS format. For detailed information on this label format, see Appendix A, Tape Label Formats. RESET LABELS changes the current LABELS value to ANY.
MEDIACOM Commands ALTER POOL Command (Super Group Only) DLTIII Only DLTIII tapes are permitted. DLTIV Only DLTIV tapes are permitted. LTO1 Only LTO1 tapes are permitted. LTO2 Only LTO2 tapes are permitted. LTO3 Only LTO3 tapes are permitted. LTO4 Only LTO4 tapes are permitted. LTO5 Only LTO5 tapes are permitted. OPEN Only open-reel tapes are permitted. SDLT Only SDLT tapes are permitted. RESET TYPE changes the current TYPE value to ANY.
MEDIACOM Commands ALTER TAPEDRIVE Command (Super Group Only) MC> ALTER POOL TAPES_FOR_TESTING,& >>> VOLCAT MASTER_TAPE_CATALOG,& >>> DENSITY 6250 ALTER TAPEDRIVE Command (Super Group Only) ALTER TAPEDRIVE determines whether approval must be given for an application to use a tape drive for bypass label processing mode (BLPCHECK) or no label processing mode (NLCHECK).
MEDIACOM Commands ALTER TAPEDRIVE Command (Super Group Only) ON The request must be approved with an ACCEPT TAPEMOUNT command. The default is ON. OFF No approval is necessary. RESET BLPCHECK changes the current setting for $tape to ON. LSM drive-address associates a tape drive in an LSM with $tape. Specify drive-address in this format: ( ACS-id, LSM-id, panel-id, drive-id ) ACS-id is a number in the range 0 through 126 that identifies a group of LSMs connected to form one tape library.
MEDIACOM Commands ALTER TAPEDRIVE Command (Super Group Only) OFF No approval is necessary. RESET NLCHECK changes the current setting for $tape to ON. RESERVE { ON | OFF } reserves the tape drive for parallel tape operations such as parallel backup: ON The tape drive is reserved for parallel tape operations. OFF The tape drive is not reserved for parallel tape operations. The default is OFF. RESET RESERVE changes the current setting for $tape to OFF.
MEDIACOM Commands ALTER TAPEDRIVE Command (Super Group Only) use. If the premounted tape should be used, you must issue an ACCEPT TAPEMOUNT command to permit BLP processing and reload the tape on the drive so the application can access it. If BLPCHECK is set to OFF when a tape drive is opened for write access in BLP mode, a premounted labeled tape is not unloaded. The application is given access to it without further approval. Do not use cataloged labeled tapes in BLP mode.
MEDIACOM Commands ALTER TAPEFILE Command (Super Group or SECURITY-MEDIA-ADMIN Only) ALTER TAPEFILE Command (Super Group or SECURITY-MEDIA-ADMIN Only) Note. If configured, this command can only be executed by SECURITY-MEDIA-ADMIN group users. If not, only Super group users can execute this command. For information on SECURITY-MEDIA-ADMIN group, see the DSM/Tape Catalog User's Guide.
MEDIACOM Commands ALTER TAPEFILE Command (Super Group or SECURITY-MEDIA-ADMIN Only) GEN { absolute | ALL } specifies which generation of the tape file entry to alter: absolute changes one generation only. absolute is a number in the range 1 through 32767. ALL changes all generations of the tape file entry. EXPIRATION date is the new date when the entry expires. This value replaces the current expiration date in the tape file entry.
MEDIACOM Commands ALTER TAPEFILE Command (Super Group or SECURITY-MEDIA-ADMIN Only) LOGICAL { logical | ALL } refers to which copy of a tape set created from a parallel BACKUP or a parallel BACKCOPY to change. (When such tape sets are created, the first copy is cataloged as logical copy 1 and the second copy as logical copy 2.) When only one tape set is created by the Backup utility (T9074) or BACKCOPY, it is cataloged as logical copy 1.
MEDIACOM Commands ALTER TAPEFILE Command (Super Group or SECURITY-MEDIA-ADMIN Only) number-of-days is a number in the range 1 through 9999. PERMANENT keeps the entry until its retention period is changed again with ALTER TAPEFILE or the entry is manually erased with DELETE TAPEFILE. You cannot use the EXPIRATION option with RETENTION. STATUS VALID changes the entry’s status from invalid to valid as long as one other file on the tape set has a valid entry.
MEDIACOM Commands ALTER TAPEFILE Command (Super Group or SECURITY-MEDIA-ADMIN Only) disappears at the next clean-up run. To solve this problem, use the EXPIRATION or RETENTION option with the STATUS option to give the entry a new expiration date. Examples The tape file YEAR_END_ACCOUNTING was created with an expiration date that keeps the file six months before it expires.
MEDIACOM Commands ALTER TAPEMOUNT Command (Super Group Only) The files’ owner wants the unexpired files kept in the catalog for a longer period of time.
MEDIACOM Commands ALTER TAPEMOUNT Command (Super Group Only) \node.message-number is the number assigned by $ZSVR to the mount message of the requested tape. Use STATUS TAPEMOUNT to find the number you need. Include \node when the request is not issued from your current default node.
MEDIACOM Commands ALTER TAPEMOUNT Command (Super Group Only) case, this message displays after ALTER TAPEMOUNT was used to select a replacement tape: **ERROR-6310** Only logical copies of the tape file are available. The request must be restarted from the first reel to use a logical copy. To switch to the series copy tape set: 1. Issue REJECT TAPEMOUNT to get rid of the mount message for the unavailable tape. This action also causes RECOVER DISKFILE to end. 2. Restart RECOVER DISKFILE. 3.
MEDIACOM Commands ALTER TAPEMOUNT Command (Super Group Only) tape set. In this case, this message displays after ALTER TAPEMOUNT was used to select a replacement tape: STATUS 2512 - TMF WILL RESTORE AN ALTERNATE SERIES COPY FROM THE BEGINNING To switch to the series copy tape set: 1. Issue REJECT TAPEMOUNT to get rid of the mount message for the unavailable tape. 2. At the TACL prompt, enter a STOP command to terminate the TMF restore utility.
MEDIACOM Commands ALTER TAPEMOUNT Command (Super Group Only) 1. Create more TMF scratch tapes. 2. Mount one of the new tapes to satisfy the mount message. Examples You need to recover some payroll files from the latest generation of payroll backup tapes which is generation 12.
MEDIACOM Commands 11> 11> 11> 11> & & & & ALTER TAPEVOLUME Command (Super Group Only) USE OUT,& VOLUME T66,& POOL ACCT_TAPES,& FILEID WEEKLY_AND_PAYABLE The mount message you see after starting the program is: ... $ZSVR : 0099 *MC* MOUNT T66 WITHOUT WRITE PROTECTION However, you cannot find tape T66, so you use ALTER TAPEMOUNT to have a replacement scratch tape DSM/TC chose: MC> ALTER TAPEMOUNT 99 After DSM/TC chooses a new scratch tape from the ACCT_TAPES pool, a new mount message appears: ...
MEDIACOM Commands ALTER TAPEVOLUME Command (Super Group Only) When changing the status of several tapes, you can give multiple tape names rather than entering ALTER TAPEVOLUME for each tape. A maximum of 100 names is permitted. STATUS { BAD | RELEASED | SCRATCH } is the new status to assign the tape in the entry. If the current status of TAPEVOLUME is set to one of the values in the group { BAD | RELEASED | SCRATCH }, it can be changed only to one of the other values in this same group.
MEDIACOM Commands ALTER TAPEVOLUME Command (Super Group Only) POOL pool-name is the logical name of the pool in which tape-name is cataloged. The default is the name set by the POOL command. Wild-card characters are permitted in this name. This parameter is required if no value is available from the MEDIADEFS defaults or previously set as a MEDIACOM session default. (See the ENV Command on page 2-89.
MEDIACOM Commands ALTER TAPEVOLUME Command (Super Group Only) TYPE { CART3480 | CART3490 | CART5120 | CART9840 | DAT | DDS | DDS2 | DDS3 | DLTIII | DLTIV | LTO1 | LTO2 | LTO3 | LT04 | LT05 | OPEN | SDLT} determines which type of physical tape is allowed of a tape in the pool and in the volume catalog: CART3480 Only model 3480 tape cartridges are permitted. CART3490 Only model 3490 tape cartridges are permitted. CART9840 Only model 9840 tape cartridges are permitted.
MEDIACOM Commands ALTER TAPEVOLUME Command (Super Group Only) LTO3 Only LTO3 tapes are permitted. LTO4 Only LTO4 tapes are permitted. LTO5 Only LTO5 tapes are permitted. OPEN Only open-reel tapes are permitted. SDLT Only SDLT tapes are permitted. Considerations Tape volumes in ASSIGNED or FULL status cannot be altered to SCRATCH, RELEASED, or BAD.
MEDIACOM Commands ALTER VOLCAT Command (Super Group Only) To change the media type of a tape with CART3480 to DAT: MC> ALTER TAPEVOLUME TV1, TYPE DAT To change the media type of a tape with CART3480 to DLTIII and status with SCRATCH to BAD: MC> ALTER TAPEVOLUME TV2, TYPE DLTIII, STATUS BAD, POOL POOL1 A count is returned for the number of pool entries affected by the change.
MEDIACOM Commands ALTER VOLCAT Command (Super Group Only) and purge access. Enclose the string in quotation marks. For information on security levels, see the Guardian User’s Guide. Consideration Take care when changing the values of the security level or owner of a volume catalog. Assuming the values were correct when the volume catalog was created, use ALTER VOLCAT only if the purpose or users of the catalog have changed.
MEDIACOM Commands CREATE FILECAT Command (Super Group Only) CREATE FILECAT Command (Super Group Only) CREATE FILECAT creates a file catalog for the DSM/TC system and assigns it a logical name. Only one file catalog is allowed on a subvolume. However, you can have a file catalog and a volume catalog on the subvolume. When you do this, both catalogs must have the same logical name. When file and volume catalogs are placed on different subvolumes, they must have different logical names.
MEDIACOM Commands CREATE FILECAT Command (Super Group Only) SECURE "code" defines the security level for the file catalog. code is a character string representing the operating system security levels for read, write, execute, and purge access. Enclose the string in quotation marks. When not given, the current default security for your user ID is used. For information on security levels, see the Guardian User’s Guide.
MEDIACOM Commands >>> >>> CREATE VOLCAT Command (Super Group Only) SECURE "NC-O",& OWNER 5,149 CREATE VOLCAT Command (Super Group Only) CREATE VOLCAT creates a volume catalog for the DSM/TC system and assigns it a logical name. Only one volume catalog is allowed. However, you can have a file catalog and a volume catalog on the same subvolume. When you do this, both catalogs must have the same logical name.
MEDIACOM Commands CREATE VOLCAT Command (Super Group Only) The default owner-id is the current user ID in effect when the CREATE VOLCAT command executes. SECURE "code" defines the security level for the volume catalog. code is a character string representing the operating system security levels for read, write, execute, and purge access. Enclose the string in quotation marks. When not given, the current default security for your user ID is used.
MEDIACOM Commands DELETE POOL Command (Super Group Only) This example creates a file and volume catalog on the same subvolume of the current default node. The catalogs have the same logical names as required when the a file and volume catalog are on the same subvolume. MC> CREATE FILECAT TAPE_CATALOG,& >>> SUBVOL $IRIS.TAPECAT,& >>> SECURE "NC-O",& >>> OWNER 5,149 MC> CREATE VOLCAT TAPE_CATALOG,& >>> SUBVOL $IRIS.
MEDIACOM Commands DELETE TAPEFILE Command (Super Group or SECURITY-MEDIA-ADMIN Only) DELETE TAPEFILE Command (Super Group or SECURITY-MEDIA-ADMIN Only) Note. If configured, this command can only be executed by SECURITY-MEDIA-ADMIN group users. If not, only Super group users can execute this command. For information on SECURITY-MEDIA-ADMIN group, see the DSM/Tape Catalog User's Guide. DELETE TAPEFILE removes an unexpired tape file entry from a file catalog.
MEDIACOM Commands DELETE TAPEFILE Command (Super Group or SECURITY-MEDIA-ADMIN Only) This parameter is required if no value is available from the MEDIADEFS defaults or previously set as a MEDIACOM session default. (See the ENV Command on page 2-89.) LOGICAL { logical | ALL } refers to which copy of a tape set created from a parallel BACKUP or a parallel BACKCOPY to delete. (When such tape sets are created, the first copy is cataloged as logical copy 1, and the second copy as logical copy 2.
MEDIACOM Commands DELETE TAPEFILE Command (Super Group or SECURITY-MEDIA-ADMIN Only) because you cannot re-create these types of entries once all of them are deleted. For more information, see Considerations. Considerations Returned messages from DELETE TAPEFILE At the normal completion of DELETE TAPEFILE, two types of messages are returned.
MEDIACOM Commands DELETE TAPEFILE Command (Super Group or SECURITY-MEDIA-ADMIN Only) This table summarizes the catalog entries for the second generation: Created By Tape File Name Tape Name Absolute Generation Physical Copy Logical Copy Parallel BACKUP FRIDAY_BACKUP X00015 2 1 1 Parallel BACKUP FRIDAY_BACKUP X00018 2 1 2 BACKCOPY FRIDAY_BACKUP X00030 2 2 1 BACKCOPY FRIDAY_BACKUP X00033 2 3 1 Parallel BACKCOPY FRIDAY_BACKUP X00040 2 4 1 Parallel BACKCOPY FRIDAY_BACKUP
MEDIACOM Commands DELETE TAPELABEL Command (Super Group Only) 5. To remove all six catalog entries of FRIDAY_BACKUP: MC> DELETE TAPEFILE FRIDAY_BACKUP,& >>> GEN 2,& >>> PHYSICAL ALL,& >>> LOGICAL ALL A tape set contains four files, none of which have expired in the catalog. The files should no longer be used, so remove their catalog entries: MC> DELETE TAPEFILE BACK_ORDER_ITEMS,& >>> FILECAT \STAR.
MEDIACOM Commands DELETE TAPELABEL Command (Super Group Only) catalog entry and perhaps a tape file entry remain for a tape that essentially does not exist. OFF removes the label only if the file on the tape is expired. The default is OFF. PROMPT { ON | OFF } determines when the tape drive begins checking (polling) that a tape is mounted: ON Polling does not begin until you manually start it. This message is sent to the current default output file (usually your home terminal): \node.
MEDIACOM Commands DELETE TAPEVOLUME Command (Super Group Only) OFF leaves the tape mounted and online. Considerations Labeled tape to unlabeled tape DELETE TAPELABEL turns a labeled tape into an unlabeled tape by writing two tape marks at the beginning of the tape.
MEDIACOM Commands DELETE TAPEVOLUME Command (Super Group Only) status in the volume catalog to released or scratch. Then use DELETE TAPEVOLUME to remove the volume and pool entries. DELETE TAPEVOLUME { tape-name } { ( tape-name [ , tape-name ] ... ) } [ , POOL pool-name ] [ , VOLCAT [ \node.]volume-catalog-name ] tape-name is the name of the tape as written in the tape label.
MEDIACOM Commands DROP FILECAT Command (Super Group Only) . . All the tapes named in the error messages are assigned tapes. Their entries must be removed with a DELETE TAPEFILE before the two new pools are created and the tapes are recataloged. DROP FILECAT Command (Super Group Only) DROP FILECAT removes a file catalog from the DSM/TC system. A file catalog cannot be removed until all its file entries are deleted with DELETE TAPEFILE.
MEDIACOM Commands DROP VOLCAT Command (Super Group Only) Then use DROP FILECAT to remove TAPE_LIBRARY from the NonStop SQL/MP database. (If the NonStop SQL/MP database is not being used, it is also dropped.) MC> DROP FILECAT TAPE_LIBRARY DROP VOLCAT Command (Super Group Only) DROP VOLCAT removes a volume catalog from the DSM/TC system. A volume catalog cannot be removed until all its pools are deleted with the DELETE POOL command.
MEDIACOM Commands ENV Command Now the volume catalog is empty, and you can remove it from the NonStop SQL/MP database with DROP VOLCAT. (If the NonStop SQL/MP database is not being used, it is also dropped.
MEDIACOM Commands EXIT Command Unload Reposition ON OFF No tape drive name is displayed by ENV in the preceding display. A drive name is displayed by ENV after a TAPEDRIVE command is used to name a default tape drive: MC> TAPEDRIVE $T004 MC> ENV Tape Drive \SKY.$T004 File Catalog \SKY.FILE_CATALOG_SKY Volume Catalog \SKY.MASTER_TAPE_CATALOG Pool TAPES_FOR_SKY Volume \SKY.$OPRVOL.OPR Unload ON Reposition OFF EXIT Command EXIT ends the MEDIACOM session and returns control to the command interpreter.
MEDIACOM Commands EXPIRE TAPEFILE Command (Super Group Only) file catalog is not on your current default node. If only \node is specified, the process is run for all file catalogs in the system search list of \node. UPDATESTATS ( ON | OFF ) The default value for this parameter is ON. When this parameter is specified with the value OFF, tape file expiration does not execute the UPDATE ALL STATISTICS phase.
MEDIACOM Commands FC Command Because only a subset of file catalogs in the DSM/TC system is affected by the command, the run date does not change. The clean-up process automatically runs again at 8:00 p.m. To run the clean-up process before 8:00 p.m. on all file catalogs in the DSM/TC system: MC> EXPIRE TAPEFILE \SKY Because all file catalogs are affected by the command, the run date does change. The clean-up process does not automatically run at 8:00 p.m. today. The next time it runs is 8:00 p.m.
MEDIACOM Commands FC Command string is a text string. FC finds and displays the most recent command in the history buffer that begins with the specified text string. "string" is a text string enclosed in quotation marks. FC finds and displays the most recent command in the history buffer that contains the specified text string. The command need not begin with the specified string.
MEDIACOM Commands FILECAT Command replacement-string is any subcommand that does not begin R, I, or D (r, i, or d). Characters in replacement-string replace the characters directly above them in the command line on a one-for-one basis. To execute the modified command displayed by FC, press RETURN at the first character position on the command editing line. Considerations To stop FC, enter only the subcommand separator (//) on the new blank line, and then immediately press RETURN.
MEDIACOM Commands FILECAT Command At the beginning of a MEDIACOM session, the default file catalog name is the name set by a ALTER MEDIADEFS command executed in a prior session. If that name is not the name you want, you can define a new one for the current session with the FILECAT command. The name set by FILECAT remains in effect until another FILECAT command is issued or the session ends. Note.
MEDIACOM Commands HELP Command An INFO MEDIADEFS command issued now still shows the file catalog name set by ALTER MEDIADEFS, but it is not used because of the FILECAT command: MC> INFO MEDIADEFS Search List File Catalog Volume Catalog Pool Name Retention Abend Retention Support Level Automated Compression (\SKY, \SEA, \STAR) \SKY.FILE_CATALOG_SKY \SKY.
MEDIACOM Commands HELP Command * | ALL lists all MEDIACOM command names. No syntax is displayed. Examples The first HELP command lists the syntax for DELETE TAPEFILE. The second HELP command displays more help text for a variable in the command syntax. MC> HELP DELETE TAPEFILE -------------------------------------------------------| | | DELETE TAPEFILE | | | | , GEN { 1-32767 | ALL } | | | | [ , FILECAT [ \node.
MEDIACOM Commands HELP Command The second command displayed is a TAPECOM command. To display the equivalent MEDIACOM syntax for that command: MC> HELP
MEDIACOM Commands HISTORY Command MC>ENV Tape Drive NO SESSION DEFAULT SET File Catalog \POLISH.RONCAT Volume Catalog \POLISH.RONCAT Pool RON_APPEND Volume \POLISH.$DATA00.BIGFILES Unload ON Reposition OFF Optional parameters such as COUNT, DENSITY, and LABELS are enclosed in brackets. The TAPEDRIVE parameter is also enclosed in brackets, but it is followed by an @ symbol.
MEDIACOM Commands HISTORY Command The HISTORY command adds line numbers to the commands it displays. HISTORY [ lines ] [ RESET LAST ] [ RESET ALL ] HISTORY entered by itself, displays the ten most recent lines in the history buffer. lines specifies how many of the most recently entered commands to display. RESET LAST clears the most recently entered command in the history buffer and changes the current command line number to the number of the cleared command.
MEDIACOM Commands INFO CONSOLE Command The HISTORY RESET LAST command deletes the INFO VOLCAT command in the buffer. The history buffer now contains these commands: 1>INFO FILECAT * 2>ENV 3>HELP ALTER 4>INFO MEDIADEFS The HISTORY RESET LAST command was not added to the buffer. The INFO MEDIADEFS command becomes the fourth entry in the buffer. INFO CONSOLE Command INFO CONSOLE retrieves the device name of the tape console.
MEDIACOM Commands INFO DISKFILE Command INFO DISKFILE Command INFO DISKFILE retrieves information stored in disk file entries. Disk file entries are created when the CATALOGFILES option of the Backup utility (T9074) or BACKCOPY is used when the utility is run. These entries are mainly used for recovery operations. Disk file entries have a status of valid unless manually marked invalid by ALTER DISKFILE. All valid entries represent files eligible for a recovery operation by RECOVER DISKFILE.
MEDIACOM Commands INFO DISKFILE Command Include \node with the name when the file catalog is not on your current default node. If only \node is given, all file catalogs of the nodes in the system search list of \node are used. This parameter is required if no value is available from the MEDIADEFS defaults or previously set as a MEDIACOM session default (see the ENV Command on page 2-89).
MEDIACOM Commands INFO DISKFILE Command TAPEFILE tape-file-id is the tape file ID of the tape file entry that owns the disk file entry of disk-filename. When not given, all specified generations of any tape file ID that own a disk file entry for disk-file-name are included in the report. TIME date time specifies a starting point for retrieving information from the catalog. Only disk file entries cataloged after the date and time are used. You cannot use the GEN option with TIME.
MEDIACOM Commands INFO DISKFILE Command Considerations Format of brief report Figure 2-1. INFO DISKFILE Brief Format File Catalog Tape File Generation Version Time Archived fcat tfile gen ver time File Name ------------\node.vol.sub Code ---- EOF --- Last Modified ------------- Status ------ dfile code eof mod stat fcat Name of the file catalog in which dfile is cataloged. tfile Tape file name associated with dfile. gen Absolute generation number of tfile.
MEDIACOM Commands INFO DISKFILE Command eof Number of bytes contained in dfile. mod Date and time that dfile was last changed before it was written to the backup tape. stat Status of dfile as stored in the catalog. The value of stat can be: INVALID The disk file cannot be used by RECOVER DISKFILE. VALID The disk file can be used by RECOVER DISKFILE. Format of detail report Figure 2-2.
MEDIACOM Commands INFO DISKFILE Command lcopy Logical copy number of tfile. dfile The fully qualified name of dfile when it was written to the backup tape. stat Status of dfile as stored in the catalog. The value of stat can be: INVALID The disk file cannot be used by RECOVER DISKFILE. VALID The disk file can be used by RECOVER DISKFILE. open Whether dfile was open at the time it was backed up. The value of open can be: FALSE The disk file was not open. TRUE The disk file was open.
MEDIACOM Commands INFO DISKFILE Command type File type. For more information on file types, see the File Utility Program (FUP) Reference Manual. eof Number of bytes contained in dfile. mod Date and time that dfile was last changed before it was written to the backup tape. These items apply to the tape within the backup tape set that contains dfile. If dfile spans more than one tape, these items appear for each tape.
MEDIACOM Commands INFO DISKFILE Command two tapes, and that fact is reflected in the two groups of information shown at the end of the report. MC> INFO DISKFILE \SEA.$SHELL.MKT.REGIONS,& >>> FILECAT \SEA.FILE_CATALOG_SEA,& >>> DETAIL,& >>> GEN 17,& >>> TAPEFILE MKT_BACKUP File Catalog Tape File Generation Version Time Archived Physical Copy Logical Copy Disk File Disk File Status Open Broken RF Needed Corrupt Audited File Code File Type EOF Last Mod Time \SEA.
MEDIACOM Commands INFO FILECAT Command INFO FILECAT Command INFO FILECAT retrieves this information about a file catalog: The logical name The physical name (where the catalog is located on disk) The owner The security level The file catalog version INFO FILECAT [ \node ] [ [ \node.
MEDIACOM Commands INFO MEDIADEFS Command --------------------- ------------------------- ------- -------- ------\SKY.FILE_CATALOG_SKY \SKY.$V101.SQLCAT1 5,122 RWEP 10 1 file catalog returned. To retrieve information about all the file catalogs on the current default node: MC> INFO FILECAT * File Catalog Name --------------------\SKY.FILE_CATALOG_SKY \SKY.FILE_CAT2_SKY \SKY.FILE_CAT3_SKY Database Catalog Location ------------------------\SKY.$V101.SQLCAT1 \SKY.$SSX.SQLDAT \SKY.$TCAT.
MEDIACOM Commands INFO MEDIADEFS Command If the system time is incorrect, correct it with the operating system SET TIME command, then issue ALTER MEDIADEFS with the RESET EXPIRATION option. If the system time does not need correcting, issue ALTER MEDIADEFS with the RESET EXPIRATION option to confirm that the time is correct and to allow the clean-up process to run.
MEDIACOM Commands Compression INFO POOL Command OFF WARNING: Expiration Suspended - Confirm System Time to Enable (When the warning message appears, check the system clock to see if it needs correcting. After you correct the time, or if the time should not be changed, use ALTER MEDIADEFS with the RESET EXPIRATION option to confirm that the system time is correct.
MEDIACOM Commands INFO POOL Command When seeking information for several pools, you can give multiple pool names rather than entering INFO POOL for each pool. A maximum of 30 names is permitted. This parameter is required if no value is available from the MEDIADEFS defaults or previously set as a MEDIACOM session default (see the ENV Command on page 2-89). OUT out-file specifies where the report is displayed or written. You can name a disk file or a device, such as a printer or terminal.
MEDIACOM Commands Volume Catalog INFO TAPEDRIVE Command \CAUNI1,R1CAT Auto Search Pool Name Labels Density Type Scratch Space ----------------- ------ ------- ---- ------- -----R1POOL1 ANY ANY ANY ON INCLUDED R1POOL2 ANY ANY ANY OFF INCLUDED RBS_POOL_APPEND_ON ANY ANY ANY ON INCLUDED Append -----ON OFF ON 3 pools returned INFO TAPEDRIVE Command INFO TAPEDRIVE retrieves the current setting of a tape drive regarding the BLPCHECK and NLCHECK options and displays information about the drive type.
MEDIACOM Commands INFO TAPEFILE Command 1 tape drive returned. To display information for all the tape drives on the current default node: MC> INFO TAPEDRIVE * Tape Drive Name Device Type NL Check BLP Check LSM Drive ID --------------- ----------- -------- -------- ----------$T001 MARATHON OFF OFF NON-LSM DRIVE $T002 DAT ON ON NON-LSM DRIVE $ACS1 DLT7000 OFF OFF (0,0,2,0) $ACS2 DLT7000 OFF OFF (0,0,2,1) $ACS3 DLT4000 OFF OFF (0,0,2,3) 5 tape drives returned.
MEDIACOM Commands INFO TAPEFILE Command tape-file-id is the tape file ID of the catalog entry. Wild-card characters are permitted in tapefile-id except when using the VOLUMESET option. When not given, all entries in the file catalog are used. When seeking information for many tape file entries, you can give multiple tape file IDs rather than entering INFO TAPEFILE for each entry. A maximum of 30 names is permitted. Multiple names are not permitted when using the VOLUMESET option.
MEDIACOM Commands INFO TAPEFILE Command ALL use all entry types. The default is ALL. BACKFILE only use entries for backup tapes created in file mode. BACKVOLUME only use entries for backup tapes created in volume mode. USER only use entries for tape files created by a process other than BACKUP. OUT out-file specifies where the report is displayed or written. You can name a disk file or a device, such as a printer or terminal.
MEDIACOM Commands INFO TAPEFILE Command fcat Name of the file catalog in which tfile is cataloged. tfile Tape file name. These names are listed in alphabetical order when more than one is selected for the report. gen Absolute generation number of tfile. ver Version number of tfile. expire Date in the catalog when tfile expires.
MEDIACOM Commands INFO TAPEFILE Command ver Version number of tfile. pcopy Physical copy number of tfile. lcopy Logical copy number of tfile. time Date and time that tfile was created. expire The date in the catalog when tfile expires. If the value for a tape file expiration is set as PERMANENT (see the ALTER MEDIADEFS command on page 2-39 and the ALTER TAPEFILE command on page 2-57), the value returned for expire is 31dec2199. DSM/TC automatically inserts this value.
MEDIACOM Commands INFO TAPEFILE Command seq Sequence number of tfile within the tape set when the tape set contains more than one file (1 for the first file on the tape set, 2 for the second file, and so on). tname Name of the tape within the tape set that contains tfile. index Sequence number of tname within the tape set (1 for the first tape used, 2 for the second tape used, and so on).
MEDIACOM Commands MIS_BACKUP_A MIS_BACKUP_B INFO TAPELABEL Command (Super Group Only) 2 2 0 0 11Nov1993 30Nov1993 FILE FILE 16May93 11:40 23May93 10:03 2 tape files returned. To display a brief report on the current default node /SKY about two tape files cataloged in a file catalog on another system: MC> INFO TAPEFILE (SUMMARY_90, SUMMARY_91),& >>> FILECAT \SEA.
MEDIACOM Commands INFO TAPELABEL Command (Super Group Only) INFO TAPELABEL entered without the options, displays label information for the tape mounted on the tape drive set by the TAPEDRIVE command. The information is sent to your current default output file (usually your home terminal) in brief format, and the tape is unloaded after the command executes. BRIEF | DETAIL specifies how much information you want retrieved. BRIEF, the default, retrieves less information than DETAIL.
MEDIACOM Commands INFO TAPELABEL Command (Super Group Only) This parameter is required if no value is available from the MEDIADEFS defaults or previously set as a MEDIACOM session default (see the ENV Command on page 2-89). UNLOAD { ON | OFF } determines what happens to the tape after INFO TAPELABEL is finished: ON unloads the tape from the tape drive. The default is ON. OFF leaves the tape mounted and online.
MEDIACOM Commands label INFO TAPELABEL Command (Super Group Only) Type of tape label. The value of label can be: ANSI BACKUP IBM OMITTED TMF ANSI standard label BACKUP label IBM-MVS standard label No label tape TMF label tname Name of the tape. owner Owner of the tape. level Level of tape label. This item is not included in the report for IBM-MVS labeled tapes.
MEDIACOM Commands INFO TAPELABEL Command (Super Group Only) Figure 2-6.
MEDIACOM Commands INFO TAPELABEL Command (Super Group Only) impid1 User-defined information. HP does not support this item, and it is left blank in labels created by a NonStop Kernel process. owner Owner of the tape. level Level of tape label. The value of level can be: A TMF label created with software earlier than the Cseries B BACKUP T TMF 3 ANSI level 3 4 ANSI level 4 These items apply to an unexpired file on the tape.
MEDIACOM Commands INFO TAPELABEL Command (Super Group Only) If a user label is present, INFO TAPELABEL retrieves the information from that label as well and presents it after the listed label items. The user information is not formatted into separate items. Figure 2-7.
MEDIACOM Commands INFO TAPELABEL Command (Super Group Only) These items apply to an unexpired file on the tape. If more than one unexpired file is on the tape, only the first one is used for reporting purposes. tfile Name of the file. setid Name of the first tape that data was written to for the tape set of tfile. sect Number that identifies the order of the tape within a multitape tape set (1 for first tape, 2 for second tape, and so on).
MEDIACOM Commands battr INFO TAPELABEL Command (Super Group Only) Block attribute code. The value of battr can be: B Space Records are blocked. Records are not blocked. ser Serial number, in hexadecimal notation, of a 5180 tape drive. If the tape drive is not a 5180 tape drive, the value for this item is zero. addr Tape drive number for 5180 tape drive. The value of tapedr can be: 0 Space check 5180 tape drive Not a 5180 tape drive Checkpoint status of tfile.
MEDIACOM Commands Accessibility Block Count Implementation ID Reserved Field Label ID Record Format Block Length Record Length Reserved Field Offset Length Reserved Field INFO TAPEVOLUME Command 000000 HDR2 F 800 80 00 1 tape label returned.
MEDIACOM Commands INFO TAPEVOLUME Command INFO TAPEVOLUME [ tape-name ] [ ( tape-name [ , tape-name ] ... ) ] [ [ [ [ , , , , BRIEF | DETAIL ] OUT out-file ] POOL pool-name ] STATUS { ALL | ASSIGNED | BAD | FULL | INUSE | RELEASED | SCRATCH | SELECTED } ] [ , TAPEFORMAT { ALL | BACKUP | ARCHIVE | LONGNAME | NONBACKUP } ] [ , VOLCAT { \node } ] [ { [ \node.
MEDIACOM Commands INFO TAPEVOLUME Command STATUS { ALL | ASSIGNED | BAD | FULL | INUSE | RELEASED | SELECTED | SCRATCH } displays information for tapes of a given status: ALL Tapes of any status. The default is ALL. ASSIGNED Tapes that contain unexpired files. BAD Tapes that have a defect of some type. FULL Tapes that are currently full. INUSE Tapes that are currently mounted on tape drives. RELEASED Tapes that contain only expired files, but which are not eligible to be used as scratch tapes.
MEDIACOM Commands INFO TAPEVOLUME Command are altered. For more information on TAPEFORMAT, see the Backup and Restore 2.0 Manual. LONGNAME Tape volumes of label type BACKUP that were written with Backup and Restore 2.0 BACKUP and that can be read with Backup and Restore 2.0 RESTORE are altered. For more information on TAPEFORMAT, see the Backup and Restore 2.0 Manual. NONBACKUP Tape volumes of label types other than BACKUP are altered. VOLCAT { \node } { \node.
MEDIACOM Commands INFO TAPEVOLUME Command vcat Name of the volume catalog that owns pool. pool Name of the pool in which tname is cataloged. tname Name of the tape. These names are listed in alphabetical order when more than one tape is selected for the report. label Type of tape label. The value of label can be: ANSI BACKUP IBM TMF type Specifies the type of tape.
MEDIACOM Commands INFO TAPEVOLUME Command Format of detail report The detail report format is a vertical list of items, as Figure 2-9 shows. All the report information is taken from the volume catalog, not the tape label. Figure 2-9.
MEDIACOM Commands INFO TAPEVOLUME Command den Density of the tape. The value of den can be 1600 or 6250. tfmt Type of tape format of for tape volumes of label type BACKUP. The value of tfmt can be: ARCHIVE Tape volume has the label type BACKUP and contains data written by BACKUP (T9074) or BACKCOPY utility. LONGNAME Tape volume has the label type BACKUP and contains data written by Backup and Restore 2.0 BACKUP. NONBACKUP Tape volume does not have the label type BACKUP.
MEDIACOM Commands INFO TAPEVOLUME Command Examples To retrieve a brief format report on all the tapes in a pool with a status of bad: MC> INFO TAPEVOLUME *,& >>> STATUS BAD,& >>> POOL ACCOUNTING_TAPES Volume Catalog Pool Name Tape Name --------T00122 T12234 T22345 T55678 \SKY.MASTER_TAPE_CATALOG ACCOUNTING_TAPES Labels -----BACKUP BACKUP BACKUP BACKUP Type ---OPEN OPEN OPEN OPEN TapeFormat ------LONGNAME LONGNAME LONGNAME LONGNAME Status -----BAD BAD BAD BAD 4 tape volumes returned.
MEDIACOM Commands INFO TAPEVOLUME Command To generate a brief format report on all scratch tapes in the pools whose names begin with OP, and write the information to a disk file: MC> INFO TAPEVOLUME *,& >>> POOL OP*,& >>> STATUS SCRATCH,& >>> OUT MYRPT DSM/Tape Catalog Operator Interface (MEDIACOM) Manual—429828-010 2-140
MEDIACOM Commands INFO VOLCAT Command INFO VOLCAT Command INFO VOLCAT retrieves this information about a volume catalog: The logical name The physical name (where the catalog is located on disk) The owner The security level The volume catalog version INFO VOLCAT [ \node ] [ [ \node.
MEDIACOM Commands LABEL TAPEVOLUME Command (Super Group Only) Examples 1. To retrieve information for the default volume catalog of the session: MC> INFO VOLCAT Volume Catalog Name Catalog Location Owner RWEP Version ------------------------ ---------------- ------- ---- ------\SKY.MASTER_TAPE_CATALOG \SKY.$OPVOL.SQL3 3,112 NG-G 2 2. To retrieve information for a volume catalog on another node: MC> INFO VOLCAT \MOON.TAPE_CATALOG 3.
MEDIACOM Commands LABEL TAPEVOLUME Command (Super Group Only) The tape is cataloged only if it satisfies all the pool’s attributes, and the tape name is not duplicated in the system search space. LABEL TAPEVOLUME { tape-name } { ( tape-name [ , tape-name ] ... ) } , , [ [ [ [ [ [ [ [ POOL pool-name VOLCAT [ \node.
MEDIACOM Commands LABEL TAPEVOLUME Command (Super Group Only) Before LABEL TAPEVOLUME begins labeling any of the tapes, it checks that the tape naming convention works for the number of tapes specified. If the convention does not work, LABEL TAPEVOLUME does not execute. For example, if tapename is PAY01 and number-of-tapes is 100, the command does not execute because there is no room in a generated tape name for a number larger than 99 (PAY99). In this case, number-of-tapes must be a value of 99 or less.
MEDIACOM Commands LABEL TAPEVOLUME Command (Super Group Only) CART5120 Only model 5120 tape cartridges are permitted. DAT Only DAT tapes are permitted. DDS Only DDS tapes are permitted. DDS2 Only DDS2 tapes are permitted. DDS3 Only DDS3 tapes are permitted. DLTIII Only DLTIII tapes are permitted. DLTIV Only DLTIV tapes are permitted. LTO1 Only LTO1 tapes are permitted. LTO2 Only LTO2 tapes are permitted. LTO3 Only LTO3 tapes are permitted. LTO4 Only LTO4 tapes are permitted.
MEDIACOM Commands LABEL TAPEVOLUME Command (Super Group Only) SDLT Only SDLT tapes are permitted. Note. To choose a correct media type for your tapedrive, see Table 2-10 on page 2-181. If the TYPE option is not specified, the default media type will be assigned (See Table 2-11 on page 2-181).
MEDIACOM Commands LABEL TAPEVOLUME Command (Super Group Only) OFF Polling is done immediately by the tape drive. This message is sent to the current default output file (usually your home terminal): \node.$tape: not ready -- beginning to poll ... When the tape is mounted, LABEL TAPEVOLUME continues processing. TAPEDRIVE \node.$tape is a tape drive name. Include \node when the tape drive is not on your current default node. The default is the name set by the TAPEDRIVE command.
MEDIACOM Commands LABEL TAPEVOLUME Command (Super Group Only) Although you can accept or reject the tape mount, if you initiate and complete the LABEL TAPEVOLUME command, this mount request is cleared. (It will not appear in the display from a STATUS TAPEMOUNT.) Tape density The density of all tapes in a pool must agree with the pool’s density if the pool has been assigned a density other than any.
MEDIACOM Commands OBEY Command OBEY Command OBEY executes one or more MEDIACOM commands in a file. MEDIACOM displays each command as it is performed. A command file can have as many MEDIACOM commands as you need. After executing the commands in the file, MEDIACOM prompts for the next command. A command file is typically created through an editor such as TEDIT. Each text line in the file is treated as a separate MEDIACOM command line.
MEDIACOM Commands OPEN SERVER Command When FC is entered after executing a command file, FC displays the OBEY command, not the last command executed in the command file. Example A disk file named \SKY.$SYS.OPER.DEFS contains these commands: INFO MEDIADEFS \SKY INFO MEDIADEFS \SEA INFO MEDIADEFS \STAR To execute the commands in DEFS during a MEDIACOM session on \SKY, enter: MC> OBEY $SYS.DEFS The volume name $SYS is included because it is not the default volume name for the session.
MEDIACOM Commands PAUSE Command PRI priority is the execution priority for the server in the range 1 through 199. The default is the priority that MEDIACOM has at the time OPEN SERVER is executed. SWAP $volume is the name of a volume to use as temporary work space for the server. The default is the volume where MEDIACOM is running. TERM \node.$device is the device name of the home terminal for the server process. Include \node when the device is not on your current default node.
MEDIACOM Commands POOL Command POOL Command Some MEDIACOM commands need a pool name even though the commands’ POOL option is not required. When a POOL option is not used, those commands use a default name. At the beginning of a MEDIACOM session, the default pool name is the name set by the ALTER MEDIADEFS command executed in a prior session. If that name is not the name you want, you can define a new one for the current session with the POOL command.
MEDIACOM Commands RECOVER DISKFILE Command CARTRIDGE_TAPES remains the default pool name until you enter another POOL command or exit the session. An INFO MEDIADEFS command issued now still shows the name set by ALTER MEDIADEFS, but it is not used because of the POOL command: MC> INFO MEDIADEFS Search List File Catalog Volume Catalog Pool Name Retention Abend Retention Support Level Automated Compression (\SKY, \SEA, \STAR) \SKY.FILE_CATALOG_SKY \SKY.
MEDIACOM Commands RECOVER DISKFILE Command You do not give approval for the command to execute a RESTORE run command. RECOVER DISKFILE { { { { { oss-mx-object-name IN oss-mx-restore-in-file disk-file-name ( disk-file-name [ , disk-file-name ] ... ) } } } } } , TAPEFILE tape-file-id [ , FILECAT { \node } ] [ { [ \node.
MEDIACOM Commands RECOVER DISKFILE Command This file must contain a complete, syntactically valid BRCOM RESTORE command terminated with a semicolon. Thetape-device-name in the file will be overridden by the define name passed by MEDIASRV. If you use the IN oss-mx-restorein-file form of the command, you cannot specify any oss-mx-restoreoptions. For Backup and Restore 2.0 syntax usage guidelines, refer to the Backup and Restore 2.0 Manual.
MEDIACOM Commands RECOVER DISKFILE Command When only \node is given, all file catalogs on the nodes of the system search list are searched. When only an asterisk is given, all file catalogs on the current default node are searched. This parameter is required if no value is available from the MEDIADEFS defaults or previously set as a MEDIACOM session default (see the ENV Command on page 2-89).
MEDIACOM Commands RECOVER DISKFILE Command If the specified outcommand-file exists, then the new text will be appended to the end of the file. The resulting file will not be suitable for use as an OBEY file because it would attempt to add the same DEFINE twice. OVERRIDE { ON | OFF } determines whether approval is necessary for the RECOVER DISKFILE command to continue after it has located the catalog information for disk-file-name. ON No approval is necessary.
MEDIACOM Commands RECOVER DISKFILE Command SYSTEM \node is the name of the node where the backup tape will be mounted for the recovery operation. The operator for \node selects the drive to use when mounting the tape. You cannot use the TAPEDRIVE option with SYSTEM. However, if neither option is given, a tape drive on the current default node is used. TAPEDRIVE \node.$tape is a tape drive name. Include \node when the tape drive is not on your current default note.
MEDIACOM Commands RECOVER DISKFILE Command mm is the minute of the hour, entered as a 2-digit number in the range of 0 through 59. The default is 00. ss is the second of the minute, entered as a 2-digit number in the range of 0 through 59. The default is 00. LOCALTOREMOTE Specifying LOCALTOREMOTE causes the RESTORE to be invoked using local file names rather than fully qualified file names. With this parameter, the RESTORE is invoked in one of three ways: LOCALTOREMOTE is not specified.
MEDIACOM Commands RECOVER DISKFILE Command If you enter N, RECOVER DISKFILE ends with no further processing. Wild-card characters in a disk file name or tape file ID If you think RECOVER DISKFILE might find the wrong tape file entry because of wild-card characters in disk-file-name or tape-file-id, use the wild-carded names first with INFO DISKFILE to determine what is selected.
MEDIACOM Commands RECOVER DISKFILE Command catalogs and determines that the entry in OPS_CATALOG is the most current one because it does not recognize there is a more recent entry in GEN_ACCT_CAT. Using a volume-mode backup tape set with RECOVER DISKFILE Recovering information from a volume-mode backup tape set is more complicated than copying specific files from a file-mode backup tape.
MEDIACOM Commands Tape File Mode Catalog Files Tape Name RECOVER DISKFILE Command FILEMODE BACKUP YES T10447 Total count of valid matching disk files: 0025 Total count of invalid matching disk files: 1 ** WARNING **: Matching invalid disk files may be restored. Do you want to see the matching disk files? (y/n) y File Name --------------\SKY.$A.B.A \SKY.$A.B.A2 \SKY.$A.B.C . . . \SKY.$A.Z.
MEDIACOM Commands RECOVER DISKFILE Command A volume-mode RESTORE will be done. ALL files will be copied to the same disk as in the backup tape if the TARGET option is not specified. Please make sure all volume-mode preparations are completed before continuing. This tape file was not backed up with the CATALOGFILES option. No disk file information is available. Do you want RESTORE to be started? (y/n) y Starting RESTORE.
MEDIACOM Commands REJECT TAPEMOUNT Command (Super Group Only) REJECT TAPEMOUNT Command (Super Group Only) REJECT TAPEMOUNT cancels a request to use a tape drive or a tape. After REJECT TAPEMOUNT is finished, file-system error 194 is returned to the application that made the request. REJECT TAPEMOUNT [ \node.]message-number \node.message-number is a number assigned by $ZSVR to the message that requests a tape or the use of a tape drive. This number can be found with a STATUS TAPEMOUNT command.
MEDIACOM Commands STATUS SERVER Command STATUS SERVER Command STATUS SERVER displays this information about the MEDIASRV server process for your session: The local date and time on the node where the server is running The node name where the server is running The number of the node where the server is running The process name and ID of the server The creator ID of the person who created the server The process ID of the person who started the MEDIACOM session The execution priority
MEDIACOM Commands STATUS TAPEDRIVE Command STATUS TAPEDRIVE Command STATUS TAPEDRIVE displays the current status of a tape drive. Among other things, this command tells you if a tape is mounted on the drive, the name of the DEFINE associated with the tape, and which volume catalog and pool own it. Note. Manual unloading of a tape is not detected by a tape drive, so information from STATUS TAPEDRIVE can be out of date.
MEDIACOM Commands STATUS TAPEDRIVE Command $tape Name of the tape drive. dstat Tape drive status. The value of dstat can be: DOWN FREE INUSE to. UNAVL Drive is down. Drive is free to be used. Tape is mounted and being read from or written Both processors owning the tape drive are down. tname Name of the tape if a standard labeled tape is mounted; not present if the tape is not a standard labeled tape or if no tape is mounted. tstat Status of tape in the catalog.
MEDIACOM Commands STATUS TAPEDRIVE Command Figure 2-11. STATUS TAPEDRIVE Detail Format Tape Drive Drive Status Label Type Tape Name Tape Status Pool Name Volume Catalog Process Name Process (CPU,PIN) Tape Use Open Exclusion Comment Open Mode Define Class Define Name Program Name $tape dstat label tname tstat pool vcat $proc c,p i/o openex comment open class def prog $tape Name of the tape drive. dstat Tape drive status. The value of dstat can be: DOWN Drive is down.
MEDIACOM Commands tstat STATUS TAPEDRIVE Command Status of tape in the catalog. The value of tstat can be: ASSIGNED Tape contains an unexpired file. BAD Tape is defective and should not be used. INUSE Data is being read from or written to the tape. RELEASED All files on the tape have expired, but the tape cannot be used as a scratch tape. SELECTED Tape has been chosen by DSM/TC to satisfy a tape mount request.
MEDIACOM Commands class STATUS TAPEDRIVE Command Class of the DEFINE that contains the attributes and values associated with this tape file. The value of class can be: NONE No DEFINE used for tape file TAPE TAPE DEFINE used for tape file TAPECATALOG TAPECATALOG DEFINE used for tape file def Name of the DEFINE that contains the attributes and values associated with this tape file. This item does not appear if the value of class is none.
MEDIACOM Commands STATUS TAPEMOUNT Command STATUS TAPEMOUNT Command STATUS TAPEMOUNT lists the outstanding tape mount requests on a node. STATUS TAPEMOUNT [ [ \node.]message-number ] [ \node ] [ , BRIEF | DETAIL ] STATUS TAPEMOUNT entered without a message number and BRIEF or DETAIL, displays a brief report of all outstanding mount requests on the current default node. \node.message-number \node is a number assigned by $ZSVR to the mount message of the requested tape.
MEDIACOM Commands STATUS TAPEMOUNT Command number Message number assigned by $ZSVR. tname Name of the tape being requested in the message. Also, while $ZSVR is waiting for a reply from a tape library server, this can be returned in the tname field: *ZSSI RETRY BUST type indicates a normal wait state. indicates that a retryable error was returned. indicates that all ACS tape drives are busy. Type of tape label or label processing mode.
MEDIACOM Commands STATUS TAPEMOUNT Command The detail report format is a vertical list of items, as Figure 2-13 shows. Not every item is given when a detail report is requested. The number of items varies depending on the tape processing mode requested (LP, BLP, or NL processing). Figure 2-13.
MEDIACOM Commands prot STATUS TAPEMOUNT Command Specifies whether to protect tname from being written on. The value of prot can be: NO Permit data to be written to the tape. Insert write-enabled ring for open-reel tapes. For tape cartridges, position switch to read/write setting. YES Do not permit data to be written on the tape. Do not insert write-enabled ring for open-reel tapes. For tape cartridges, position switch to read-only setting. label Type of tape label or label processing mode.
MEDIACOM Commands STATUS TAPEMOUNT Command Class of the DEFINE that contains the attributes and values associated with this tape file. The value of class can be: class NONE No DEFINE used for tape file TAPE TAPE DEFINE used for tape file TAPECATALOG TAPECATALOG DEFINE used for tape file def Name of the DEFINE that contains the attributes and values associated with this tape file. This item does not appear if the value of class is none.
MEDIACOM Commands TAPEDRIVE Command Define Class Define Name Program Name TAPECATALOG \SKY.=INBACK \SKY.$SYSTEM.SYS03.RESTORE TAPEDRIVE Command Some MEDIACOM commands need a tape drive name even though the commands’ TAPEDRIVE option is not required. When a TAPEDRIVE option is not used, those commands use a default name. A default tape drive name is set by the TAPEDRIVE command. The name remains in effect until another TAPEDRIVE command is issued or the session ends.
MEDIACOM Commands UNLOAD Command UNLOAD Command MEDIACOM commands that use tape drives have an UNLOAD option to specify whether a tape is left online after the command finishes. When the UNLOAD option is not used, those commands use the default value set by the UNLOAD command. The default value remains in effect until another UNLOAD command is issued or the session ends. Use ENV to display the current value set by UNLOAD. UNLOAD { ON | OFF } ON unloads the tape from the tape drive. The default is ON.
MEDIACOM Commands VOLCAT Command VOLCAT Command Some MEDIACOM commands need a volume catalog name even though the commands’ VOLCAT option is not required. When a VOLCAT option is not used, those commands use a default name. At the beginning of a MEDIACOM session, the default volume catalog name is the name set by the ALTER MEDIADEFS command executed in a prior session. If that name is not the one you want, you can define a new one for the current session with the VOLCAT command.
MEDIACOM Commands VOLUME Command \STAR TAPE_CATALOG_2 remains the default volume catalog until you enter another VOLCAT command or exit the session. An INFO MEDIADEFS command issued now still shows the volume catalog name set by ALTER MEDIADEFS, but it is not used because of the VOLCAT command: MC> INFO MEDIADEFS Search List File Catalog Volume Catalog Pool Name Retention Abend Retention Support Level Automated Compression (\SKY, \SEA, \STAR) \SKY.FILE_CATALOG_SKY \SKY.
MEDIACOM Commands ? Command Volume Unload \SKY.$OPRVOL.OPR ON You want a different volume and subvolume name as the session default names, so you use the VOLUME command to set new names on \SKY, the current default node: MC> VOLUME $MKT.SALES MC> ENV Tape Drive File Catalog Volume Catalog Pool Volume Unload NO SESSION DEFAULT SET \SKY.FILE_CATALOG_SKY \SKY.MASTER_TAPE_CATALOG TAPES_FOR_SKY \SKY.$MKT.
MEDIACOM Commands ! Command "string" is a text string enclosed in quotation marks. The ? command finds and displays the most recent command in the history buffer that contains the specified text string. The command need not begin with the specified string.
MEDIACOM Commands ! Command -linenum is a negative integer that specifies the number of the command line to be retrieved and executed relative to the current line number. string is a text string. The ! command displays and executes the most recent command in the history buffer that begins with the specified text string. "string" is a text string enclosed in quotation marks. The ! command displays and executes the most recent command in the history buffer that contains the specified text string.
MEDIACOM Commands ! Command Table 2-10.
MEDIACOM Commands ! Command Table 2-12 lists the behavior of the Backup and Restore operations CART3480 Media Type tapevolume for the newly supported or differentiated tape drive. Table 2-12.
A Tape Label Formats A labeled tape contains records at the beginning of the tape that identify the tape and the files on the tape. DSM/TC can handle ANSI and IBM-MVS standard labeled tapes.
Tape Label Formats Beginning-of-File-Section Labels Beginning-of-File-Section Labels The word Spaces in the Content column indicates fields that HP does not support. Table A-2.
Tape Label Formats IBM-MVS Standard Labels Table A-3.
Tape Label Formats IBM-MVS Beginning-of-File-Section Labels IBM-MVS Beginning-of-File-Section Labels The word Spaces in the Content column indicates fields that HP does not support. Table A-5.
Tape Label Formats IBM-MVS Beginning-of-File-Section Labels Table A-6.
Tape Label Formats IBM-MVS Beginning-of-File-Section Labels DSM/Tape Catalog Operator Interface (MEDIACOM) Manual—429828-010 A-6
B Labeling and Density Guidelines NonStop Kernel tape drives support various read/write densities and tape labels. Table B-1. Labeling and Density Guidelines by Tape Unit Product Number Tape Type Tape Speed (ips) Densities (bpi) Hardware Density Selection Labeling Guidelines 512x Cartridge (5120) n/a n/a Use TAPEMODE STARTSTOP or STREAM parameter If TAPEMODE is specified, tape is labeled at the value specified. Drive defaults to STARTSTOP if no SYSGEN value is specified.
Labeling and Density Guidelines DSM/Tape Catalog Operator Interface (MEDIACOM) Manual—429828-010 B-2
C Syntax Summary MEDIACOM Syntax MEDIACOM [ / run-option [ , run-option ... ] / ] [ command [ ; command ... ] ] These are the MEDIACOM commands, in alphabetical order: ACCEPT TAPEMOUNT [ \node.]message-number ADD POOL pool-name , VOLCAT [ \node.
Syntax Summary MEDIACOM Syntax ADD TAPEVOLUME { tape-name } { ( tape-name [ , tape-name ] ... ) } , , [ [ [ [ [ [ POOL pool-name VOLCAT [ \node.]volume-catalog-name , COUNT number-of-tapes ] , DENSITY { 1600 | 6250 } ] , LABELS { ANSI | BACKUP | IBM } ] , OVERRIDE { ON | OFF } ] , STATUS { RELEASED | SCRATCH } ] , TYPE { CART3480 | CART3490 | CART5120 | CART9840 | DAT | DDS | DDS2 | DDS3 | DLTIII | DLTIV | LTO1 | LTO2 | LTO3| LTO4 | LTO5 | OPEN | SDLT } ] ALTER CONSOLE [ \node ] [ , DEVICE [ \node.
Syntax Summary MEDIACOM Syntax ALTER POOL pool-name, VOLCAT [ \node.]volume-catalog-name [ [ [ [ [ [ [ [ [ , , , , , , , , , APPEND { ON | OFF } ] RESET APPEND ] AUTOSCRATCH { ON | OFF } ] RESET AUTOSCRATCH ] DENSITY { 1600 | 6250 | ANY } ] RESET DENSITY ] LABELS { ANSI | ANY | BACKUP | IBM } ] RESET LABELS ] TYPE { CART3480 | CART3490 | CART5120 | DAT | CART9840 | DDS | DDS2 | DDS3 | DLTIII | DLTIV | LTO1 | LTO2 | LTO3| LTO4 | LTO5 | OPEN | SDLT } ] [ , RESET TYPE ] ALTER TAPEDRIVE [ [ \node.
Syntax Summary MEDIACOM Syntax [ , OWNER owner-id ] [ , SECURE "code" ] CREATE FILECAT [ \node.]file-catalog-name , SUBVOL [ \node.][$volume.]subvolume [ , OWNER owner-id ] [ , SECURE "code" ] CREATE VOLCAT [ \node.]volume-catalog-name , SUBVOL [ \node.][$volume.]subvolume [ , OWNER owner-id ] [ , SECURE "code" ] DELETE POOL pool-name , VOLCAT [ \node.]volume-catalog-name DELETE TAPEFILE tape-file-id , GEN { absolute | ALL } [ [ [ [ , , , , FILECAT [ \node.
Syntax Summary MEDIACOM Syntax [ string ] [ "string" ] FILECAT [ \node.]file-catalog-name HELP [ command-name ] [ ] [ * | ALL ] HISTORY [ lines ] [ RESET LAST ] [ RESET ALL ] INFO CONSOLE [ \node ] [ , OUT out-file ] INFO DISKFILE [ disk-file-name ] [ [ [ [ [ [ [ [ , BRIEF | DETAIL ] , FILECAT { \node } ] { [ \node.
Syntax Summary MEDIACOM Syntax [ , TAPEDRIVE [ \node.]$tape ] [ , UNLOAD { ON | OFF } ] [ , REPOSITION { ON | OFF } ] INFO TAPEVOLUME [ tape-name ] [ ( tape-name [ , tape-name ] ... ) ] [ [ [ [ , , , , BRIEF | DETAIL ] OUT out-file ] POOL pool-name ] STATUS { ALL | ASSIGNED | BAD | FULL | INUSE | RELEASED | SCRATCH | SELECTED } ] [ , VOLCAT { \node } ] [ { [ \node.]volume-catalog-name } ] INFO VOLCAT [ \node ] [ [ \node.
Syntax Summary MEDIACOM Syntax RECOVER DISKFILE { oss-mx-object-name { IN oss-mx-restore-in-file { disk-file-name { ( disk-file-name [ , disk-file-name ] ... ) , TAPEFILE tape-file-id [ , FILECAT { \node } ] [ { [ \node.]file-catalog-name } ] [ , GEN { absolute | relative } ] [ , OUT out-file ] [ , OUTCOMMAND outcommand-file ] [ , OVERRIDE { ON | OFF } ] [ , oss-mx-restore-option ] [ , { IN restore-in-file | restore-option ... [ , SYSTEM \node ] [ , TAPEDRIVE [ \node.
Syntax Summary MEDIACOM Syntax DSM/Tape Catalog Operator Interface (MEDIACOM) Manual—429828-010 C-8
Index A ANSI label format A-1 B Backup tape cataloging 2-20 deleting entry 2-80 label format 2-13 recovering files from 2-151 using alternate copy 2-62 Batch mode 1-1 Bypass label processing ACCEPT TAPEMOUNT 2-8 displaying BLPCHECK setting 2-114 giving approval 2-55 setting BLPCHECK option 2-53 C Canceling tape/drive messages 2-161 Changing pool attributes 2-49 Characters, comment 2-7 Clean-up process changing run date 2-90 clock error condition 2-47 running with EXPIRE TAPEFILE 2-89 Clock, error conditio
Index D Commands (continued) INFO TAPELABEL 2-121 INFO TAPEVOLUME 2-130 INFO VOLCAT 2-139 LABEL TAPEVOLUME 2-140 OBEY 2-146 OPEN SERVER 2-148 PAUSE 2-149 POOL 2-149 RECOVER DISKFILE 2-151 REJECT TAPEMOUNT 2-161 REPOSITION 2-162 STATUS SERVER 2-162 STATUS TAPEDRIVE 2-163 STATUS TAPEMOUNT 2-168 summary 2-1 TAPECOM equivalent commands 2-5 TAPEDRIVE 2-173 UNLOAD 2-174 VOLCAT 2-175 VOLUME 2-176 ! 2-179 ? 2-177 Comment characters 2-7 Common elements device name 1-4 disk file name 1-4 disk subvolume name 1-5 dis
Index F Execute-and-quit mode 1-1 Expansion of disk file IDs 2-176 Expiration date, changing 2-19, 2-56 F File catalog changing name 2-74 changing owner 2-37 changing security level 2-37 creating 2-73 displaying attributes 2-109 removing from system 2-86 setting session default name 2-93 File catalog name 1-6 H HELP Help text for commands 2-95 @ symbol 2-97/2-98 History buffer for command lines 2-98, 2-177, 2-179 M MEDIACOM definition 1-1 language elements 1-4 RUN command 1-1 run options 1-1 running mo
Index R Pool (continued) removing from catalog 2-77 Pool name 1-7 PRI run option 1-3 R RESTORE utility 2-151, 2-161 Retention period, changing 2-56 Running MEDIACOM 1-1 S Series copies of tape sets 2-62, 2-63 Session dedicated server process 2-148 default file catalog name 2-93 default node name 2-176 default pool name 2-149 default subvolume name 2-176 default tape drive name 2-173 default value for unloading tapes 2-174 default volume catalog name 2-175 default volume name 2-176 displaying defaults 2-
Index U Tape drive (continued) model numbers B-1 name 1-7 no label processing (NLCHECK) 2-53, 2-56 setting session default 2-173 Tape file cataloging 2-15 expiration date 2-19 length of name 2-19 Tape file entry automatic deletion 2-89, 2-90 changing expiration date 2-56 changing retention period 2-56 changing status 2-56 clean-up process 2-89, 2-90 creating 2-15 deleting 2-78 deleting for backup tapes 2-80 displaying catalog information 2-115 expired 2-89 Tape file name 1-7 Tape libraries assigning names
Index Special Characters DSM/Tape Catalog Operator Interface (MEDIACOM) Manual—429828-010 Index-6
