Archive/Backup System
for OpenVMS
Software Version |
|
Required Operating System |
|
Required Software |
Media and Device Management |
|
|
Optional Software |
Possession, use, or copying of the software described in this documentation is authorized only pursuant to a valid written license from COMPAQ, an authorized sublicenser, or the identified licenser.
While COMPAQ believes the information included in this publication is correct as of the date of publication, it is subject to change without notice.
Compaq Computer Corporation makes no representations that the interconnection of its products in the manner described in this document will not infringe existing or future patent rights, nor do the descriptions contained in this document imply the granting of licenses to make, use, or sell equipment or software in accordance with the description.
Copyright 2000 Compaq Computer Corporation. All rights reserved.
Printed in the United States of America.
TM DEC, DIGITAL, MSCP, OpenVMS, StorageWorks, TK, VAX VMSCluster and the DIGITAL Logos are registered in the United States Patent and Trademark Office.
DECconnect, HSZ, StorageWorks, VMS, and OpenVMS are trademarks of Compaq Computer Corporation.
AIX is registered trademark of International Business Machines Corporation.
FTP Software is a trademark of FTP SOFTWARE, INC.
HP is a registered trademark of Hewlett-Packard Company.
NT is a trademark of Microsoft Corporation.
Oracle, Oracle Rdb, and Oracle RMU are all registered trademarks of Oracle Corporation.
PostScript is a registered trademark of Adobe Systems, Inc.
RDF is a trademark of Touch Technologies, Inc.
SGI is a registered trademark of Chemical Bank.
Solaris is a registered trademark of Sun Microsystems, Inc.
StorageTek is a registered trademark of Storage Technology Corporation.
SunOS is a trademark of Sun Microsystems, Inc. Version 2.1.
UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company Ltd.
Windows and Windows NT are both trademarks of Microsoft Corporation.
All other trademarks and registered trademarks are the property of their respective holders.
MDMS - Start An MDMS Session 2-134
A MDMS V3.0A Rights and Privileges
A.2 Default High-Level to Low-Level Mapping A-5
A.2.2 MDMS_OPERATOR Rights: A-6
A.2.2.1 Domain Commands for Mapping Privileges A-6
This document is intended for storage administrators who are experienced OpenVMS system managers. This document should be used in conjunction with the Introduction to OpenVMS System Management manual.
The following conventions are used in this document:
The following related products may be mentioned in this document:
The following documents are part of Archive/Backup System for OpenVMS documentation set:
The commands in this document are organized alphabetically. ABS DCL command information includes the command format, the command description, the command parameter descriptions, any command restrictions, the command qualifier descriptions, and examples of how to use the command.
A command may contain both positional and nonpositional qualifiers. When applicable, these two types of qualifiers are described in separate sections titled Positional Qualifiers and Nonpositional Qualifiers.
To invoke ABS shell, enter the following command:
You are entered into ABS environment and ABS displays ABS shell prompt:
If you choose to work within ABS shell, you do not need to enter ABS prefix for each command.
This command creates an environment policy in ABS policy database.
/ACCESS_CONTROL=(user_id=user-name,access="option[,...]")
Enables you to set up the access controls by user name or by access right identifier.
Specifies the action to take when saving data using this environment policy. Select one of the following supported options:
Default:
If you do not specify this qualifier, ABS uses RECORD.
ABS supports different types of compression for UNIX clients:
Restriction:
This qualifier is valid only for UNIX client operations.
Specifies the list of data safety options to use when saving or restoring data using this environment policy. ABS supports the following data safety options:
Restriction:
These options are valid only for OpenVMS backup operations.
Default:
If you do not specify this qualifier, ABS uses all data safety options that are supported by the backup agent.
Use this qualifier to set the number of drives to use for each save or restore request using this environment policy. If there are same number of drives available set by this qualifier, ABS allocates those drives for save or restore request. If the number of drives set by this qualifier is not available, ABS will use the amount of drives available.
For example, if you create a save request that uses an environment policy where the /DRIVE_COUNT is set to 3, ABS allocates three drives when the save request job begins. This means those three drives are unavailable for other operations during the time save request is executing.
Default:
The default value is 1. This value cannot be 0 (zero).
Recommendation:
Use the default value of 1. Allocating more than one drive per save request will constrain the resources and therefore, those resources (drives or volumes) will not be available for additional operations.
Specifies to execute a command string after the entire save or restore request completes.
Restriction:
The string for this qualifier is limited to 80 characters and must be enclosed in quotes.
Default:
If you do not specify this qualifier, no epilogue command is executed.
Specifies the number of minutes between retry attempts.
Default:
If you do not specify this qualifier, ABS retries the save or restore request every 15 minutes.
Provides the ability from ABS to either back up the UNIX symbolic links only, or to follow the UNIX symbolic links and back up the data as well.
Restriction:
This qualifier is valid only for UNIX client operations.
Specifies the listing file option to use when saving or restoring data using this environment policy. Choose one of the following options:
Restriction:
This qualifier is valid only for OpenVMS backup operations.
Default:
If you do not specify this qualifier, ABS uses NONE.
Specifies the action to be taken when data usage conflicts occur. Select one of the following supported options:
Default:
If you do not specify this qualifier, the save operation fails if other applications are accessing the same data.
/NOTIFICATION=(option[,...])
/NONOTIFICATION
Specifies the notification options to use when using this environment policy. ABS supports the following options:
Restriction:
If you select METHOD=OPCOM, you cannot select TYPE=FULL or TYPE=NORMAL.
Defaults:
ABS uses the following default values: RECEIVER=TAPES, METHOD=OPCOM, TYPE=BRIEF, WHEN=FATAL.
Specifies the owner of environment policy object. The owner is typically the user who installed ABS software, and this user is the only user allowed to make modifications to the environment policy object.
Specify this qualifier to create a user profile other than the default user profile. Valid options are:
Instructs ABS to execute a command string prior to the entire save or restore request.
Restriction:
The string for this qualifier is limited to 80 characters and must be enclosed within quotes.
Default:
If you do not specify this qualifier, no prologue command is executed.
Specifies the number of retries to attempt for the save or restore request using this environment policy.
Default:
If you do not specify this qualifier, ABS retries the save or restore request three (3) times.
Allows ABS to back up only the root file system (such as the disk the root directory resides on), or an entire file system type if the file system spans physical devices. ABS supports the following options:
Restriction:
This qualifier is valid only for UNIX client backup operations. It is not valid for NT or OpenVMS client backup operations.
Default:
The default is NONE, or not to span file systems
$ ABS CREATE ENV/SPAN_FILESYSTEM=ALL/NOLINKS_ONLY UNIX_SPAN_ENV
This command creates a storage policy in ABS database.
/ACCESS_CONTROL=(user_id=user-name,access="option[,...]")
Enables you to assign the access controls by user name or by access right identifier. Access controls permit all or specific users to access to the storage policy for save and restore operations.
Use this qualifier to specify the type of archive file system to use for the storage policy. ABS supports the following archive types:
Default:
If you do not specify this qualifier, ABS uses MDMS.
Assigns the catalog to be used to store save request information that uses this storage policy.
Default:
If you do not specify this qualifier, ABS assigns the default catalog named ABS_CATALOG.
Specifies the criteria under which new volume sets are created for a save request that uses this storage policy. The following options are valid:
Default:
If you do not specify this qualifier, ABS assigns the following default values:
INTERVAL=7 days, COUNT=0, SIZE=0.
/DRIVE_LIST=(device-name[,...])
Use this qualifier to specify the drive or list of drives to use for the storage policy. To specify a list of drives, enter them in a comma-separated list. You must specify the drive name as the MDMS drive name rather than as the VMS device name.
$ ABS CREATE STORAGE/NAME=MY_STORAGE /DRIVE_LIST=(DRIVE2,DRIVE3,DRIVE4)
Default:
If you do not specify this qualifier, the MDMS software allocates a drive compatible with the media type used by the storage policy.
Specifies the node name on which the save or restore request will execute. For the save or restore of OpenVMS files or Oracle Rdb databases or storage areas, the execution node is ignored. For UNIX or NT files, the execution node is determined by this node name supplies for this qualifier.
/EXPIRATION=date
/NOEXPIRATION
Specifies the date on which the saved data should expire. Reserved words of TODAY and TOMORROW can be specified for the date value.
The /NOEXPIRATION qualifier specifies that the data will expire 9999 days in the future.
Restriction:
If you specify this qualifier, you cannot specify the /RETAIN qualifier in the same CREATE STORAGE_CLASS command.
Default:
If you do not specify this qualifier, ABS uses the number of days assigned to the retention period, or a default retention period of 365 days.
/LOCATION=directory-specification
The disk directory specification into which ABS save sets will be written.
Default:
If you do not specify this qualifier, the default location is based upon the /ARCHIVE_TYPE qualifier. If the archive type is FILES_11, the default location is ABS$ROOT:[000000].
This qualifier allows you to specify the maximum number of save requests that can execute simultaneously using the same storage policy. For example, if you create three save requests that are scheduled to start simultaneously, those save requests can run simultaneously provided there are enough media management resources (such as tape drives and free volumes) to support multiple backup operations. Valid values range from 1 to 36. This qualifier also implies that you can use this number of volume sets for the storage class.
Default:
If you do not specify this qualifier, ABS assigns a value of 1.
Specifies the name of the location from which to select media for the save request. The media location is defined in MDMS.
Restriction:
You can specify this qualifier only when you assign MDMS to the /ARCHIVE_TYPE qualifier.
Default:
If you do not specify this qualifier, ABS uses the location defined as the default for the MDMS domain.
Specifies the owner of the storage policy object.
Default:
The owner is typically the user who installed ABS software, and this user is the only user allowed to make modifications to the storage policy object.
Specifies the number of days the data will be retained in the storage policy.
Restriction:
If you specify this qualifier, you cannot specify the /EXPIRATION qualifier in the same CREATE STORAGE_CLASS command.
Default:
ABS assigns a value of 365 days for the retention period.
Specifies the name of the pool to use for save requests that use this storage policy.
Restriction:
You can only specify this qualifier if you specify MDMS as the archive file system
(/ARCHIVE_TYPE=MDMS)
.
Default:
If you do not specify this qualifier, ABS selects volumes that do not belong to a specific pool.
Use this qualifier to specify the media type for the storage policy. The media type is defined in MDMS.
Requirement:
You must specify this qualifier if the archive file system is MDMS (/ARCHIVE_TYPE=MDMS).
Specifies the name of the volume set to use for save requests using this storage policy.
The volume set name must be one that ABS has previously created. In this situation, if ABS encounters a volume in the free state, ABS generates an error. Also, if the values specified for the /CONSOLIDATION qualifier have been exceeded, ABS will create a new volume set anyway.
Default:
If you do not specify this qualifier, ABS attempts to add its save sets to the last volume set used by ABS for this storage policy.
This command deletes an existing environment policy. ABS enables you to do this provided that the environment policy meets all the required criteria. See the following section titled Restrictions.
Specify the /CONFIRM qualifier to prompt the user for confirmation before deleting the environment policy.
This command deletes an existing ABS restore request.
Specify this qualifier to prompt the user for confirmation before ABS deletes the restore request.
Deletes the restore request even though there is an active archive reference count for the restore request.
Requirement:
You must have ABS_BYPASS access right identifier enabled to invoke this qualifier.
Use this qualifier to specify the version of the restore request that you want to delete.
Default:
If you do not specify this qualifier, ABS deletes all versions.
This command deletes an existing ABS save request.
The user process must have the DELETE access rights identifier enabled on the save request.
Specify this qualifier to prompt the user for confirmation before deleting the save request.
Deletes the save request even though there is an active reference count for the save request.
Requirement:
You must have ABS_BYPASS access right identifier enabled to invoke this qualifier.
Use this qualifier to specify the version of save request that you want to delete.
Default:
If you do not specify this qualifier, ABS deletes all versions.
This command deletes an existing ABS storage policy provided that the storage policy meets all the required criteria. See the following section titled Restrictions.
Specify this qualifier to prompt the user for confirmation before deleting the storage policy.
This qualifier allows you to delete the storage policy object even though there may be reference to it. Use this qualifier with extreme caution. If you delete a storage policy that contains references to it, you will not be able to restore any data that was saved using the storage policy.
Use this qualifier to specify the version of the storage policy that you want to delete.
Default:
If you do not specify this qualifier, ABS deletes all versions.
Use this command to perform a catalog search for data that was saved using ABS.
[/BEFORE] |
A single or comma-separated list of disk or file names to search for in the catalog.
See Entering the Correct Syntax for ABS LOOKUP Command shows how to correctly enter the syntax according to the file type you are looking up.
The following nonpositional qualifiers are applied to the entire ABS LOOKUP command.
Use this qualifier to display only the most important information about the include specification. This information includes the device name, object name, object version, node name, and date archived. For ABS REPORT SAVE_LOG command, this information is displayed in a bulleted list format.
Default:
This is the default behavior for ABS LOOKUP command.
Displays all of the information about the data and includes the disk name, file names, file version, node name, date archived, file type names, creation date, revision date, save set UID, owner, expiration date, file section number, archive transaction UID, storage policy UID, transaction status, and transaction severity. For ABS REPORT SAVE_LOG command, this information is displayed in a bulleted list format.
Restriction:
You cannot specify the /FULL qualifier if the catalog type is SLS.
Default:
If you do not specify this qualifier, ABS uses the /BRIEF qualifier.
Use this qualifier to specify an output location (file name) for the information about the data.
The /NOOUTPUT qualifier suppresses the information.
Default:
If you do not specify a file name for this qualifier, ABS displays the information to SYS$OUTPUT.
Use the /NOSUMMARY qualifier to suppress the summary information line at the bottom of the output information.
Default:
ABS prints a summary information line at the bottom of the output information.
The following positional qualifiers can be applied to the disk or file name specified in the include_spec parameter. You can specify up to eight separate include_ spec parameters per ABS LOOKUP command.
Constrains the search for an archive object with an archive date that is before the specified date. Reserved words of TODAY (default), TOMORROW, or YESTERDAY can be specified for the date value.
Restriction:
If you specify this qualifier, you cannot specify the /DATE_ARCHIVED or the /SINCE qualifier.
Default:
If you do not specify any date selection qualifier, ABS uses the current date and time.
Use this qualifier to search all the catalogs
Use this qualifier to constrain ABS LOOKUP command to a specific catalog.
Restriction:
If you specify this qualifier, you cannot specify the /STORAGE_CLASS qualifier in the same ABS LOOKUP command. Usage of wildcards are not supported.
Default:
If you do not specify this qualifier, ABS searches the catalog pointed to by the SYSTEM_BACKUPS storage class.
Constrains the search for an archive object with the exact archive date. Reserved words of TODAY (default), TOMORROW, or YESTERDAY can be specified for the date value.
Restriction:
If you specify this qualifier, you cannot specify the /BEFORE or /SINCE qualifier for the same ABS LOOKUP command.
Default:
If you do not specify any date selection qualifier, ABS uses the current date.
Constrains the search for an archived object with an exact expiration date. Reserved words of TODAY (default), TOMORROW, or YESTERDAY can be specified for the date value.
Default:
If you do not specify a date value, ABS uses the current date.
Specify this qualifier to constrain the ABS LOOKUP command to search only for a specific file type. ABS supports the following file types:
Default:
If you do not specify this qualifier, ABS searches through all file types for the archive object.
Use this qualifier to constrain the search for a disk or file name by a specific node name.
Default:
If you do not specify a node name or if you use a wildcard character (*), ABS does not use the node name selection criteria.
Constrains the search for an archive object with an archive date that is on or after the specified date. Reserved words of TODAY (default), TOMORROW, or YESTERDAY can be specified for the date value.
Restriction:
If you specify this qualifier, you cannot specify the /DATE_ARCHIVED or the /BEFORE qualifier in the same ABS LOOKUP command.
Default:
If you do not specify any date selection qualifier, ABS uses the current date and time.
/STORAGE_CLASS=storage-policy-name
The name of storage policy to reference for ABS LOOKUP command. If you specify a storage policy name, the search is constrained to the catalog referenced by the specified storage policy.
Restriction:
If you specify this qualifier, you cannot specify the /CATALOG qualifier in the same ABS LOOKUP command.
Default:
If you do not specify this qualifier, ABS searches the SYSTEM_BACKUPS storage class.
Use ABS REPORT SAVE_LOG command to search an ABS catalog or all ABS catalogs for information about the transaction log entries for a save request. You can constrain the reported information by specifying the qualifiers associated with this command.
[/BEFORE] |
Constrains the reported information to an archive date that is before the specified date. Reserved words of TODAY (default), TOMORROW, or YESTERDAY can be specified for the date value.
Restriction:
If you specify this qualifier, you cannot specify the /DATE_ARCHIVED or /SINCE qualifier in the same REPORT SAVE_ LOG command.
Default:
If you do not specify any date selection qualifier, ABS uses the current date and time.
This qualifier displays only the most important information about the log entries. This information includes the date and time the save request was executed, the name of the disk or file that ABS attempted to save, and the current status of the save operation.
Default:
This is the default behavior for the REPORT SAVE_LOG command.
Use this qualifier to search all the catalogs
Use this qualifier to constrain ABS LOOKUP command to a specific catalog.
Use this qualifier to search the specified two catalogs
ABS> REPORT SAVE_LOG/CATALOG=(ABS*,*USER1*)
Such usage of wildcards are not supported
Restriction:
If you specify this qualifier, you cannot specify the /STORAGE_CLASS qualifier in the same ABS REPORT SAVE_LOG command.
Default:
If you do not specify this qualifier or the /STORAGE_CLASS qualifier, ABS searches through all catalogs.
Constrains the report information to the exact specified archive date. Reserved words of TODAY (default), TOMORROW, or YESTERDAY can be specified for the date value.
Restriction:
If you specify this qualifier, you cannot specify either the /BEFORE or /SINCE qualifiers in the same ABS REPORT SAVE_LOG command.
Default:
If you do not specify any date selection qualifier, ABS uses the current date.
Displays all the information about the log entries. This is displayed in a bulleted list format and includes the following information:
Default:
If you do not specify this qualifier, ABS uses the /BRIEF qualifier.
Constrains the reported information to the file name or disk name specified for the include_spec parameter on the original save request.
Restriction:
You must specify this string exactly as it was specified in the include_spec parameter on the original save request.
Default:
If you do not specify this qualifier, ABS reports on all data that was saved using ABS.
Specifies the output file specification for the report. Error and informational messages are still displayed to SYS$OUTPUT.
The /NOOUTPUT qualifier displays the report to SYS$OUTPUT.
Default:
If you do not specify a file name for this qualifier, ABS displays the information to SYS$OUTPUT.
Constrains the reported information to the transactions that were initiated by the specified save request name or list of save request names. Wildcard characters are allowed.
Constrains the reported information to an archive date that is on or after the specified date. Reserved words of TODAY (default), TOMORROW, or YESTERDAY can be specified for the date value.
Restriction:
If you specify this qualifier, you cannot specify either the /DATE_ARCHIVED or the /BEFORE qualifier in the same REPORT SAVE_LOG command.
Default:
If you do not specify this qualifier or any other date selection qualifier, ABS uses the current date.
/STORAGE_CLASS=(storage-policy-name[,...])
Constrains the reported information to the catalog used by the specified storage policy name or list of storage policy names. Wildcard characters are permitted.
Example:
ABS> REPORT SAVE_LOG/STORAGE_CLASS=(ABS*,*USER1*)
Restriction:
If you specify this qualifier, you cannot specify the /CATALOG qualifier in the same ABS REPORT SAVE_LOG command.
Default:
If you do not specify this qualifier, it defaults to the SYSTEM_BACKUPS storage policy.
Specifies to print the summary information at the bottom of the output information.
Default:
If you do not specify this qualifier, summary information is printed at the bottom of the output
Constrains the reported information to the specified volume name or list of volume names.
To report information about a specific save request that was executed before January 1, 1994, and to constrain the reported information to the catalog used by the SYSTEM_BACKUPS storage policy, and to suppress summary information, see the following example:
ABS> REPORT SAVE_LOG/REQUEST=MY_SAVE -
_ABS>/BEFORE=01-JAN-1994/STORAGE_CLASS=SYSTEM_BACKUPS/NOSUMMARY
This command creates an ABS restore request. A restore request restores data from offline storage back to online storage.
The disk or file that you want to restore. The following wildcard characters are permitted in the include_spec parameter for VMS files:
See Entering the Correct Syntax for ABS RESTORE Command shows how to enter the syntax correctly for the file type you are restoring.
ABS> RESTORE/NAME=BOUND_RESTORE DISK$USER1:/OBJECT_TYPE=VMS_FILES -
_ABS>/DESTINATION="DISK$USER1:,DISK$USER2:,DISK$USER3:"
The following nonpositional qualifiers are applied to the entire restore operation.
/ACCESS_CONTROL=(user_id=user-name,access="option[,...]")
Enables you to set up the access controls by user name or by access right identifier.
Requirement:
The access control must be enclosed within quotation marks, and, if you are assigning more than one access control, be specified as a comma-separated list.
Constrains restoring the data from the specified catalog name.
Default:
If you do not specify this qualifier, ABS searches all catalogs for the data to restore.
/DESTINATION=disk-directory-specification
Use this qualifier to specify where you want to restore the data to. Specify the disk and directory name, but not the file name. ABS will assign the original file name. This qualifier is valid for OpenVMS files, Oracle Rdb files, and UNIX files.
Default:
If you do not specify this qualifier, ABS restores the data to its original location.
/ENVIRONMENT=environment-policy-name
Specifies the name of the environment policy to use for the restore operation.
Default:
If you do not specify this qualifier, ABS uses the storage policy name (determined by the disk name or file name specified in the include_spec parameter) appended with _ENV. If that environment is not found, ABS uses the default environment policy named DEFAULT_ENV.
Specifies executing a DCL command after restoring each disk or file name specified in the include_spec parameter.
Restriction:
The string for this qualifier is limited to 80 characters and must be enclosed within quotation marks.
Default:
If you do not specify this qualifier, no epilogue command is executed.
Defines the type of restore operation. A full restore operation restores an entire volume or Oracle Rdb database and includes all necessary incremental backups.
Requirement:
If you specify a full restore operation, you must specify the disk or file name(s) in the include_spec parameter exactly as it was specified in the save request include_spec parameter. See See Entering the Correct Syntax for ABS SAVE Command for an example of creating a full restore request.
Restriction:
ABS does not allow you to create a full restore for a SLS file.
Defines the type of restore operation. An incremental restore operation restores any data contained in a specific incremental backup.
Restriction:
If you specify an incremental restore operation, you must enter the file or disk names in the include_spec parameter exactly as they were entered on the save request include_spec parameter. See See Entering the Correct Syntax for ABS SAVE Command for an example of creating an incremental restore request.
Specify this qualifier to assign a unique name to the restore request.
Restriction:
You can use any supported characters for the restore request name. However, the restore request name cannot exceed 40 characters.
Default:
If you do not specify this qualifier, the default restore request name is the user name and current time of the creating process. For example, if the user name is SMITH, and the current day and time is 15-FEB-1994 11:22:21, the default restore request name would be SMITH_15-FEB-1994_11_ 22_21.
Specifies the owner of the restore request.
Specifies executing a DCL command before restoring each disk or file name specified in the include_spec parameter.
Restriction:
This qualifier is limited to 80 character string and must be enclosed within quotation marks.
Default:
If you do not specify this qualifer, no prologue command is executed.
Defines the type of restore request for ABS to perform. A selective restore request restores only the data specified in the include_spec parameter, such as DISK$USER1:[USER01]*.DAT;*. See See Entering the Correct Syntax for ABS SAVE Command for an example of creating a selective restore request.
Default:
By default, ABS performs a selective restore operation if you do not specify either the /FULL or /INCREMENTAL qualifier.
Defines the type of sequencing to use during the restore operation. ABS supports the following options:
Default:
If you do not specify this qualifier, ABS performs a sequential restore operation.
The time that you want to start the restore request. You can specify time as an absolute time, as a combination of absoluteand delta times, or as one of the standard OpenVMS keywords such as TODAY or TOMORROW. If the specified time is earlier than current time, the request is scheduled for current time. If you specify /NOSTART_TIME, the request will not be started until you modify the start time using the SET RESTORE command.
Default:
If you do not specify this qualifier or if you specify the qualifier with no time value, ABS uses the current date and time.
/STORAGE_CLASS=storage-policy-name
The name of storage policy to reference for the restore operation. If you specify a storage policy name, the restore operation is constrained to the catalog referenced by the storage policy.
Important Note:
You can assign the same catalog name to multiple storage polices. When more than one storage policy contains the same data, and those storage policies reference the same catalog name, ABS restores the most recent data regardless of which storage policy the data is located in.
Restriction:
If you specify the /STORAGE_CLASS qualifier, you cannot specify the /CATALOG qualifier in the same ABS RESTORE command.
Default:
If you do not specify this qualifier, ABS searches all catalogs for the data.
The following positional qualifiers are applied to each file or disk name that you specify in the include_spec parameter. You can specify up to eight separate file or disk names for each restore request that you create.
This qualifier enables you to specify a backup agent-specific qualifier or set of qualifiers. This qualifier is valid for all file types: VMS_FILES, RDB_n_DATABASE, RDB_n_STORAGE_AREA, UNIX_FILES_GTAR, or WINDOWS_NT_FILES_ GTAR.
Constrains the restore request to select data (disk name or file name) archived on or before the specified date. Reserved words of TODAY (default), TOMORROW, or YESTERDAY can be specified for the date value.
If you specify the /NOBEFORE qualifier, ABS does not use any before date selection criteria.
Restriction:
This qualifier is not valid for UNIX or NT restore requests.
Default:
If you do not specify any date selection qualifier, ABS uses the current date and time.
Specifies the manner in which to restore data that already exists on line. This qualifier is positional and is paired with a disk or file name specified in the include_spec parameter. ABS supports the following options:
Specifies the exact date to use to find the data for the restore request.
Default:
If you do not specify any date selection qualifier, ABS uses the current date and time.
Use this qualifier to exclude a file from the restore request. This positional qualifier is paired with a file name entered in the include_spec parameter.
Restriction:
This qualifier is not valid for UNIX or NT save requests.
Default:
If you do not specify this qualifier, ABS restores all data entered in the include_spec parameter.
Use this qualifier to restore only the most recent copy of the saved data.
Specifies the type of data to restore. This positional qualifier is paired with a file or disk name specified in the include_spec parameter. ABS supports the following file types:
Default:
If you do not specify this qualifier, ABS uses /OBJECT_TYPE=VMS_FILES.
Constrains the restore request to select data (disk name or file name) that was archived on a date that is after the date specified for /SINCE. Reserved words of TODAY (default), TOMORROW, or YESTERDAY can be specified for the date value.
Restriction:
This qualifier is not valid for UNIX or NT restore requests.
Default:
If you do not specify any date selection qualifier, ABS uses the current date and time.
For OpenVMS files and Oracle Rdb databases or storage areas, use this qualifier to specify the node where the restore request will execute. For NT and UNIX files, use this qualifier to specify the node name where you want to restore the data to. This positional qualifier is paired with a disk or file name in the include_spec parameter.
Default:
If you do not specify this qualifier, ABS uses the current node of the requesting process.
This command creates an ABS save request that saves data from online storage to offline storage.
The disk or file name that you want to save. The following wildcard characters are permitted in the include_spec parameter for VMS files:
See Entering the Correct Syntax for ABS SAVE Command shows how to correctly enter the syntax for the file type you are saving.
The following nonpositional qualifiers are applied to the entire save request.
/ACCESS_CONTROL=(user_id=user-name,access="option[,...]")
Enables you to set up the access controls by user name or by access right identifier.
Requirement:
The access control must be enclosed within quotation marks, and, if you are assigning multiple access controls per user, they must be listed as a comma-separated list enclosed within quotation marks.
/ENVIRONMENT=environment-policy-name
Specifies the name of the environment policy to use for the save request.
Default:
ABS uses the storage policy name appended with _ENV. If that environment policy is not found, ABS uses the default environment policy named DEFAULT_ENV.
Use this qualifier to execute a DCL command after saving each file or disk specified in the include_spec parameter.
Restriction:
This qualifier is limited to 80 character string and must be enclosed within quotation marks.
Default:
If you do not specify this qualifier, no epilogue command is executed.
Use this qualifier to set the date when the saved data will expire.
Default:
If you do not specify this qualifier, the saved data will expire based upon the /RETAIN qualifier's value, or the default value from the storage policy if the /RETAIN qualifier was not included.
Use this qualifier to specify an explicit interval valid for the current scheduler interface option.
Requirement:
The /EXPLICIT qualifier is only valid when used with the
/SCHEDULE_ OPTION=EXPLICIT qualifier.
Defines the type of save request. A full save request saves an entire disk, or for an Oracle Rdb database, performs a full and complete save operation of the database.
Default:
If you do not specify a type of save request, ABS creates a selective save request. However, if you specify only a disk name in the include_spec parameter, such as DISK$USER1:, by default, ABS creates a full save request. This ensures that you can perform a full restore operation on the disk.
See See Type of Save Request Options for an example of creating a full save request.
Defines the type of backup operation. An save request saves any data modified since the last full or incremental save operation.
However, if you specify only a disk name in the include_ spec parameter, for example DISK$USER1:, and there has not been a full save of the disk, ABS performs a full save operation the first time the save request executes. After that, it performs incremental save operations. This ensures that you can perform a full restore operation on the disk.
Default:
If you do not specify a type of save request, ABS creates a selective save request. However, if you specify only a disk name in the include_spec parameter, such as DISK$USER1:, ABS creates a full save request. This ensures that you can perform a full restore operation on the disk.
See See Type of Save Request Options for an example of creating an incremental save request.
Use this qualifier to assign the name of the save request.
Restriction:
You can use any supported characters for the save request name. However, the save request name cannot exceed 40 characters.
Default:
If you do not specify this qualifier, the default save request name is the user name and current time of the creating process. For example, if the user name is SMITH, and the current day and time is 15-FEB-1194 11:22:21, the default save request name would be SMITH_15_FEB_1994_11_22_ 21.
Specifies the owner of the save request.
Use this qualifier to execute a DCL command or command procedure before saving each disk or file name specified in the include_spec parameter.
Restriction:
This qualifier is limited to 80 character string and must be enclosed within quotation marks.
Default:
If you do not specify this qualifier, no prologue command is executed.
Use this qualifier to specify the retention period (number of days) to retain the saved data.
Restriction:
If you specify this qualifier, you cannot use the /EXPIRATION qualifier in the same ABS SAVE command.
Default:
If you do not specify this qualifier, ABS uses the retention period or expiration date assigned to the storage policy.
Use this qualifier to select the scheduling option for the save request. Choose one of the following options:
Assume skipping this day using special setting in the scheduler being used. |
|||
Notice also in Example B that ABS repeats the full backup operation until a successful full backup operation is achieved on Wednesday. If one of the incremental backup operations fail, ABS skips to the next level of the incremental backup operations. Unlike repeating the full backup operation, ABS does not repeat the same level of incremental backup operations during the 7-day cycle.
In Example B, the Level 4 incremental backup operation failed on Friday. On Saturday, ABS resumes with a Level 5 incremental backup operation. However, the contents of the incremental backup operations are correct because ABS will back up all new or modified files since the last successful full backup operation or the last successful lower level incremental backup operation.
The save log file will contain the following backup command issued by ABS for Saturday, 05-APR-1997:
$ BACKUP/.../SINCE="03-APR-1997 02:00:00.00"
Because the last successful lower level incremental backup operation was performed on 03-APR-1997, all changes to any file since the date and time specified in the BACKUP command are included in the backup operation.
Defines the type of save request. A selective save request saves only the data specified in the include_spec parameter, such as DISK$USER1:[USER01]*.DAT;*. See See Type of Save Request Options for an example of creating a selective save request.
Default:
If you do not specify a type of save request, by default, ABS creates a selective save request. However, if you specify only a disk name in the include_spec parameter, such as DISK$USER1:, ABS creates a full save request. This ensures that you can perform a full restore operation on the disk.
Defines the type of sequencing option to use during the save operation. Choose one of the following options:
Default:
If you do not specify this qualifier, ABS performs a sequential backup operation.
The time that you want to start the save request. You can specify time as an absolute time, as a combination of absolute and delta times, or as one of the standard OpenVMS keywords such as TODAY or TOMORROW. If the specified time is earlier than current time, the request is scheduled for current time. If you specify /NOSTART_TIME, the request will not be started until you modify the start time using the SET SAVE command.
Default:
If you do not specify this qualifier or if you specify the qualifier with no time value, ABS uses the current date and time.
/STORAGE_CLASS=storage-policy-name
The name of storage policy to use for the save request. If you specify a storage policy name, all disk names or file names entered in the include_spec parameter will reside in this storage policy.
Default:
If you do not specify this qualifier, ABS uses the default storage policy named SYSTEM_BACKUPS.
The following positional qualifiers are applied to each file or disk name entered in the include_spec parameter. You can specify up to eight separate file or disk names per save request.
This qualifier enables you to specify a backup agent-specific qualifier or set of qualifiers. This qualifier is valid for all file types: VMS_FILES, RDB_n_DATABASE, RDB_n_STORAGE_AREA, UNIX_FILES_GTAR, and WINDOWS_NT_FILES_ GTAR.
Constrains the save request to select data (disk name or file name) with a date before the entered date. This positional qualifier is paired with a disk or file name entered in the include_spec parameter. Reserved words of TODAY (default), TOMORROW, or YESTERDAY can be specified for the date value.
If you specify the /NOBEFORE qualifier, ABS does not use any before date selection criteria.
Restriction:
This qualifier is not valid for UNIX or NT save requests.
Default:
If you do not specify any date selection qualifier (/BEFORE or /SINCE), ABS uses the current date and time.
Use this qualifier to exclude a file from the save request. This positional qualifier is paired with a file name entered in the include_spec parameter.
Restriction:
This qualifier is not valid for UNIX or NT save requests.
Default:
If you do not specify this qualifier, ABS saves all data entered in the include_spec parameter.
Specifies the type of data to save. This positional qualifier is paired with a disk or file name entered in the include_spec parameter. ABS supports the following file type names:
Default:
The default object type is VMS_FILES.
Use this qualifier to save data that was created or modified after a specific date. This positional qualifier is paired with a disk or file name entered in the include_spec parameter. Reserved words of TODAY (default), TOMORROW, or YESTERDAY can be specified for the date value.
Restriction:
This qualifier is not valid for UNIX or NT save requests.
Default:
If you do not specify any date selection qualifier (/BEFORE or /SINCE) ABS uses the current date and time.
For NT and UNIX files, this positional qualifier defines the node name where the data to save resides. For VMS Files and Oracle Rdb databases or storage areas, the source node is the node where the save request will execute.
Restriction:
For OpenVMS clients, you can specify only one source node per save request. ABS recognizes the source node specified for the first disk or file name, and applies it to the entire save request.
Default:
The default source node is the node on which ABS SAVE command is issued.
Use this option to save a storage area. If you use the /INCLUDE qualifier, only the specified storage areas are saved. |
A selective save operation is determined by the path name entered for the include_spec parameter. To save a directory and all of the subdirectoires and files underneath it, use one of the syntaxes described in See Entering the Correct Syntax for ABS SAVE Command. |
||
Performs a full save operation on an entire OpenVMS disk. This is equivalent to using the /IMAGE qualifier using the VMS BACKUP Utility. For this type of save request, enter only the OpenVMS disk name and include the trailing colon1:
$ ABS SAVE - |
Performs a full and complete backup operation of an Rdb Oracle database. Enter the Rdb Oracle database file name for the include_spec parameter: |
The type of save operation for UNIX and NT files is determined by the pathname entered for the include_spec parameter. ABS automatically turns a full save operation into a selective save operation for UNIX and NT files. |
|
Not recommended because of the amount of effort required to restore individual incremental backup operations. Instead, one of the combined scheduling options such as DAILY_INCREMENTAL_WEEKLY_FULL, LOG-2, or LOG-3 as previously described. |
Not recommended because of the amount of effort required to restore individual incremental backup operations. Instead, use one of the combined scheduling options such as DAILY_INCREMENTAL_WEEKLY_FULL, LOG-2, or LOG-3 as previously described. |
Not recommended because of the amount of effort required to restore individual incremental backup operations. Instead, use one of the combined scheduling options such as DAILY_INCREMENTAL_WEEKLY_FULL, LOG-2, or LOG-3 as previously described. |
This command modifies an existing environment policy in ABS policy database.
The qualifiers for ABS SET ENVIRONMENT command are exactly the same as for ABS CREATE ENVIRONMENT command ( See ABS CREATE ENVIRONMENT) with the exception of the following qualifiers:
Specify the /CONFIRM qualifier to prompt the user for confirmation before ABS modifies the environment policy.
Removes the epilogue command from an existing environment policy.
Removes the locking options from an existing environment policy.
Removes the notification options from an existing environment policy.
Removes the prologue command from an existing environment policy.
More Information:
See ABS CREATE ENVIRONMENT for the remaining qualifier descriptions.
This command modifies an existing restore request in ABS policy database.
The name of the restore request that you want to modify.
This optional parameter enables you to modify the include specification on an existing restore request. You can add or remove a disk or file name using the /ADD or /REMOVE qualifiers.
The qualifiers for ABS SET RESTORE command are exactly the same as for ABS RESTORE command with the exception of the following qualifiers:
The following nonpositional qualifiers are applied to the entire ABS SET RESTORE command.
Specify the /CONFIRM qualifier to prompt for confirmation before modifying the restore request.
Removes the epilogue command from an existing restore request.
Removes the prologue command from an existing restore request.
The following positional qualifiers are applied to each file or disk name entered in the include_spec parameter.
Use this qualifier to add a disk or file name to the include_spec parameter for the existing restore request.
Restriction:
You cannot specify more than eight disk or file names per restore request. If you attempt to add more than eight disk or file names, ABS generates an error.
The time that you want to start the restore request. You can specify time as an absolute time, as a combination of absolute and delta times, or as one of the standard OpenVMS keywords such as TODAY or TOMORROW. If the specified time is earlier than current time, the request is scheduled immediately. If you specify /NOSTART_TIME, the request will not be started until the command is repeated with a specific start time.
Default:
If you do not specify this qualifier, the scheduled start time of the save request is not changed. If you specify the qualifier with no time value, ABS uses the current date and time.
Removes the BEFORE date selection criteria from an existing restore request.
Removes the SINCE date selection criteria from an existing restore request.
Use this qualifier to remove a disk or file name from the include_spec on an existing restore request.
Restriction:
You must have at least one disk or file name remaining in the include_spec parameter. If you attempt to remove all the disk or file names, ABS generates an error.
More Information:
See See ABS RESTORE for the remaining qualifier descriptions.
This command modifies an existing save request in ABS policy database.
[/ACCESS_CONTROL ] |
The name of the save request that you want to modify.
This optional parameter enables you to modify the include_spec on an existing save request. You can add or remove a disk or file name using /ADD or /REMOVE qualifiers.
The qualifiers for ABS SET SAVE command are exactly the same as for ABS SAVE command with the exception of the following qualifiers:
The following nonpositional qualifiers are applied to the entire ABS SET SAVE command.
Specify the /CONFIRM qualifier to prompt the user for confirmation before modifying the save request.
Use this qualifier to set the date when the saved data will expire.
Default:
If you do not specify this qualifier, the saved data will expire based upon the /RETAIN qualifier's value, or the default value from the storage policy if the /RETAIN qualifier was not included.
The time that you want to start the save request. You can specify time as an absolute time, as a combination of absolute and delta times, or as one of the standard OpenVMS keywords such as TODAY or TOMORROW. If the specified time is earlier than current time, the request is scheduled immediately. If you specify /NOSTART_TIME, the request will not be started until the command is repeated with a specific start time specified..
Removes the epilogue command from an existing save request.
Removes the prologue command from an existing save request.
Removes the start time for the save request. To resubmit, you must modify the save request and respecify a start time.
Use this qualifier to specify the retention period (number of days) to retain the saved data.
Restriction:
If you specify this qualifier, you cannot use the /EXPIRATION qualifier in the same ABS SET SAVE command.
Default:
If you do not specify this qualifier, ABS uses the retention period or expiration date assigned to the storage policy.
/STORAGE_CLASS=storage-policy-name
The name of storage policy to use for the save request. If you specify a storage policy name, all disk names or file names entered in the include_spec parameter will reside in this storage policy.
Default:
If you do not specify this qualifier, ABS uses the default storage policy named SYSTEM_BACKUPS.
The following positional qualifiers are applied to each disk or file name in the include_spec parameter
Use this qualifier to add a disk or file name to the include_spec parameter for an existing save request.
Restriction:
You cannot specify more than eight disk or file names per save request. If you attempt to add more than eight disk or file names, ABS generates an error.
Removes the BEFORE date select criteria from an existing save request.
Sets the expiration date to the value from the storage policy.
Removes the SINCE date selection criteria from an existing save request.
Removes a disk for file name from the include_spec parameter on an existing save request.
Restriction:
You must have at least one disk or file name remaining in the include_spec parameter. If you attempt to remove all the disk or file names, ABS generates an error.
More Information:
See See ABS SAVE for the remaining qualifier descriptions.
This command modifies an existing storage policy in ABS policy database.
The qualifiers for ABS SET STORAGE_CLASS command are exactly the same as for ABS CREATE STORAGE_CLASS command with the exception of the following qualifiers:
Specify the /CONFIRM qualifier to prompt the user for confirmation before modifying the storage policy.
Removes the drive list from an existing storage policy.
Sets the expiration date to 9999 days in the future.
Removes any references to the media location for an existing storage policy.
Removes the reference to the tape pool from an existing storage policy.
Removes the references to the media type on an existing storage policy.
Removes the reference to a volume set on an existing storage policy.
More Information:
See See ABS CREATE STORAGE_CLASS for the remaining qualifier descriptions.
This command displays either a particular ABS environment policy or, if you use wildcard characters, displays all of the existing ABS environment policies. Each environment policy display shows some or all of the characteristics associated with the environment policy, depending upon the command's associated qualifiers.
The name of the environment policy that you want to show. The following wildcard characters are permitted:
Displays only the most important information about the environment policy. See the following example:
Execution Environment
Name - SYSTEM_BACKUPS_ENV
Version - 4
Notification Method - OPERATOR
Notification List - TAPES
Notification Reason - FATAL
Notification Type - BRIEF
Number of Drives - 1
Default:
This is the default behavior for ABS.
Displays all the information about the environment policy. See the following example:
Execution Environment
Name - SYSTEM_BACKUPS_ENV
Version - 4
UID - 01DBF057-0CF5-11D2-A98E-08002B2CF5B5
Data Safety Options - None
Listing Option - NO_LISTING
Span Filesystem Options - SPAN FILESYSTEMS
Symbolic Links Option - LINKS_ONLY
Compression Options - None
Original Object Action - NO_CHANGE
User Profile
Node - *
Cluster - *
User - ABS
Privs -
Access Right - None
Owner - NODE01::ABS
Access Right - NODE01::ABS
Access Granted - READ, WRITE, SET, SHOW, DELETE, CONTROL
Notification Method - OPERATOR
Notification List - TAPES
Notification Reason - FATAL
Notification Type - BRIEF
Locking Options - IGNORE_WRITERS
Number of Drives - 1
Retry Count - None
Retry Interval - None
Prologue Command - None
Epilogue Command - None
Default:
If you do not specify this qualifier, ABS uses the /BRIEF qualifier.
Specifies the name of the file to output the information to instead of to SYS$OUTPUT.
Default:
If you do not specify a file name for this qualifier, ABS displays the information to SYS$OUTPUT.
Use this qualifier to specify the version of the environment policy that you want to show.
Default:
If you do not specify this qualifier, ABS displays the most recent version.
Execution Environment
Name - SYSTEM_BACKUPS_ENV
Version - 1
Notification Method - NOTIFY_BY_MAIL
Notification List - <REQUESTER>
Notification Reason - ON_FATAL_ERROR_CONDITION
Notification Method - NOTIFY_OPERATOR
Notification List - TAPES
Notification Reason - ON_FATAL_ERROR_CONDITION
Number of Drives- 1
This command allows you to show the status of a save request. The information displayed for this command consists of the time stamp, the file count, and the current status of the save request.
To use this command, you must define the following logical name:
$ DEFINE/SYSTEM ABS$MONITOR_UPDATE_INTERVAL 30
Where:
30 is the number of seconds that you desire between updates.
This command displays either a specified ABS restore request or, if wildcard characters are used, displays all ABS restore requests owned by the requesting process. Each displayed restore request shows all or some of the characteristics associated with that restore request, depending upon the qualifiers associated with the command.
The name of the restore request that you want to show. The following wildcard characters are permitted:
Displays only the most important information about the restore request.
Default:
This is the ABS default behavior.
Displays all the information about the restore request.
Default:
If you do not specify this qualifier. ABS uses the /BRIEF qualifier.
Specifies the name of the file to output the information to instead of to SYS$OUTPUT.
Default:
If you do not specify a file name for this qualifier, ABS displays the information to SYS$OUTPUT.
Stores selected RESTORE set information in process symbols. The following table contains the symbols that are created:
Restrictions:
The wild card character "*" is not allowed as the object name. The qualifiers /BRIEF or /FULL are not allowed when specifying /SYMBOLS.
Default:
If you do not specify the qualifier, no process symbols are created.
Use this qualifier to specify the version of the restore request that you want to show.
Default:
If you do not specify this qualifier, ABS displays the most recent version.
To show the attributes of the restore request named USER1_ 01-JAN-1994_12:00:00:00, enter the following command:
ABS> SHOW RESTORE USER1_01-JAN-1994_12_00_00_00
Restore Request
Name - USER1_01-JAN-1994_12_00_00_00
Version - 1
Movement Type- SELECTIVE_RESTORE
Target Node Name- NODE01
Include Spec - DISK$USER1:[USER1]*.COM;*
Exclude Spec -
Storage Class Name - SYSTEM_BACKUPS
Date Archived- 1-JAN-1993 09:40:13.47
Execution Envir - SYSTEM_BACKUPS_ENV
This command displays either a specified ABS save request, or if wildcard characters are used, displays all ABS save requests owned by the requesting process. Each displayed save request shows some or all of the characteristics associated with that save request, depending upon the qualifiers associated with the SHOW SAVE command.
The name of the save request that you want to show. The following wildcard characters are permitted:
Displays only the most important information about the save request.
Default:
This is ABS default behavior.
Displays all the information about the save request.
Default:
If you do not specify this qualifier. ABS uses the /BRIEF qualifier.
Specifies the name of the file to output the information to instead of to SYS$OUTPUT.
Default:
If you do not specify a file name for this qualifier, ABS displays the information to SYS$OUTPUT.
Stores selected SAVE information in process symbols. The following table contains the symbols that are created:
Restrictions:
The wild card character "*" is not allowed as the object name. The qualifiers /BRIEF or /FULL are not allowed when specifying /SYMBOLS.
Default:
If you do not specify the qualifier, no process symbols are created.
Use this qualifier to specify the version of the save request that you want to show.
Default:
If you do not specify this qualifier, ABS displays the most recent version.
Save Request
Name - USER1_01-JAN-1994_12_00_00_00
Version - 1
Movement Type- SELECTIVE_ARCHIVE
Source Node Name- NODE01
Include Spec - DISK$USER1:[USER1]*.COM;*
Exclude Spec -
Storage Class Name - SYSTEM_BACKUPS
Start Time -
Execution Envir- SYSTEM_BACKUPS_ENV
This command displays either a specified ABS storage policy, or if wildcard characters are used, displays all ABS storage policies. Each displayed storage policy shows some or all of the characteristics associated with that storage policy, depending upon the qualifiers used with the command.
Specifies the name of the storage policy to show. The following wildcard characters are supported:
You must have the SHOW access right identifier enabled on the storage policy that you want to show, or you must enable the access rights identifier ABS_SHOW_ALL or ABS_BYPASS on your user process.
Displays only the most important information about the storage policy. See the following example:
Storage Class
Name - SYSTEM_BACKUPS
Version - 30
Execution Node Name - NODE01
Primary Archive Type - SLS/MDMS
Catalog Name - ABS_CATALOG
Default:
This is default behavior for ABS.
Displays all the information about the storage policy. See the following example:
Storage Class
Name - SYSTEM_BACKUPS
Version - 30
UID - 3822C8F6-2173-11D2-A98E-08002B2CF5B5
Execution Node Name - NODE01
Archive File System
Primary Archive Location -
Staging Location -
Primary Archive Type - SLS/MDMS
Owner - NODE01::ABS
Access Right - NODE01::ABS
Access Granted - READ, WRITE, SET, SHOW, DELETE, CONTROL
Tape Pool - TL810_P
Volume Set Name - None
Retention Period - 365
Consolidation Criteria
Count - 0
Size - 0
Interval - 7
Catalog Name - ABS_CATALOG
Maximum Saves - 1
Media Management Info
Media Location - None
Type of Media - TK85K_810
Drive List - None
Default:
If you do not specify this qualifier. ABS uses the /BRIEF qualifier.
Specifies the output file name for the information about the SHOW STORAGE_CLASS command.
Default:
If you do not specify a file name for this qualifier, ABS displays the information to SYS$OUTPUT.
Use this qualifier to specify the version of the storage policy that you want to show.
Default:
If you do not specify this qualifier, ABS displays the most recent version.
This command allows you to show the version of ABS software and its related component versions.
If you execute an ABS SHOW VERSION command on an ABS client system, you will recieve the following error:
File ABS$SYSTEM:ABS$POLICY_ENGINE.EXE could not be opened, check file access privileges.
This error is generated because the ABS$POLICY_ENGINE.EXE image only exists on the ABS server. To see the version of this image, execute the command on the ABS server.
Enter the following command at the system prompt:
Version of SYS$LIBRARY:ABS$SHR.EXE is ALPHA ABSV3.0
Version of SYS$LIBRARY:ABS$SLS_SERVICES.EXE is ALPHA ABSV3.0
Version of SYS$LIBRARY:ABS$USSSHR.EXE is ALPHA ABSV3.0
Version of ABS$SYSTEM:ABS$POLICY_ENGINE.EXE is ALPHA ABSV3.0
Version of ABS$SYSTEM:COORDINATOR.EXE is ALPHA ABSV3.0
Version of ABS$SYSTEM:ABS_UI.EXE is ALPHA ABSV3.0
Version of SYS$SYSTEM:ABS$DCL.EXE is ALPHA ABSV3.0
Version of ABS$SYSTEM:ABS$UBS.EXE is ALPHA ABSV3.0
This command enables you to spawn out of ABS process and provides a DCL prompt. To resume ABS process, log out at the DCL prompt.
This command allows a DCL command procedure to synchronize with the completion of a save or restore operation.
Specifies the name of the save or restore request to synchronize with. This name must match the save or restore request name returned when the save or restore request was created.
To use the SYNCHRONIZE command in a user-written command procedure, the save or restore request name can be returned to the DCL command procedure through a process symbol named ABS$REQUEST_NAME. However, if you know the name of the save or restore request, use the request name to synchronize with.
Specifies the name of the symbol to use to return the severity of the completing save or restore request.
Default:
If you do not specify this qualifier, ABS does not create a severity symbol.
Specifies the name of the symbol to use to return the status of the completing save or restore request.
Default:
If you do not specify this qualifier, ABS does not create a status symbol.
The MDMS ALLOCATE DRIVE command selects and allocates a drive based on user-specified selection criteria.
The selected drive name is assigned to the optional process logical name, which may be used in subsequent commands by that process.
Equivalent STORAGE Command: STORAGE SELECT
The name of a specific drive to allocate, which must already have been created with a CREATE DRIVE command. The maximum length of the drive name is 31 characters.
This parameter is optional. Drives can also be allocated on the basis of other selection criteria
The MDMS ALLOCATE DRIVE command selects and allocates a drive based on one of the following:
The selected local OpenVMS device name and the drive name are assigned to the optional logical name in a search list. Both MDMS and non-MDMS DCL commands may be issued using the logical name. The logical name remains assigned until:
The MDMS ALLOCATE DRIVE command allocates the selected drive to the current process. After the MDMS ALLOCATE DRIVE command is issued, the name of the selected drive is displayed on the terminal screen. The DCL SHOW LOGICAL command also displays the OpenVMS local device name and the drive name.
If the volume specified currently resides in a jukebox, the drive selected will be from the same jukebox if the drives in the jukebox support the media type of the volume.
MDMS supports allocation of both local drives and remote drives (using the RDF software). However, allocation of remote drives through RDF is not available if you are running with the ABS-OMT license.
The request requires MDMS_ALLOCATE_ALL or MDMS_ALLOCATE_OWN.
MDMS_ALLOCATE_OWN requires the specification of an owned volume for selection.
All other selections including the drive name parameter, require MDMS_ALLOCATE_ALL.
The drive_name parameter cannot be used with the /MEDIA_TYPE, /JUKEBOX,
/LOCATION, /NODE, /GROUP, or /VOLUME qualifiers.
The /JUKEBOX qualifier cannot be used with /GROUP, /LOCATION,
/NODE, /VOLUME, or the drive_name parameter.
The /MEDIA_TYPE qualifier cannot be used with /VOLUME or the drive_name parameter.
The VOLUME qualifier cannot be used with /GROUP, /LOCATION,
/MEDIA_TYPE, /NODE, /JUKEBOX or the drive_name parameter.
The /GROUP, /JUKEBOX, /LOCATION and /NODE qualifiers are mutually exclusive. If one is specified, then /MEDIA_TYPE must also be specified (except for /JUKEBOX).
The /[NO]PREFERRED qualifier is ignored if /VOLUME is not supplied.
The default /ASSIST qualifier outputs an operator request to allocate a drive, if there is a problem allocating a drive immediately. If the operator responds positively to the operator message, the request is retried, otherwise the request fails. The /NOASSIST qualifier performs the operation without operator assistance, and uses the /RETRY and /INTERVAL qualifiers to perform retries. If all retries are exhausted the command fails.
This qualifier requires the right MDMS_ASSIST
Specifies the logical name to be assigned for the drive. The logical name is a process logical name. The maximum length of the logical name is 31 characters. The logical name is assigned to an equivalence string containing the drive name and allocated VMS device name in a search list - as such, both MDMS and non-MDMS commands (e.g. MOUNT) can be issued on the logical name
When used with /MEDIA_TYPE, this qualifier specifies the name of the group (of nodes supporting the drive) from which to select and allocate the drive. Only one group may be specified.
This qualifier requires the right MDMS_ALLOCATE_ALL.
Specifies the interval between retries when no drives are available. If not specified, the default interval is one minute.
Specifies the name of the jukebox from which the drive will be selected for allocation. The maximum length of the jukebox name is 31 characters. If /MEDIA_TYPE is also specified, the drive must be in the jukebox and support the specified media type
This qualifier requires the right MDMS_ALLOCATE_ALL.
When used with /MEDIA_TYPE, this qualifier specifies the location from which to select and allocate the drive. Only one location may be specified.
This qualifier requires the right MDMS_ALLOCATE_ALL.
Specifies the distinct media type that the drive must support. This media type must match one defined for a drive with the MDMS CREATE DRIVE or MDMS SET DRIVE commands.
This qualifier requires the right MDMS_ALLOCATE_ALL
When used with /MEDIA_TYPE, this qualifier specifies the name of the node from which to select and allocate the drive. Only one node may be specified.
This qualifier requires the right MDMS_ALLOCATE_ALL
The /PREFERRED qualifier tries to allocate the preferred drive for a volume, when /VOLUME is entered; this is the last drive that the volume was loaded in, if that drive is available. The default /NOPREFERRED forces a round-robin selection.
Specifies the name of the symbol to receive the operator's reply when operator intervention is needed. The symbol will contain the operator reply to the DCL REPLY/TO or
DCL REPLY/ABORT commands. The maximum length of a symbol name is 31 characters.
This qualifier is only applicable when /ASSIST is specified.
Specifies if MDMS should retry the operation if no drive is available and /ASSIST is not specified. The default is /RETRY_LIMIT=0 which means that no retries are performed.
/NORETRY_LIMIT means that there is no limit on the number of retries. Retries are performed at the delta time specified by /INTERVAL. If all retries are exhausted the operation fails.
Specifies if the volume ID of the volume for which an appropriate drive will be selected, can support the volume's media type and placement. The maximum length of the volume ID is 6 characters.
Specifies that the drive is to be allocated only for read-only operations. This potentially makes a larger pool of drives available for allocation for certain media types.
$ MDMS ALLOCATE DRIVE $1$MUA5 /DEFINE=MYDRIVE
This command allocates the drive $1$MUA5 and assigns the drive name to the MYDRIVE logical name. Note that the drive name is the same as the VMS device name in this case.
$ MDMS ALLOCATE DRIVE JUKE_2_DRIVE_1 /ASSIST /REPLY=ALLOC_REPLY
This command allocates drive JUKE_2_DRIVE_1, and requests operator assistance if the allocation fails, and stores the operator's reply message in symbol ALLOC_REPLY.
$ MDMS ALLOCATE DRIVE /VOLUME=LAB003 /NOWRITE /NOPREFERRED
This command allocates a drive that supports volume LAB003 for read-only operations, and requests a round-robin drive selection rather than use the preferred drive.
$ MDMS ALLOCATE DRIVE /JUKEBOX=TESTJUKE /DEFINE=MYDRIVE
This command allocates one of the drives in jukebox TESTJUKE and assigns the drive name to the MYDRIVE logical name.
$ MDMS ALLOCATE DRIVE /MEDIA_TYPE=TK85K /NODE=CRUMBS -
/INTERVAL=00:00:10 /NORETRY_LIMIT
This command allocates a drive that supports the TK85K media type on node CRUMBS, and specifies a retry interval of 10 seconds if a drive is not immediately available with no limit on retries.
The MDMS ALLOCATE VOLUME command allocates available free volumes to the requesting user or a specified user.
Equivalent STORAGE Command: STORAGE ALLOCATE
Specifies the volume to allocate. The maximum length of the volume_id is 6 characters.
This parameter is optional, and volumes can be allocated on the basis of
/BIND, /JUKEBOX, /LIKE_VOLUME, /LOCATION, /MEDIA_TYPE or /POOL instead.
The MDMS ALLOCATE VOLUME command allocates available free volumes to the username of the requesting process. The newly allocated volume(s) can also be appended to the end of a volume set. A volume set is defined to be one or more allocated volumes.
When the volume_id parameter is used, that specific volume will be assigned if it is in the Free state. If the volume_id parameter is not used, the volume will be selected based on one or more of the following selection criteria.
The request requires MDMS_ALLOCATE_ALL or MDMS_ALLOCATE_POOL.
MDMS_ALLOCATE_POOL requires the volume to be allocated from a named pool to which the calling user is authorized. All other allocations, including allocation from the scratch (unnamed) pool and the specification of /USER_NAME, require MDMS_ALLOCATE_ALL.
The /BIND qualifier requires MDMS_BIND_ALL if the /USER_NAME qualifier is specified, or MDMS_BIND_OWN.
The /BLOCK_FACTOR, /DESCRIPTION, /FORMAT, /RECLENGTH, [NO]SCRATCH_DATE and /[NO]TRANSITION_TIME qualifiers require MDMS_SET_ALL if the /USER_NAME qualifier is specified, or MDMS_SET_OWN or MDMS_SET_POOL.
Specifies that the new allocated volume or volume set be appended to the volume set marked by the volume_id. The volume_id specifies selection criteria for allocating the new volume(s). The maximum length of the volume_id is 6 characters.
When the /BIND qualifier is used, the following attributes must match.
This qualifier requires the right MDMS_BIND_*
Modifies the block factor attribute of the allocated volume records. Applies only to volume records with a format of EBCDIC. If not specified, the block factor attribute is not changed.
This qualifier requires the right MDMS_SET_*
Specifies a logical name to be assigned for the volume allocated. The logical name is a process logical name. If the /QUANTITY qualifier is used, the returned volume will be the first volume in the volume set. The maximum length of the logical name is 31 characters.
Modifies comments about the object in the volume record. If the text contains spaces, it must be enclosed within quotation marks. The length of the description can range from 0 to 255 characters.
To clear the existing description, specify "". If not specified, the volume description is not changed. This qualifier requires the right MDMS_SET_*
Modifies the format field in the volume record.
If not specified, the format attribute is not changed.
Valid values are:
This qualifier requires the right MDMS_SET_*
Allocates a volume that resides in the specified jukebox.
Indicates that the allocated volume has attribute values identical to those specified. The following attributes define a "like volume":
Specifies the location from which to allocate volume(s). If not entered, other selection criteria are used to allocate the volume(s).
Specifies that the volume(s) are allocated with the specified media type. If not specified, other selection criteria are used to allocate the volume(s).
Specifies the pool from which the volume(s) will be selected. The maximum length of the pool name is 31 characters.
Specifies the number of volumes to allocate. Use this qualifier to allocate more than one volume.
The default value is 1. If you enter a number greater than 1, the allocated volumes are bound together in one volume set. If you use the /BIND qualifier, these allocated volumes are bound to the end of the set specified in the /BIND qualifier.
Modifies the volume's record length attribute. If not specified, the record length attribute is not changed.
This qualifier requires the right MDMS_SET_*
Modifies the scratch date in the volume record. The scratch date is the date that the volume is placed in the TRANSITION state (or FREE state if the volume has no transition duration).
If /NOSCRATCH_DATE is specified, the volume will never be automatically deallocated. If not specified, the volume's scratch date is not changed.
This qualifier requires the right MDMS_SET_*
Modifies the amount of time, as a delta time, that will be applied to the current scratch date to form the length of time the volume(s) will remain in the TRANSITION state before going into the FREE state. Use the standard OpenVMS delta time format to specify a delta time for the duration. If /NOTRANSITION_TIME is specified, the volume goes directly into the FREE state on deallocation. If not specified, the transition time in the volume record is not changed.
This qualifier requires the right MDMS_SET_*
Specifies the user for whom the volume is being allocated. The username must exist on the system where the command is entered. The maximum length of the username is 31 characters.
$ MDMS ALLOCATE VOLUME /QUANTITY=3 /MEDIA_TYPE=TK85K
This command allocates three TK85K volumes to the current user. The volumes are bound in a new volume set.
$ MDMS ALLOCATE VOLUME /MEDIA=TK85K /LOCATION=CXO
This command allocates one TK85K volume at location CXO to the current user.
$ MDMS ALLOCATE VOLUME /BIND=TEST01
This command allocates one volume with the same attributes as TEST01 to the current user. The new volume is bound to the end of the volume set containing TEST01.
$ MDMS ALLOCATE VOLUME USER30 /DESCRIPTION="MAY REPORTS"
This command allocates volume USER30 to the current user and modifies the volumes description to "MAY REPORTS".
$ MDMS ALLOCATE VOLUME /LIKE_VOLUME=AGW500 /USER_NAME=SYSTEM
This command allocates a volume with similar attributes to volume AGW500, for user SYSTEM
The MDMS BIND VOLUME command binds a volume to another volume or volume set or binds a volume set to another volume set.
Equivalent STORAGE Command: STORAGE APPEND
Specifies the volume ID of the volume to bind.
If an existing volume set is to be bound to another volume or volume set, then the volume ID of the first member of the volume set to bind should be specified. The maximum length of a volume ID is 6 characters. If the volume_id parameter is omitted, a volume with similar characteristics to those in the set will be allocated and bound to the end of the volume set.
The MDMS BIND VOLUME command binds a volume to another volume or volume set or binds a volume set to another volume set. When binding to a volume or volume set, all involved volumes must be allocated and be of the same media type.
While binding a volume set to another volume or volume set, the volume_id parameter must be the first member of the volume set.
To append to the end of a volume set, use the /TO_SET qualifier. Volumes in the volume set must already be allocated to the same user (username and UIC). When a new volume is bound to a volume set the scratch dates of all volumes in the set will be set to the scratch date of the newly bound volume.
The request requires MDMS_BIND_ALL or MDMS_BIND_OWN.
If the /USER_NAME qualifier is not specified, MDMS_BIND_OWN allows the user to bind volumes which are allocated to that user. Binding on behalf of another user with the
/USER_NAME qualifier requires MDMS_BIND_ALL.
Specifies the volume ID of a volume or volume set member. The volume (set) specified in the volume_id parameter is appended to the end of the volume set containing this volume. The maximum length of the volume ID is 6 characters.
If the volume_id parameter is not provided, then a similar volume to the volume specified in the /TO_SET qualifier is allocated and bound to the end of that volume set.
Specifies the user for whom the volume is being bound. The username must exist on the system where the command is entered. The maximum length of the username is 31 characters.
$ MDMS BIND VOLUME VOL001/TO_SET=VOL006
Volume set 1 contains VOL001, VOL002 and VOL003. Volume set 2 contains VOL004, VOL005 and VOL006. This command binds the volume set containing VOL001 to the volume set containing VOL006. The created volume set will contain volumes VOL004, VOL005, VOL006, VOL001, VOL002, VOL003.
Volumes in both volume sets must have compatible attributes.
$ MDMS BIND VOLUME VOL002 /TO_SET=VOL005 /USER_NAME=SYSTEM
Volume VOL002 is a single volume and VOL005 is part of a volume set that contains VOL004, VOL005 and VOL006. This command binds the volume VOL002 to the volume set containing VOL005. The created volume set will contain volumes VOL004, VOL005, VOL006, VOL002. All the volumes involved are allocated to user SYSTEM.
The MDMS CANCEL REQUEST command cancels a previously issued request. The request may have been issued either synchronously or asynchronously.
The following types of request can be cancelled using this command:
Equivalent STORAGE Command: None.
Specifies the request ID(s) of the request(s) to cancel. If the request ID is not known, the user can issue a SHOW REQUESTS command, which displays the request ID of all outstanding requests.
The MDMS CREATE DRIVE command creates a new drive definition in the MDMS configuration database.
Equivalent STORAGE Command: None
Specifies the name of the drive. The maximum length of the drive name is 31 characters. On CREATE, the OpenVMS device name must also be specified with the
/DEVICE qualifier if it is different from the drive name. The drive name must be unique in the MDMS domain. You should not specify a node in the drive name; rather you should specify either a list of nodes or groups that have access to the drive in the /NODES or /GROUPS qualifiers.
The MDMS CREATE DRIVE command creates a new drive definition in the MDMS configuration database.
While creating a new object record, MDMS supplies default values on attributes that are not specified. Alternatively, they can be inherited from a specified drive using the /INHERIT qualifier.
The request requires MDMS_CREATE_ALL.
The /STATE qualifier also requires MDMS_SET_PROTECTED since this attribute is normally managed by MDMS. You should not modify this attribute unless you are trying to recover from an abnormal situation.
The /NODES and /GROUPS qualifiers are mutually exclusive. The MDMS server will refuse this command if both qualifiers are used in the affirmative forms.
The /ADD, /REMOVE and /REPLACE qualifiers are mutually exclusive. If none of them is specified, attributes are added to the list attributes by default.
This qualifier defines the type of access to the drive, which can be one of the following keywords:
The /ADD qualifier works in conjunction with certain qualifiers that accept lists and adds specified attributes. This is the default while specifying list attributes.
Specifies that MDMS automatically replies to all OPCOM messages that can be polled for completion on requests for this particular drive.
Comments about the drive. If the text contains spaces, then it must be enclosed within quotation marks. The length of the description can range from 0 to 255 characters. To clear the description, specify "".
Specifies the OpenVMS device name of the drive. This qualifier is required if the OpenVMS device name is different from the drive name. Do not include a node specification (NODE::drive) in the drive name - instead, use the /NODES or /GROUPS qualifier.
Places the drive in the disabled state. This prevents the drive from being selected and allocated for use. This takes effect immediately. However, if the drive is already in use, operations on that drive will continue until the drive is deallocated.
This qualifier defines the drive number for robot commands if the drive is in a jukebox. The default is zero. This qualifier must be specified for multi-drive MRD-controlled jukeboxes.
Places the drive in the enabled state. This allows the drive to be selected and allocated for use. This takes effect immediately. This is the default.
Specifies the names of groups of nodes that share common access to this device. Usually, only one group is specified. If neither /NODES or /GROUPS is specified on CREATE, the node from which the command was issued is used as the node name
This qualifier allows you to specify an existing drive record from which the new object record inherits attribute values. MDMS supplies default values if you specify none. All attributes may be inherited with the exception of the following:
If the drive is in a jukebox, this qualifier specifies the jukebox name.
/MEDIA_TYPE=(media_type[,...])
Specifies one or more distinct media types that the drive can support for read-write access.
The /REMOVE or /REPLACE qualifiers can remove or replace items in the listing, rather than adding them by default. The /NOMEDIA_TYPES qualifier removes all media types. When a drive is created with no media types, the default media type from the domain is used.
Specifies one or more distinct nodes that have direct access to the drive. The /REMOVE or
/REPLACE qualifiers can be used to remove or replace objects in the list, rather than adding them by default. The /NONODE qualifier removes all nodes. If neither /NODES or /GROUPS are specified on CREATE, the node from which the command was issued is used as the node name
Specifies one or more distinct media types that the drive can support for read-only access.
The /REMOVE or /REPLACE qualifiers can be used to remove or replace objects in the list, rather than adding them by default. The /NOREADONLY qualifier removes all read-only media types.
The /REMOVE qualifier works in conjunction with certain qualifiers that accept lists and removes specified attributes from them.
The /REPLACE qualifier works in conjunction with certain qualifiers that accept lists and replaces the existing attributes list with the specified attributes list. By default, list attributes are added to the existing list.
The /SHARED qualifier defines that the drive may be used by non-MDMS clients and that the drive is only partially managed. The default, /NOSHARED, indicates that all access to the drive is through MDMS. If the drive is set to the default /NOSHARED, the MDMS server allocates the drive at all times it is not used by an application or user. Setting the drive to /SHARED clears this allocation.
The /STACKER qualifier indicates that the drive is to be treated as a stacker gravity loader. The default /NOSTACKER indicates that the drive is to be treated as a standalone drive, or a robotically-controlled jukebox, as appropriate.
The /STATE qualifier sets the current drive state. This is normally set by MDMS. The valid keywords are:
This command creates a local drive called $1$MUA5 with default parameters supplied by MDMS. In this example, the drive name is equivalent to the OpenVMS device name and the current node is used as the drives node name.
$ MDMS CREATE DRIVE DRIVE_1 /DEVICE=$1$MUA5: /NODE=FARLFT
This command creates a local drive called DRIVE_1 for $1$MUA5 on node FARLFT.
$ MDMS CREATE DRIVE JUKE_1_DRIVE_1 /MEDIA_TYPES=(TK85K, -
TK88K) /DEVICE=$1$MKA500 /GROUPS=COOKIE /SHARE /JUKEOX=JUKE_1 -
/DRIVE_NUMBER=1 /ACCESS=ALL
This command creates a drive with drive name JUKE_1_DRIVE_1 and OpenVMS device name
$ $1$MKA500 in group COOKIE, for local and remote access, shared by non-MDMS users, and supporting media types TK85K and TK88K. The drive is part of jukebox JUKE_1 with drive number 1.
$ MDMS CREATE DRIVE FRED /ACCESS=REMOTE
This command creates a drive object record named FRED for remote access. MDMS supplies all default attribute values.
$ MDMS CREATE DRIVE SPARKY_5 /DEVICE=$1$MUA5 /NODE=SPARKY -
/DISABLE /MEDIA_TYPES=TK85K /ACCESS=ALL
This command defines drive SPARKY_5 , device $1$MUA5 on node SPARKY, that supports media type TK85K, supports both local and remote access, and is located on remote node SPARKY. The drive is not available for immediate use.
The MDMS CREATE GROUP command creates a definition of a group of nodes in the MDMS domain.
Equivalent STORAGE Command: None
Specifies the name of the group. A group includes nodes that share a common storage device or some other relationship. There is no limit to the number of groups you may specify, and any node may appear in any number of groups. Groups may or may not be equivalent to clusters in your environment. Groups may be used instead of nodes in drive and jukebox definitions, and also as authorized or default users in pool definitions.
The MDMS CREATE GROUP command creates a new group definition in the MDMS configuration database.
When creating a new object record, the user can specify attribute values or allows for MDMS default value assignments. Alternatively, values can be inherited from a specified group using the /INHERIT qualifier.
The /ADD, /REMOVE and /REPLACE qualifiers are mutually exclusive. If none are specified, attributes are added to list attributes by default.
The /ADD qualifier works in conjunction with certain qualifiers that accept lists and adds specified attributes. This is the default while specifying list attributes.
Comments about the group. If the text contains spaces, then it must be enclosed within quotation marks. The length of the description can range from 0 to 255 characters. To clear the description, specify "".
This qualifier allows you to specify an existing group record to inherit attribute values. All attributes may be inherited except for group name.
Specifies one or more distinct nodes that are members of the group.
The /REMOVE or /REPLACE qualifiers can be used to remove or replace objects in the list, rather than adding them by default. The /NONODES qualifier removes all nodes. While specifying nodes, the node names are the MDMS node names, which should have an equivalent node object (not the DECnet-Plus (Phase V) or TCP/IP fullnames).
The /REMOVE qualifier works in conjunction with certain qualifiers that accept lists and removes specified attributes from them.
The /REPLACE qualifier works in conjunction with certain qualifiers that accept lists and replaces the existing attributes list with the specified attributes list. By default, list attributes are added to the existing list.
$ MDMS CREATE GROUP HOSER /NODES=(TOOKUS, GREAT, NORTH)
This command creates a group named HOSER and includes the nodes TOOKUS, GREAT, and NORTH.
$ MDMS CREATE GROUP MOUNTIE /INHERIT=HOSER /NODES=LABATT /ADD
This command creates a new group that includes the nodes in the group HOSER and adds node LABATT to the node list. You would use this command if the group HOSER includes all nodes in an OpenVMS Cluster, and you want to manage a device shared between that cluster and node LABATT (which could be a member of a different OpenVMS Cluster system)
The MDMS CREATE JUKEBOX command creates a new jukebox definition in the MDMS configuration database.
Equivalent STORAGE Command: None
Specifies the name of the jukebox, which can be up to 31 characters in length. The jukebox name must be unique in the MDMS domain.
The MDMS CREATE JUKEBOX command creates a new jukebox definition in the MDMS configuration database. MDMS supplies attribute values when creating a new object record. Alternatively, they can be inherited from a specified jukebox using the /INHERIT qualifier.
An MDMS jukebox may be controlled by the MRD subsystem if it accepts direct SCSI robotic operations. Each MRD-controlled jukebox contains a set of slots, drives and robotics configured with a single robotic device name, regardless of whether the jukebox is:
A robot name must be associated with each MRD-controlled jukebox. For a multi-tower configuration, a topology field may optionally be associated with the jukebox if the jukebox supports direct magazine moves.
Certain other types of jukeboxes, specifically silos manufactured by StorageTek, require the DCSC subsystem for control. With this model, each MDMS jukebox object maps to a Library Storage Module (LSM) containing a carousel of cells, drives and robotics.
One or more LSMs are contained within an Automated Cartridge System (ACS) and one or more ACS's are managed by a UNIX-based system called a library. For each DCSC-controlled jukebox, the library, ACS ID and LSM ID must be specified.
In addition, each LSM contains one or more Cartridge Access Points (CAPS) that are used to move volumes into and out of the jukebox (LSM). Each CAP may contain a different number of cells, so the CAP size should be specified for each CAP for optimal performance. A value of 40 is used if CAP size is not defined for a particular CAP.
The request requires MDMS_CREATE_ALL.
The /STATE qualifier also requires MDMS_SET_PROTECTED since this attribute is normally managed by MDMS. Users should not modify this attribute unless they are trying to recover from an abnormal situation.
The /NODES and /GROUPS qualifiers are mutually exclusive. The MDMS server will refuse this command if both qualifiers are used in the affirmative forms.
The /ADD, /REMOVE and /REPLACE qualifiers are mutually exclusive. If no qualifier is specified, attributes are added to list attributes by default.
This qualifier defines the type of access to the jukebox, which can be one of the following keywords:
This qualifier specifies the Automated Cartridge System (ACS) Identifier for the jukebox. The default value is zero. Each MDMS jukebox maps to one Library Storage Module (LSM), and requires specification of the library, ACS and LSM identifiers. Valid for DCSC-controlled jukeboxes only.
The /ADD qualifier works in conjunction with certain qualifiers that accept lists and adds specified attributes. This is the default when specifying list attributes.
Specifies that MDMS automatically replies to all OPCOM messages that can be polled for completion on requests for this particular jukebox.
For DCSC jukeboxes equipped with Cartridge Access Points (CAPS), this attribute specifies the number of cells for each CAP. The first number is the size for CAP 0, the next for CAP 1 etc.
If a size is not specified for a CAP, a default value of 40 is used. Specifying the CAP size optimizes the movement of volumes to and from the jukebox by filling the CAP to capacity for each move operation. When specifying CAP sizes, the specified numbers always replace any previous sizes in the database. Valid for DCSC-controlled jukeboxes only.
This qualifier specifies the robot control facility used to control the jukebox's robot. The valid keywords are:
Defines comments about the object in the record. If the text contains spaces, then it must be enclosed within quotation marks. The length of the description can range from 0 to 255 characters. To clear the existing description, specify "".
Places the jukebox in the disabled state. This prevents all drives in the jukebox from being selected and allocated for use. This takes effect immediately. However, any drives in use will continue to be used until they are deselected.
Places the drive in the enabled state. This allows drives in the jukebox to be selected and allocated for use. This takes effect immediately. This is the default.
Specifies the names of groups of nodes that share common access to this device. Normally, only one group is specified. The /REMOVE or /REPLACE qualifiers can be used to remove or replace objects in the list, rather than adding them by default. The /NOGROUPS qualifier removes all groups. If neither /NODES nor /GROUPS is specified on CREATE, the node from which the request was issued is used as the node name.
This qualifier allows you to specify an existing jukebox record to inherit attributes. MDMS supplies values for attributes you do not specify on creation. All attributes may be inherited except for the following:
This qualifier specifies the library identifier for a silo. Valid values are 1, 2, 3, 4, and the default is 1 when the jukebox is controlled by DCSC and 0 (not applicable) when controlled by MRD. Each MDMS jukebox maps to one Library Storage Module (LSM), and requires specification of the library, ACS and LSM identifiers.
This qualifier specifies the Library Storage Module (LSM) Identifier for the jukebox. The default value is zero. Each MDMS jukebox maps to one LSM, and requires specification of the library, ACS and LSM identifiers. Valid only for DCSC-controlled jukeboxes.
This qualifier specifies the location of the jukebox, which is used when moving volumes into and out of the jukebox. If not specified, or /NOLOCATION is specified, the default onsite location from the domain record is used as the jukebox location.
Specifies one or more nodes that can directly access the jukebox.
The /REMOVE or /REPLACE qualifiers can be used to remove or replace objects in the list, rather than adding them by default. The /NONODES qualifier removes all nodes.
If neither /NODES nor /GROUPS is specified on CREATE, the node from which the request was issued is used as the node name.
The /REMOVE qualifier works in conjunction with certain qualifiers that accept lists and removes specified attributes from them.
The /REPLACE qualifier works in conjunction with certain qualifiers that accept lists and replaces the existing attributes list with the specified attributes list. By default, list attributes are added to the existing list.
The /ROBOT qualifier defines the OpenVMS device name of the robot. Required for, and applicable to MRD-controlled jukeboxes only. Do not specify a node name in the robot name.
The /SHARED qualifier defines that the jukebox may be used by non-MDMS clients and that the jukebox is only partially managed. The default, /NOSHARED, indicates that all access to the jukebox is through MDMS.
The /SLOTS qualifier specifies the total number of slots in the entire jukebox. For any jukebox, either the slot count or topology must be specified. Valid for MRD-controlled jukeboxes only.
The /STATE qualifier specifies the usage state of the jukebox. This is normally set up by MDMS. The keyword values are:
This qualifier requires the right MDMS_SET_PROTECTED.
/TOPOLOGY=(TOWERS=(number[,...]), FACES=(number[,...]), -
LEVELS=(number[,...]), SLOTS=(number[,...]))
Specifies topology of jukebox, when a TL820-class jukebox is being used as a magazine.Valid for MRD-controlled jukeboxes only.
The topology specification allows OPCOM messages to move magazines to be specified with TOWER, FACE, LEVEL rather than slot range. The specification of topology is optional.
For each tower in the configuration, a corresponding entry must also be placed in FACES LEVELS and SLOTS that reflects the configuration of that tower.
The tower numbers start at zero and additional towers must be the next number in sequence (i.e. 0,1,2 etc.). Other specifications are absolute counts of the entity being specified for each tower (i.e. the total number of faces, levels and slots in each tower).
For example, for a three-tower jukebox, each tower having 8 faces, the first tower having two levels and the other two towers having three levels, and support of 11-slot bin-packs, the topology specification would be:
/TOPOLOGY=(TOWERS=(0,1,2), /FACES=(8,8,8), LEVELS=(2,3,3), SLOTS=(11,11,11)
The /USAGE=MAGAZINE qualifier specifies that the jukebox is configured for magazines, and that the movement of volumes may be performed using magazines. The /USAGE=NOMAGAZINE qualifier does not support magazine use. The default is NOMAGAZINE. You must specify /USAGE=MAGAZINE when defining the /TOPOLOGY attribute. Note that you can use the jukebox for non-magazine moves even when the usage is magazine, but the reverse is not true. Valid for MRD-controlled jukeboxes only.
$ MDMS CREATE JUKEBOX JUKE_1 /SLOT_COUNT=7 /ROBOT=$1$DUA512: -
/USAGE=MAGAZINE
This command creates a jukebox JUKE_1 with a slot range of 0-6 and controlled by robot $1$DUA512: and supports magazines. The control type is MRD by default, and the current node is used as the node name supporting the jukebox.
$ MDMS CREATE JUKEBOX JUKE_2 /SLOT_COUNT=140) -
/ROBOT=$1$DUA600 /USAGE=NOMAGAZINE /GROUPS=COOKIE
This command creates a jukebox JUKE_2 with a slot range of 0-139 and controlled by robot $1$DUA600 in group COOKIE. The control type is MRD by default.
$ MDMS CREATE JUKEBOX JUKE_3 /CONTROL=DCSC /LIBRARY=1 /ACS=0 /LSM=0, - CAP_SIZE=(20,30)
This command creates a jukebox JUKE_3 with a library number of 1, ACS ID of 0 and LSM ID of 0. In addition there are two CAPS with sizes of 20 for CAP 0, and 30 for CAP 1. The control type is DCSC meaning this is a silo, does not support magazines, and other default attribute values are supplied by MDMS.
$ MDMS CREATE JUKEBOX JUKE_4 /CONTROL=MRD /ROBOT=$1$DUA510: -
/TOPOLOGY=(TOWERS=(0,1),FACES=(8,8),LEVELS=(3,2),SLOTS=(11,11))
This command creates a multi-tower jukebox, controlled by MRD with robot name $1$DUA510: Its topology is: TOWER 0 with 8 faces, 3 levels and 11 slots; TOWER 1with 8 faces, 2 levels and 11 slots.
The MDMS CREATE LOCATION command creates a new location definition in the MDMS configuration database.
Equivalent STORAGE Command: None
The MDMS CREATE LOCATION command creates a new location definition in the MDMS configuration database. MDMS supplies attribute values you do not define on creation. Alternatively, they can be inherited from a named location object using the /INHERIT qualifier.
Defines comments about the object in the record. If the text contains spaces, then it must be enclosed within quotation marks. The length of the description can range from 0 to 255 characters. To clear the existing description, specify "".
This qualifier allows you to specify an existing location record to inherit default attributes. The default is that MDMS supplies the default values. All attributes may be inherited except for location name.
The /LOCATION qualifier allows you to specify a higher level location, thus creating a location hierarchy. If there is no higher location, specify /NOLOCATION.
Use a location hierarchy to allow selection of volumes or drives in compatible locations. One location is compatible with another if it has a common location in the hierarchy.
The /SPACES qualifier defines individual spaces for volumes or magazines at the location. Spaces are alphanumeric strings of up to 8 characters. The spaces can be specified as a range - only a single range is supported. When specifying a range, the first and last spaces in the range must have the same number of characters (as in the example), and there is a limit of 1000 spaces per location. The /NOSPACES qualifier removes all spaces.
The MDMS CREATE MAGAZINE command creates a new magazine definition in the MDMS configuration database.
Equivalent STORAGE Command: STORAGE ADD MAGAZINE
Specifies the name of the magazine. The maximum length of the magazine name is 31 characters.
The MDMS CREATE MAGAZINE command creates a new magazine definition in the MDMS configuration database. Magazines are used for two reasons:
The request requires MDMS_CREATE_ALL.
Several protected qualifiers also require MDMS_SET_PROTECTED since these attributes are normally managed by MDMS. You should not modify these attributes unless you are trying to recover from an abnormal situation.
The /JUKEBOX, /PLACEMENT, /POSITION and /START_SLOT are qualifiers that also require MDMS_SET_PROTECTED.
Defines comments about the object in the record. If the text contains spaces, then it must be enclosed within quotation marks. The length of the description can range from 0 to 255 characters. To clear the existing description, specify "".
This qualifier allows you to specify an existing magazine record to inherit default attributes. The default is that MDMS supplies values you do not specify. All attributes may be inherited except for the following:
The name of the jukebox from which the magazine will be selected. The maximum length of the jukebox name is 31 characters.
This qualifier requires the right MDMS_SET_PROTECTED.
/OFFSITE=([LOCATION=location][,[NO]DATE[=date]])
This qualifier specifies the date that the magazine is to be taken offsite and the offsite location. The location field is required when using the /OFFSITE qualifier if no location has been previously specified. The LOCATION keyword cannot be negated and if specified must point to a valid location object. Specify a VMS absolute or delta time in the date field. The NODATE keyword may be used to remove the date. This has the effect of disabling the schedule for the magazine, while retaining the location. To clear the offsite date and location, specify /NOOFFSITE.
/ONSITE=([LOCATION=location][,[NO]DATE[=date]])
This qualifier specifies the date that the magazine is to be brought back onsite and the onsite location. The location field is required when using the /ONSITE qualifier if no location has been previously specified. The LOCATION keyword cannot be negated and if specified must point to a valid location object. Specify a VMS absolute or delta time in the date field. The NODATE keyword may be used to remove the date. This has the effect of disabling the schedule for the magazine, while retaining the location. To clear the onsite date and location, specify /NOONSITE.
This qualifier defines the current placement of the magazine. This is normally managed by MDMS. The following options are available:
This qualifier requires the right MDMS_SET_PROTECTED.
The /POSITION qualifier specifies that the magazine is being created in a jukebox, and specifying the jukebox position that the magazine is being created.
The `tower, face and level' specification, represents the relative number of the tower, face and level, starting from 0. So for the absolute jukebox slot of zero, the corresponding position is (0,0,0). The next position in the jukebox would be (0,0,1) and so on, according to the topology defined for the jukebox.
This qualifier requires the right MDMS_SET_PROTECTED.
The /SLOT_COUNT qualifier specifies the number of slots in a magazine to store volumes.
This qualifier specifies the space(s) in a location in which the magazine is stored when not in a jukebox. Spaces are alphanumeric strings of up to 8 characters. The /NOSPACES qualifier removes all spaces.
This qualifier specifies the starting jukebox slot when the magazine is placed in a jukebox. This is normally set up by MDMS.
$ MDMS CREATE MAGAZINE MYMAG01 /SLOT_COUNT=7 -
/ONSITE=(LOCATION=SHELF1) /SPACE=2
This command creates a magazine called MYMAG01 with 7 slots, which is stored in location space 2 in location shelf 1 when not in a jukebox.
$ MDMS CREATE MAGAZINE MAG002 /SLOT_COUNT=32 /SPACES=(SA001-SA032)-
/ONSITE=(LOCATION=HEADQUARTERS, DATE=01-JAN-2001) -
/OFFSITE=(LOCATION=DPS, DATE=01-JAN-2000) /JUKEBOX=JUKE_1
This command creates a magazine MAG002, with 32 slots, which is stored in onsite location HEADQUARTERS in spaces SA001-SA032, due to be moved offsite on 01-Jan-2001 to location DPS, and back onsite on 01-Jan-2001. When in a jukebox, the magazine resides in jukebox JUKE_1
$ MDMS CREATE MAGAZINE MAG003 /SLOT_COUNT=32 /SPACES=SPC001 -
/JUKE=JUKE_1 /POSITION=(0,1,2)
This command creates a magazine MAG003, with 32 slots, which is stored in space SPC001. When in a jukebox, the magazine resides in jukebox JUKE_1 in the position:
tower 0, face 1, level 2
Note that jukebox and position should not normally be specified - rather, these are set up when moving the magazine into the jukebox with a MOVE MAGAZINE command.
The MDMS CREATE MEDIA_TYPE command creates a new media type definition in the MDMS configuration database. Equivalent STORAGE Command: None
Specifies the name of the media type. The maximum length of the media type name is 31 characters.
The MDMS CREATE MEDIA_TYPE command creates a new media type definition in the MDMS configuration database. A media type definition consists of a required density, and optional compaction length and capacity, if applicable.
The /CAPACITY qualifier specifies the capacity in megabytes of the tape. This is used by some MDMS clients to estimate end-of-tape conditions. By default, capacity is set to zero.
The /COMPACTION qualifier specifies that the media type should use compaction when writing to tape. This is the default. If you do not wish to use compaction, then specify
/NOCOMPACTION.
Specifies a density string between 1 and 31 characters in length that the media type supports. The density qualifier is used by certain MDMS applications for 9-track tapes. Valid values currently supported are:
If future devices support a density specification, the command allows you to enter a valid string for density. Note that the COMP keyword for compaction should be specified in the
/COMPACTION attribute, not density.
Defines comments about the media type. If the text contains spaces, then it must be enclosed within quotation marks. The length of the description is can range from 0 to 255 characters. Specify to clear the description.
This qualifier allows you to specify an existing media type record to inherit default attributes. The default is that MDMS supplies values you do not specify on creation. All attributes may be inherited except media type name.
The /LENGTH qualifier specifies the length of a 9-track magnetic tape, and is expressed in feet. By default, length is set to zero.
$ MDMS CREATE MEDIA_TYPE TK85K_COMP /DENSITY=TK85 /COMPACTION
This command creates a new media type called TK85K_COMP which supports the TK85 density with compaction.
$ MDMS CREATE MEDIA_TYPE TAPE_800 /DENSITY=800 /LENGTH=2400
This command creates a new media type called TAPE_800, a 9-track media type with 800 bpi density and a length of 2400 feet.
$ MDMS CREATE MEDIA_TYPE TAPE_1600 /INHERIT=TAPE_800 /DENSITY=1600
This command creates a new media type called TAPE_1600, a 9-track media type with 1600 bpi density and a length of 2400 feet. (inherited from media type TAPE_800).
The MDMS CREATE NODE command creates a new node definition in the MDMS node configuration database.
Equivalent STORAGE Command: None
Specifies the name of the node. The maximum length of the node name is 31 characters - do not append colons to the node name. The node name should be the DECnet (Phase IV) node name (i.e. SYS$NODE) if DECnet (Phase IV) is supported on the node - otherwise it should be a unique name chosen by the MDMS administrator. If DECnet-Plus (Phase V) and/or TCP/IP are supported, the appropriate full names should be stored as attributes of the node. Do not use the node name to specify the full names.
The MDMS CREATE NODE command creates a new node definition in the MDMS configuration database. A node record must exist for each node that can act as a client to the database server. In addition, a node record must exist for each node capable of being a database server.
When creating a new object record, default attributes are supplied by MDMS. Alternatively, they can be inherited from a specified node using the /INHERIT qualifier.
The /ADD, /REMOVE and /REPLACE qualifiers are mutually exclusive. If no qualifier is specified, attributes are added to list attributes by default.
The /ADD qualifier works in conjunction with certain qualifiers that accept lists and adds specified attributes.This is the default while specifying list attributes.
The /DATABASE_SERVER qualifier means the node can be a database server, supporting fail-over operations. To be a database server, the node must have direct access to the MDMS database files.
In addition, this node name should be added to the definition of the logical name MDMS$DATABASE_SERVERS in SYS$STARTUP:MDMS$SYSTARTUP.COM on all nodes in the domain
/DECNET_PLUS_FULLNAME=node_fullname
This qualifier allows you to specify the DECnet-Plus (Phase V) full name for a node. This full name may be up to 255 characters. If this node has a DECnet-Plus name defined by logical name "SYS$NODE_FULLNAME" then the DECNET_PLUS_FULLNAME has to be defined for this node and has to exactly match the DECnet-Plus (Phase V) name.
The DECNET_PLUS_FULLNAME has to be defined for this node to be fully enabled even though the DECnet transport has been disabled. The full name can be specified in upper or lower case.
Defines comments about the node. If the text contains spaces, then it must be enclosed within quotation marks. The length of the description can range from 0 to 255 characters. Specify "" to clear the description.
Places the node in the disabled state. This prevents the node from participating in the MDMS domain as either a server or a client. This takes effect immediately.
Places the node in the enabled state. This allows the node to participate in MDMS operations. This takes effect immediately. This is the default.
This qualifier allows you to specify an existing node record to inherit attributes. The default is that MDMS supplies attribute values you do not supply on creation. All attributes may be inherited except for:
This qualifier specifies the location of the node, which is used when allocating volumes and drives. If not specified, or /NOLOCATION is specified, the default onsite location from the domain record is used as the node location.
The /OPCOM qualifier adds the specified classes used for notifying operators. All OPCOM for devices on the node are sent to all specified classes on the node. The /REMOVE or /REPLACE qualifiers can be used to remove or replace classes in the list, rather than adding them by default. Specify /NOOPCOM to disable OPCOM notification. By default, the node acquires OPCOM classes from the domain record. The following classes are valid:
The /REMOVE qualifier works in conjunction with certain qualifiers that accept lists and removes specified attributes from them.
The /REPLACE qualifier works in conjunction with certain qualifiers that accept lists and replaces the existing attributes list with the specified attributes list. By default, list attributes are added to the existing list.
/TCPIP_FULLNAME=node_fullname[:low_port-high_port]
This qualifier allows you to specify the TCP/IP full name for a node. The full name may be up to 255 characters.
If this node has a TCP/IP name defined by logical name "*INET_HOST" the TCPIP_FULLNAME has to be defined and has to exactly match the full IP name as "<INET_HOST>.<INET_DOMAIN>".
For INET_DOMAIN see logical name "*INET_DOMAIN".
The TCPIP_FULLNAME has to be defined in order for this node to be fully enabled even though the TCPIP transport has been enabled. The fullname can be specified in upper or lower case.
The low_port and high_port numbers specify the range of TCP/IP port numbers used by the server to listen for incoming requests. The default is 2501-2510. If this conflicts with other applications, a new range above 1023 can be specified. The range should contain at least 10 port numbers for the MDMS server to select one at a time.
Note that the MDMS GUI requires TCP/IP running on all GUI nodes, and on the MDMS server nodes to which the GUI may connect.
Specifies the network transports to be used, as a prioritized ordered list.
The /REMOVE or /REPLACE qualifiers can be used to remove or replace objects in the list, rather than adding them by default. Enter one or more of:
Setting a new transport will automatically start the listener for this transport on the database server node. Likewise, removing a transport will take place within 10 seconds on the database server node. For client nodes, transport changes will take place the next time network connections time out (usually within 10 minutes). If the change needs to take place immediately, the client node server process must be restarted.
The node name and/or the node full names have to be set accordingly for a transport to work correctly
1. MDMS CREATE NODE TABLES /LOCATION=COMPUTER_LAB_1 -
/TRANSPORT=(DECNET,TCPIP) /OPCOM=(CENTRAL,TAPES) -
/TCPIP_FULLNAME=TABLES.CXO.DEC.COM
This command creates a new node definition named "TABLES" with a location, transport protocols and OPCOM classes. The node supports DECnet (node name TABLES) and TCP/IP with a fullname of TABLES.CXO.DEC.COM.
2. MDMS CREATE NODE CHAIRS /INHERIT=TABLES -
/DECNET_PLUS_FULLNAME=DEC:CHAIRS.CXO.DEC.COM -
/TCPIP_FULLNAME=CHAIRS.CXO.DEC.COM:3000-3050
This command creates a new node named CHAIRS, which inherits location, OPCOM classes and transport definitions from node TABLES, with specified DECnet-Plus and TCPIP full names. The TCP/IP connections may be received over ports 3000 - 3050.
The MDMS CREATE POOL command creates a new pool definition in the MDMS configuration database.
Equivalent STORAGE Command: None
The MDMS CREATE POOL command creates a new pool definition in the MDMS pool configuration database. A pool definition consists of a list of authorized users, and users for whom the pool is the default pool. If a user is listed in either list, he/she is authorized for the pool.
The /ADD, /REMOVE and /REPLACE qualifiers are mutually exclusive. If no qualifier is specified, attributes are added to list attributes by default.
The /ADD qualifier works in conjunction with certain qualifiers that accept lists and adds specified attributes. This is the default while specifying list attributes.
/AUTHORIZED_USERS=(node/group_name::username[,...])
Specifies one or more distinct users to the pool specified by node or group name and user name. Only authorized or default users can allocate volumes belonging to the pool.
The /REMOVE or /REPLACE qualifiers can be used to remove or replace users in the list, rather than adding them by default.
/DEFAULT_USERS=(node/group_name::username[,...])
Specifies one or more distinct users to the pool as the users default pool. Only authorized or default users can allocate volumes belonging to the pool. The /REMOVE or /REPLACE qualifiers can be used to remove or replace users in the list, rather than adding them by default.
A particular node/group::user combination can only be defined with the /DEFAULT qualifier for one pool.
Defines comments about the pool. If the text contains spaces, then it must be enclosed within quotation marks. The length of the description can range from 0 to 255 characters. Specify "" to clear the description.
This qualifier allows you to specify an existing pool record to inherit attributes. The default is that MDMS supplies values you do not supply on creation. All attributes except pool name may be inherited.
The /REMOVE qualifier works in conjunction with certain qualifiers that accept lists and removes specified attributes from them.
The /REPLACE qualifier works in conjunction with certain qualifiers that accept lists and replaces the existing attributes list with the specified attributes list. By default, list attributes are added to the existing list.
$ MDMS CREATE POOL TEST_POOL/AUTHORIZE=COOKIE::ABS
This command creates a pool called TEST_POOL with one authorized user.
$ MDMS CREATE POOL JIMS_POOL /DEFAULT=(OREO::JIM, CRUMBS::JIM,
DSORDS::JIM) /ADD
This command adds default users to pool JIMS_POOL. The names before the double colons are a mixture of node names and group names.
The MDMS CREATE VOLUME command creates a new volume definition in the MDMS volume database.
Equivalent STORAGE Command: STORAGE ADD VOLUME
Specifies the volume ID of the volume to be added. The volume ID is the external label for the volume. The maximum length of the volume ID is 6 characters. Alternatively, a volume range, separated by a dash, may be specified. A volume range is a numeric range for up to the last three characters of the volume ID. Example ranges are (ABC001-ABC250), (ABC120-ABC125).
There is a limit of 1000 volumes in a valid range.
Either a volume ID or a volume range must be entered in the command, unless the /VISION qualifier is used to automatically determine volume identifiers in a jukebox.
The MDMS CREATE VOLUME command creates a new volume definition in the MDMS volume database. The external label will be used to track the volume in the database. The external label must match the on-tape internal volume label when the volume is initialized.
The request requires MDMS_CREATE_ALL or MDMS_CREATE_POOL.
If the user is creating a volume in a named pool to which he is authorized, MDMS_CREATE_POOL is sufficient. The /POOL qualifier must be specified. Otherwise the request requires MDMS_CREATE_ALL.
Several of the qualifiers are designated protected, and require the right MDMS_SET_PROTECTED.
These fields are normally set up by MDMS, and modification is not recommended since you could put the database into an inconsistent state.
The /VISION qualifier is incompatible with the volume_id parameter.
The /ADD, /REMOVE and /REPLACE qualifiers are mutually exclusive. If no qualifier is specified, attributes are added to list attributes by default.
Defines the account name of the volume. The account name may be up to 31 characters. If it contains spaces, it must be enclosed in quotation marks. Specify " " to clear the account name.
This attribute is protected by MDMS_SET_PROTECTED.
The /ADD qualifier works in conjunction with certain qualifiers that accept lists and adds specified attributes. This is the default when specifying list attributes.
Specifies the date the volume was allocated. Normally this is set by MDMS. Specify a VMS absolute date and time. Specify /NOALLOCATED_DATE to clear the allocated date.
This qualifier requires the right MDMS_SET_PROTECTED.
The /AVAILABLE qualifier moves a volume from the UNAVAILABLE state to the state it was previously in prior to the UNAVAILABLE state. The volume may then be moved into the TRANSITION or FREE state if the scratch date and/or transition time have expired.
Specifies the block factor the volume. The default is a block factor of zero.
The media manufacturer. The maximum length of the brand name is 31 characters. If it contains spaces it must be contained in quotation marks. Specify "" to clear the description.
This qualifier specifies the date the volume was last cleaned and is entered as a VMS absolute time. Specify /NOCLEANED_DATE to clear the cleaned date.
The date the volume is created. This attribute is set by MDMS, but may be overridden if necessary.
This qualifier requires the right MDMS_SET_PROTECTED.
This qualifier specifies the actual deallocation date for the volume. Specify a VMS absolute time. This date is normally set by MDMS.
This qualifier requires the right MDMS_SET_PROTECTED.
Comments about the volume. If the text contains spaces, then it must be enclosed within quotation marks. The length of the description can range from 0 to 255 characters. Specify "" to clear the description.
This qualifier requires the right MDMS_SET_PROTECTED.
Specifies the drive that the volume currently resides in or last resided in. This is normally set up by MDMS. To clear the drive, specify /NODRIVE.
This qualifier requires the right MDMS_SET_PROTECTED.
Specifies the format of the tape. Possible values are:
Specifies the date the volume was last freed (in the FREE state) or is due to be freed. Specify a VMS absolute date and time. This is normally set up by MDMS. To clear the freed date, specify /NOFREED_DATE.
This qualifier requires the right MDMS_SET_PROTECTED.
This qualifier allows you to specify an existing volume record to inherit default attributes. The default is that MDMS supplies values you do not supply on creation. All attributes may be inherited with the exception of the following protected fields:
Specifies the date the volume was last initialized. Specify a VMS absolute date and time. This is normally set up by MDMS. To clear the initialized date,
specify /NOINITIALIZED_DATE.
This qualifier requires the right MDMS_SET_PROTECTED.
This qualifier allows you to set the number of I/O errors on the volume. The default value is zero.
This qualifier allows you to specify the last job that accessed the volume. The job name can be from 0 to 31 characters. If it contains spaces, it must enclosed in quotation marks. Specify "" to clear the job name.
This qualifier requires the right MDMS_SET_PROTECTED.
This qualifier allows you to specify that the volume is currently residing or last resided in the specified jukebox. The maximum length of a jukebox name is 31 characters. This is normally set up by MDMS. To clear the jukebox name,
specify /NOJUKEBOX.
This qualifier requires the right MDMS_SET_PROTECTED.
Specifies the date the volume was last accessed. Specify a VMS absolute date and time. This is normally set up by MDMS. To clear the last access date,
specify /NOLAST_ACCESS_DATE.
This qualifier requires the right MDMS_SET_PROTECTED.
Specifies the magazine name if the volume resides in a magazine. This is normally set up by MDMS. To clear the magazine name, specify /NOMAGAZINE.
This qualifier requires the right MDMS_SET_PROTECTED.
/MEDIA_TYPES=(media_type[,...])
The media type qualifier allows you to add the media type(s) that the volume can support. Multiple media types are supported prior to the volume being initialized. After initialization, a volume can only support one media type.
The /REMOVE or /REPLACE qualifiers can be used to remove or replace objects in the list, rather than adding them by default. To specify the volume supports no media types, enter
/NOMEDIA_TYPES. If a volume is created with no media types, the default media type from the domain record is used.
Specifies the number of times the volume has been loaded and mounted. Normally set up by MDMS. The default mount count is zero.
/OFFSITE=([LOCATION=location][, [NO]DATE[=date]])
This qualifier specifies the date that the volume is to be taken offsite and the offsite location. The location field is required when using the /OFFSITE qualifier if no location has been previously specified. The LOCATION keyword cannot be negated and if specified must point to a valid location object. Specify a VMS absolute or delta time in the date field.
The NODATE keyword may be used to remove the date. This has the effect of disabling the schedule for the volume, while retaining the location. To clear the offsite date and location, specify /NOOFFSITE. If a volume is under magazine control, the /OFFSITE qualifier is not allowed. The volume inherits these values from the magazine object. If /MAGAZINE is used on the SET VOLUME command when an existing /OFFSITE location and date are set, the values are cleared.
/ONSITE=([LOCATION=location][, [NO]DATE=date]])
This qualifier specifies the date that the volume is to be brought back onsite and the onsite location. The location field is required when using the /ONSITE qualifier if no location has been previously specified. The LOCATION keyword cannot be negated and if specified must point to a valid location object. Specify a VMS absolute or delta time in the date field. The NODATE keyword may be used to remove the date. This has the effect of disabling the schedule for the volume, while retaining the location. To clear the onsite date and location, specify /NOONSITE. If a volume is under magazine control, the /ONSITE qualifier is not allowed. The volume inherits these values from the magazine object. If /MAGAZINE is used on the SET VOLUME command when an existing /ONSITE location and date are set, the values are cleared.
This qualifier specifies the owner of a volume. The owner field must be a UIC in the format [USER] or [group, user]. This is normally set up by MDMS on allocate volume. To clear the owner field, specify /NOOWNER.
This qualifier requires the right MDMS_SET_PROTECTED.
This qualifier defines the current placement of the volume. This is normally managed by MDMS. The following options are available:
If a magazine name is specified on the /MAGAZINE qualifier, the volume placement can be in one of three states:
During a MOVE, LOAD or UNLOAD, a volume's placement may be set to MOVING indicating that the volume is being moved. If a volume is in a magazine, it is set to MOVING when the volume is being loaded or unloaded to/from a drive.
This qualifier requires the right MDMS_SET_PROTECTED.
The pool in which the volume belongs. The maximum length of the pool name is 31 characters. Spaces are not allowed in the pool name. The privilege MDMS_CREATE_ALL is required if no pool name is specified on CREATE.
This qualifier specifies whether the volume has been initialized before creation. If /PREINITIALIZED is specified, the volume is placed in the FREE state rather than the UNINITIALIZED state.
The protection code for the volume. Use the standard OpenVMS protection code format.
The date when the volume was purchased. The date should be specified as an OpenVMS absolute time. Specify /NOPURHCASED_DATE to clear the purchased date.
This qualifier specifies the record length used on the volume. The default record length is zero.
This qualifier puts the volume into the FREE state from the TRANSITION state. It is not valid to release an allocated volume.
The /REMOVE qualifier works in conjunction with certain qualifiers that accept lists, and removes specified attributes from them.
The /REPLACE qualifier works in conjunction with certain qualifiers that accept lists, and replaces the existing attributes list with the specified attributes list. By default, list attributes are added to the existing list.
This qualifier puts the volume that is in the FREE state or TRANSITION state back into the ALLOCATED state with the former owner as the current owner
The /SCRATCH_DATE qualifier specifies the planned date to return the volume from the ALLOCATED state to either the TRANSITION state or the FREE state.
Specify /NOSCRATCH_DATE if the volume should not automatically transition from the allocated state.
When a volume ID is specified on the create, this qualifier specifies the jukebox or magazine slot that the volume currently resides in. Specify a number in the range of the jukebox or magazine. This is normally set up by MDMS. If the volume does not currently reside in a jukebox or magazine slot, specify /NOSLOTS.
If no volume ID is specified, or if a volume range is specified, a slot range can be included, so that each volume in the range will get placed in individual slots in order. For a single volume, a single slot should be specified.
This qualifier requires the right MDMS_SET_PROTECTED.
When a volume ID is specified on the create, this qualifier specifies the non-jukebox space in the specified location that the volume resides in. If the volume does not reside in a location space, specify /NOSPACES.
Use a space range only when creating multiple volumes - each volume will be placed in individual spaces in order. For a single volume, a single space should be specified.
This qualifier allows you to modify the state of the volume. This is normally set up by MDMS and manual modification is not recommended.
This qualifier requires the right MDMS_SET_PROTECTED.
This qualifier allows you to specify the number of times the volume has been cleaned. The default is zero.
The /TRANSITION_TIME qualifier specifies that the volume enters the TRANSITION state when the scratch date is reached, and is to stay in the TRANSITION state for the specified delta time. When the TRANSITION time has expired, the volume enters the FREE state.
The /NOTRANSITION_TIME qualifier specifies that the volume enters the FREE state directly at the scratch date.
Puts the volume in the UNAVAILABLE state. The previous state is retained for when the volume is made AVAILABLE again.
Specifies the user for the volume. The username can be from 1-31 characters, and must reflect an authorized VMS username. To clear the username, enter /NOUSER.
This qualifier requires the right MDMS_SET_PROTECTED.
This qualifier specifies that volume IDs are to be read using a vision system in a suitably-equipped jukebox. No volume ID or volume range should be specified when using this qualifier. Valid only on CREATE VOLUME. Valid only for MRD jukeboxes equipped with a VISION system.
$ MDMS CREATE VOLUME ABC001 /MEDIA=TK85K /ONSITE=(LOCATION=SHELF2) /SPACES=1
This command creates a new volume definition for volume ABC001, of media type TK85K, which is stored in the location SHELF2 space 1.
$ MDMS CREATE VOLUME /INHERIT=DEF000 /JUKEBOX=JUKE_1 /SLOTS=(0-50) - /VISION
This command creates volume records for the newly imported volumes in slots 0-50 of the jukebox JUKE_1, and the volume labels are generated using the vision system, and other attributes are inherited from template volume DEF000.
$ MDMS CREATE VOLUME HS0001-HS0007 /INHERIT=TK85MG /MAGAZINE=TX877A -
/SLOTS=(0-6)
This command creates seven volume records HS0001 HS0007, which are stored in magazine TX877A in slots 0 6 respectively, and other attributes are inherited from template volume TK85MG.
The MDMS DEALLOCATE DRIVE command deallocates a drive.
Equivalent STORAGE Command: None
Specifies the drive name to be deallocated. Specify a drive name or the logical name previously defined in the allocate. The maximum length of the drive name or logical name is 31 characters.
The MDMS DEALLOCATE DRIVE command deallocates a drive. If a logical name is supplied for the drive_name parameter, the logical name will be deassigned.
The MDMS DEALLOCATE VOLUME command puts an allocated volume in either the transition state or the free state, depending on volume attributes, which can be overridden in the command.
Equivalent STORAGE Command: STORAGE DEALLOCATE
Specifies the volume ID of the volume to deallocate. The maximum length of a volume ID is 6 characters. This parameter is required except when the /SCHEDULE qualifier is given, in which case it must be omitted.
The MDMS DEALLOCATE VOLUME command puts an allocated volume in either the TRANSITION state or the FREE state, depending on volume attributes, which can be overridden in the command.
In addition, this command will update the state of the volume to FREE if the freed date (deallocated date plus transition time) has expired. If you deallocate a volume set, the volume set remains bound until the volumes enter the FREE state.
The request requires MDMS_DEALLOCATE_ALL or MDMS_DEALLOCATE_OWN.
If the user is deallocating a volume owned by him, MDMS_DEALLOCATE_OWN is sufficient. If the user is deallocating on behalf of another user with the /USER_NAME qualifier, then the request requires MDMS_DEALLOCATE_ALL.
If the /STATE or /TRANSITION_TIME qualifiers are entered, the user needs MDMS_SET_ALL if the /USER_NAME qualifier is specified, or MDMS_SET_OWN or MDMS_SET_POOL.
The /SCHEDULE qualifier selects volumes whose scratch dates or freed dates have expired, and moves them into the TRANSITION state or FREE state respectively. No volume_id parameter is allowed when this qualifier is given.
Specifies the state in which to place the deallocated volume. The valid state values are FREE and TRANSITION.
This qualifier requires the right MDMS_SET_*
Modifies the amount of time, as a delta time, that a volume will remain in the TRANSITION state before moving to the FREE state. Use the standard OpenVMS delta time format to specify a delta time for the transition duration.
Specify /NOTRANSITION_TIME to put the volume immediately into the FREE state. If not specified, the existing transition time in the volume record is used.
This qualifier requires the right MDMS_SET_*
Deallocate a volume which is owned by the specified user. The maximum length of the username is 31 characters.
This qualifier requires the right MDMS_DEALLOCATE_ALL
Indicates that the entire volume set which contains the volume ID is to be deallocated. The default of /VOLSET unbinds and then deallocates all volumes in the volume set.
If /NOVOLSET is specified, the specified volume is unbound from the volume set and deallocated. This qualifier is ignored if the volume is not in a set. You cannot deallocate the first volume in a volume set.
$ MDMS DEALLOCATE VOLUME VOL008 /NOVOLSET /STATE=FREE
This command deallocates volume VOL008 for the current user and places the volume in the FREE state.
$ MDMS DEALLOCATE VOLUME ACF342 /USER_NAME=SMITH
This command deallocates volume ACF342 which was allocated to user SMITH.
$ MDMS DEALLOCATE VOLUME VOL002 /VOLSET
This command deallocates all volumes in the set that contains volume VOL002 for the current user. The volumes are also unbound from the volume set.
$ MDMS DEALLOCATE VOLUME VOL3 /NOVOLSET
A volume set contains volumes VOL1, VOL2, VOL3, VOL4, VOL5. This command deallocates volume VOL2 for the current user and leaves two volume sets: VOL1, VOL2 and VOL4, VOL5.
$ MDMS DEALLOCATE VOLUME/SCHEDULE
Deallocates all volumes whose scratch date has expired. Also, moves volumes into the FREE state if the freed date has expired.
The MDMS DELETE DRIVE command deletes a specified drive definition from the MDMS configuration database. The drive must be deallocated prior to being deleted.
The MDMS DELETE GROUP command deletes a specified group definition from the MDMS configuration database.
The MDMS DELETE JUKEBOX command deletes a specified jukebox definition from the MDMS configuration database.
Equivalent STORAGE Command: None
Specifies the name of the jukebox. The maximum length of the jukebox name is 31 characters.
The MDMS DELETE JUKEBOX command deletes a specified jukebox definition from the MDMS configuration database. Before deleting a jukebox, it is highly recommended that all drives defined as being in the jukebox are also deleted (or modified), and volumes and magazines are moved out of the jukebox.
The MDMS DELETE LOCATION command deletes a specified location definition from the MDMS configuration database.
The MDMS DELETE MAGAZINE command deletes a specified drive magazine from the MDMS configuration database.
Equivalent STORAGE Command: STORAGE REMOVE MAGAZINE
Specifies the name of the magazine. The maximum length of the magazine name is 31 characters.
The MDMS DELETE MEDIA_TYPE command deletes a specified media type definition from the MDMS configuration database.
Equivalent STORAGE Command: None
Specifies the name of the media type. The maximum length of the media type is 31 characters.
The MDMS DELETE NODE command deletes a specified node definition from the MDMS configuration database.
The MDMS DELETE POOL command deletes a specified pool definition from the MDMS configuration database.
Equivalent STORAGE Command: None
Specifies the name of the volume pool. The maximum length of the pool name is 31 characters.
The MDMS DELETE VOLUME command deletes a specified volume definition from the MDMS volume database.
Equivalent STORAGE Command: STORAGE REMOVE VOLUME
Specifies the name of the volume. The maximum length of a volume ID is 6 characters. Alternatively, a volume range, separated by a dash, may be specified. A volume range is a numeric range for up to the last three characters of the volume ID. Example ranges are (ABC001-ABC250), (ABC120-ABC125).
The MDMS DELETE VOLUME command deletes a specified volume definition from the MDMS volume database. Volumes must be in the UNINITIALIZED or FREE states prior to being deleted.
The MDMS INITIALIZE VOLUME command initializes a volume or a range of volumes by writing the volume ID to tape as the tape label.
Equivalent STORAGE Command: None
Specifies the name(s) of the volume(s) to initialize. The maximum length of a volume ID is 6 characters. Alternatively, a volume range, separated by a dash, may be specified. A volume range is a numeric range for up to the last three characters of the volume ID. Example ranges are (ABC001-ABC250), (ABC120-ABC125). There is a maximum of 1000 volumes in a range.
This parameter is required except when /JUKEBOX and /SLOTS are specified.
The /JUKEBOX and /SLOTS option is valid only for MRD-controlled jukeboxes equipped with a vision system. For all other jukeboxes, the volume_id parameter is required.
The MDMS INITIALIZE VOLUME command initializes a volume or a range of volumes by writing the volume ID to tape as the tape label. The volume records must be created prior to the initialization. In addition, the volumes must be in the FREE or UNITIALIZED states in order to be initialized.
If the volume(s) are contained in a jukebox, MDMS automatically loads and unloads the volumes. Otherwise, operator assistance is required.
In order to initialize volumes, the MDMS database server allocates a free drive that can handle the volumes. All volumes in a single command must support the specified media type (or the media type already in the volume record). Do not allocate a drive or load a volume for the initialization - this must be done by MDMS.
Each initialize volume command utilizes a single tape drive for all volumes. To utilize multiple drives, issue multiple initialize volume commands specifying a different volume or slot range, and use the /NOWAIT qualifier.
The request requires MDMS_INITIALIZE_ALL or MDMS_INITIALIZE_POOL.
If the user is initializing a volume that is in a pool to which he is authorized, MDMS_INITIALIZE_POOL is sufficient. All other initializations require MDMS_INITIALIZE_ALL.
The /JUKEBOX and /SLOTS qualifiers must be used together, and are incompatible with the volume_id parameter.
The default /ASSIST qualifier is used to output an operator message if the volume requires operator intervention. You can use /ASSIST even if no assistance is needed - MDMS will perform the operation automatically if it can.
If you specify /NOASSIST and assistance is needed, the operation fails.
This qualifier requires the right MDMS_ASSIST
Indicates the volumes to be initialized are in the specified jukebox. A slot range should also be specified with this qualifier. Valid only for MRD jukeboxes equipped with a vision system.
Modifies the volume record to support only this media type. The volume must already support this media type, but may support others as well. After the initialization, the other media types are removed.
The /OVERWRITE qualifier allows initialization if the requested volume label is different from the current label, and the volume has already been initialized and contains data. The default
/NOOVERWRITE qualifier indicates that the volume should not be initialized if the label does not match and the volume contains data. Under no circumstances will the volume be initialized if the volume (according to the current label) is allocated or in the transition state.
Specifies the name of the symbol to receive the operator's reply when operator intervention is needed. The symbol will contain the operator reply to the DCL REPLY/TO or DCL REPLY
/ABORT commands.
Specifies the slots containing volumes to initialize, when used with the /JUKEBOX qualifier.
Valid only for MRD jukeboxes equipped with a vision system.
The /NOWAIT qualifier returns an informational message indicating that the initialize is being queued. The /WAIT qualifier causes the MDMS INITIALIZE VOLUME command to wait until the initialization is complete.
$ MDMS INITIALIZE VOLUME WOR001 /MEDIA_TYPE=TK85K
This command loads, initializes and unloads volume WOR001 and modifies the volume records to set media type TK85K only.
$ MDMS INITIALIZE VOLUME/JUKEBOX=JUKE_1/SLOTS=(0-10)/OVERWRITE
This command loads, initializes and unloads the volumes contained in slots 0-10 of jukebox JUKE_1, and allows initialization even if the tapes have already been written.
$ MDMS INITIALIZE VOLUME ABC001-ABC050
This command loads, initializes and unloads all 50 volumes in the range ABC001 to ABC050
The MDMS INVENTORY JUKEBOX command verifies the contents of a jukebox. This command is used for both MRD and DCSC controlled jukeboxes.
Equivalent STORAGE Command: STORAGE INVENTORY JUKEBOX and STORAGE INVENTORY ACS
Specifies the name of the jukebox. The maximum length of the jukebox name is 31 characters.
The MDMS INVENTORY JUKEBOX command verifies the contents of a jukebox. This command is used for both MRD and DCSC controlled jukeboxes.
For DCSC controlled jukeboxes:
/SLOTS and /VOLUME_RANGE are mutually exclusive.
/SLOTS is unsupported for DCSC jukeboxes - /VOLUME_RANGE is required
Specifies that any volume that is found that is not defined is created using either the /INHERIT, and/or /MEDIA_TYPES qualifier.
When adding volumes this qualifier specifies, a volume_id from which to inherit attributes. The same attributes can be inherited as for the CREATE VOLUME command.
When adding volumes, this qualifier specifies the media type to be used for the volume records.
Defines the action to be taken when a volume is missing in the jukebox, when it was defined to be either in a drive or slot in the jukebox. The allowable actions are:
When creating volumes, the volumes are placed in the FREE state if /PREINITIALZED is specified. The default is to place them in the UNINITIALIZED state.
The slots or range of slots to inventory within the jukebox.
Specifies whether the inventory should be performed with the vision system on jukeboxes so equipped. If /NOVISION is specified, inventory is performed by loading and mounting the volumes. Applicable to MRD jukeboxes equipped with a VISION system only.
/VOLUME_RANGE= (start_id-end_id)
Specifies the volume range to inventory. A volume range is a numeric range for up to the last three characters of the volume ID. Example ranges are (ABC001-ABC250), (ABC120-ABC125).
The /NOWAIT qualifier returns an informational message indicating that the inventory is being queued. The /WAIT qualifier causes the MDMS INVENTORY JUKEBOX command to wait until the inventory is complete.
$ MDMS INVENTORY JUKEBOX TESTJUKE /CREATE /MEDIA_TYPE=TK85K -
/NOWAIT
This command inventories the entire jukebox TESTJUKE. Any volumes not in the MDMS volume database will be created with a media type of TK85K. The command prompt is returned after the inventory is queued.
$ MDMS INVENTORY JUKEBOX TESTJUKE /CREATE /MEDIA_TYPE=TK85K -
/SLOTS=(0-9)
This command inventories the first 10 slots of jukebox TESTJUKE. Any volumes not in the MDMS volume database will be created with a media type of TK85K.
$ MDMS INVENTORY JUKEBOX SILO_JUKE /VOLUME_RANGE=(SQ0800-SQ0900) -
/MISSING=MOVE /CREATE
This command verifies that volumes SQ0800 through SQ0900 exist in the StorageTek silo. Any volumes found in the silo, but not in the MDMS volume database will be created, with default values. Any volumes found in the MDMS database but not in the silo will be marked in the non-jukebox location defined for the volume.
The MDMS LOAD DRIVE command loads a volume into the specified drive.
Equivalent STORAGE Command: None
Specifies the name of the drive to be loaded.
Users can specify a drive name, or a logical name. The maximum length of the drive name or logical name is 31 characters.
The MDMS LOAD DRIVE command loads a volume into the specified drive. The command is used primarily for scratch loads when the volume ID is not important - only that a FREE volume is loaded into the drive. The volume may or may not already be created in the MDMS volume database. If it is not created, it may be added using the attributes using the /INHERIT or
/MEDIA_TYPE qualifiers.
The request requires MDMS_LOAD_ALL or MDMS_LOAD_SCRATCH.
MDMS_ASSIST is also required unless /NOASSIST is specified.
The /CREATE qualifier requires MDMS_CREATE_POOL if the /POOL qualifier is specified and the user is authorized to the pool. All other uses of the /CREATE qualifier require MDMS_CREATE_ALL.
The default /ASSIST qualifier is used to output an operator message if the volume requires operator intervention. You can use /ASSIST even if no assistance is needed - MDMS will perform the operation automatically if it can. If you specify
/NOASSIST and assistance is needed, the operation fails.
This qualifier requires the right MDMS_ASSIST
This qualifier specifies that a volume that is not in the MDMS volume database is added to the database. You can also use the /INHERIT or /MEDIA_TYPE qualifiers to specify the volume's attributes.
This qualifier requires the right MDMS_CREATE_*
This qualifier allows you to specify an existing volume record to inherit default attributes. The default is that MDMS supplies attribute values you do not on creation.
Specifies the media type assigned to a volume being created with the /CREATE qualifier. The media type must be supported by the drive.
This qualifier allows the application to specify directions to the operator in the OPCOM message associated with the load request. By default MDMS puts out an appropriate message.
Will cause MDMS to issue a DCL MOUNT command once the volume is loaded and the label verified. DCL MOUNT qualifiers can also be provided by specifying the qualifiers in a quoted string. By default, the volume is not mounted.
Specifies the volume pool the volume is to be placed in. This qualifier must be specified if the
/CREATE command is specified and the user only has MDMS_CREATE_POOL privilege, unless a pool is specified in a volume used with /INHERIT.
The name of the symbol to receive the operator's reply when operator intervention is needed. The symbol will contain the operator reply to the DCL REPLY/TO or DCL REPLY/ABORT commands. The maximum length of a symbol name is 31 characters.
The /NOWAIT qualifier returns an informational message indicating that the load is being queued. The /WAIT qualifier causes the MDMS LOAD DRIVE command to wait until a volume is loaded.
The default /WRITE qualifier specifies that the volume must be write-enabled when loaded, otherwise a warning is issued after the load. The /NOWRITE qualifier specifies that a volume can be successfully loaded with the write protect set on or off.
The MDMS LOAD VOLUME command loads the specified volume into a drive.
Equivalent STORAGE Command: STORAGE LOAD
Specifies the identifier of the volume to be loaded The maximum length of the volume ID is 6 characters. This parameter is required.
The MDMS LOAD VOLUME command loads the specified volume into a drive. The volume must already be created in the MDMS database.
If a drive was allocated based on the volume ID, then that drive is chosen for the load. You can also specify a drive on this command, and the volume will be loaded into that drive. The LOAD VOLUME command does not allocate the drive to the requesting process.
The request requires MDMS_LOAD_ALL, MDMS_LOAD_POOL or MDMS_LOAD_OWN. If the user is loading a volume for which he is the owner, MDMS_LOAD_OWN is sufficient.
If the user is loading a volume in a pool to which he is authorized, MDMS_LOAD_POOL is required. For all other loads, MDMS_LOAD_ALL is required.
MDMS_ASSIST is also required unless /NOASSIST is specified.
The /MOVE qualifier requires MDMS_MOVE_OWN, MDMS_MOVE_POOL or MDMS_MOVE_ALL according to the MOVE command.
The /NOCHECK qualifier cannot be used with /MOUNT.
/MOUNT and /WAIT are mutually exclusive.
The default /ASSIST qualifier is used to output an operator message if the volume requires operator intervention. You can use /ASSIST even if no assistance is needed - MDMS will perform the operation automatically if it can.
If you specify /NOASSIST and assistance is needed, the operation fails.
This qualifier requires the right MDMS_ASSIST
Compares the physical ANSI label on the tape against the label for the volume ID. If the physical ANSI label does not match the label for the volume ID, operator intervention is required to resolve the conflict. The default is /CHECK.
This qualifier specifies the name of the drive in which to load the volume. This qualifier is required unless a drive has been allocated for this volume (i.e. ALLOCATE DRIVE/VOLUME=volume_id.
This qualifier allows the application to specify directions to the operator in the OPCOM message associated with the load request.
Will cause MDMS to issue a DCL MOUNT command once the volume is loaded and the label verified. DCL MOUNT qualifiers can also be provided by specifying the qualifiers in a quoted string. By default, the volume is not mounted.
The default /MOVE qualifier, used with /ASSIST, allows the load request to generate a move request to move a volume from a remote location to the drive or associated jukebox. The move will generate an OPCOM move request which that must be satisfied before the load request can continue. If /NOMOVE is specified and a move is required, the load request fails with an error.
The name of the symbol to receive the operator's reply when operator intervention is needed. The symbol will contain the operator reply to the DCL REPLY/TO or DCL REPLY/ABORT commands. The maximum length of a symbol name is 31 characters. Used with /ASSIST only.
The /NOWAIT qualifier returns an informational message indicating that the load is being queued. The /WAIT qualifier causes the MDMS LOAD VOLUME command to wait until the volume is loaded.
The default /WRITE qualifier specifies that the volume must be write-enabled when loaded, otherwise a warning is issued after the load. The /NOWRITE qualifier specifies that a volume can be successfully loaded with the write protect set on or off.
$ MDMS LOAD VOLUME ABC010 /MOUNT="/NOUNLOAD"
This command loads volume ABC010 into a drive and mounts the volume with
"/NOUNLOAD" qualifier and verifies the volume label.
$ MDMS LOAD VOLUME ABC020 /NOCHECK /DRIVE=$1$MUA1:
This command loads volume ABC020 into drive$1$MUA1: and does not check the on-tape volume label.
$ MDMS LOAD VOLUME ABC020 /NOWAIT
This command loads volume ABC020 into an allocated drive, checks the on-tape volume label, but does not wait for the load to complete before returning the command prompt.
The MDMS MOVE MAGAZINE command moves a magazine from one location to another. The magazine must be created prior to the move.
Equivalent STORAGE Commands: STORAGE EXPORT MAGAZINE, STORAGE IMPORT MAGAZINE
Defines the name of the magazine to move. Only one magazine may be moved per command. If the /SCHEDULE qualifier is specified, the magazine_name may be the wildcard *, which means all scheduled magazines.
Specifies the name of the destination object. The destination object can be a location or a jukebox. The destination is optional when the /SCHEDULE is entered, but required for commands when /SCHEDULE is not entered. The default destination is the appropriate offsite or onsite location specified in the volume or magazine object
The MDMS MOVE MAGAZINE moves a magazine from one location to another. Magazines can be moved between outside locations, and from an outside location to and from a jukebox. When /ASSIST is specified, a series of OPCOM messages may be displayed asking the operator to move magazines between locations, or in and out of the jukebox. No slots or spaces are displayed in the OPCOM message, but the operator should issue SHOW MAGAZINE/FULL for the associated magazine(s) to determine slots, spaces or positions involved in the move. These are shown in the placement field.
The default /ASSIST qualifier is used when the magazine has not been physically moved, and an operator needs to physically move the magazine. Use /NOASSIST if the magazine has already been physically moved, or if you plan to move it yourself.
This qualifier requires the right MDMS_ASSIST.
When moving to a location that is not already specified in the magazine record, this qualifier specifies that the location is an offsite location, and the magazine placement is offsite following the move. By default, an unspecified location is onsite.
The /POSITION qualifier specifies that the magazine is being moved into a jukebox, and specifying the jukebox position that the magazine is being moved to. The /POSITION qualifier or
/START_SLOT qualifier must be specified when moving a magazine into a multi-magazine jukebox. In addition, the /POSITION qualifier can be used to transfer a magazine between positions inside a jukebox (if physically possible). The position parameter is in the format (tower, face, level).
The `tower, face and level' specification represents the relative number of the tower, face and level, starting from 0. So for the absolute jukebox slot of zero, the corresponding position is (0,0,0). The next position in the jukebox would be (0,0,1) and so on, according to the topology defined for the jukebox.
The name of the symbol to receive the operator's reply when operator intervention is needed. The symbol will contain the operator reply to the DCL REPLY/TO or DCL REPLY/ABORT commands. The maximum length of a symbol name is 31 characters. This qualifier is only applicable when /ASSIST is specified.
The /SCHEDULE qualifier selects magazines whose offsite or onsite date has "expired" and the magazine is not in the new location. If both dates have expired, the later of the two dates is used. The optional keywords on the /SCHEDULE qualifier may be:
If the OFFSITE keyword is used, then only those magazines scheduled to be moved offsite are selected. If the ONSITE keyword is used, then only those magazines scheduled to be moved onsite are selected. If the keyword is omitted, then the magazines scheduled to be moved onsite and offsite are selected.
This qualifier specifies the starting jukebox slot when the magazine is placed in a jukebox. The default is zero.
The /SPACES qualifier specifies the space(s) in a non-jukebox location to move the magazine to. Users should specify a single space while moving a single magazine. If /SCHEDULE is used, each magazine will be moved to the next space in the range, in order.
The /NOWAIT qualifier returns an informational message indicating that the move is being queued. The /WAIT qualifier causes the MDMS MOVE MAGAZINE command to wait until the magazine is moved.
$ MDMS MOVE MAGAZINE MYMAG01 JUKE_1
This command moves magazine MYMAG01 from its current location into jukebox JUKE_1 at start slot of zero.
MDMS MOVE MAGAZINE MYMAG01 JUKE_2 /POSITION=(2, 0, 1)
This command moves magazine MYMAG01 from its current location into jukebox JUKE_2 in position (2, 0, 1) i.e. Tower 2, face 0, level 1).
$ MDMS MOVE MAGAZINE MYMAG02 ROOM_100 /SPACES=23
This command moves magazine MYMAG02 from its current position out of the jukebox to location ROOM_100 in space 23.
$ MDMS MOVE MAGAZINE MAG002 JUKE_1 /SLOTS=13
This command moves magazine MAG002 from its current location into jukebox JUKE_1 in start slot of 13.
$ MDMS MOVE MAGAZINE /SCHEDULE=OFFSITE *
This command moves all magazines whose offsite date has expired to the magazine's offsite location.
This command moves all magazines whose offsite and onsite dates have expired to the magazine's offsite and onsite locations.
The MDMS MOVE VOLUME command moves a volume or volumes) from one location to another. The volume(s) must be created prior to the move.
Equivalent STORAGE Commands: STORAGE BIND, STORAGE EXPORT ACS, STORAGE EXPORT VOLUME, STORAGE IMPORT ACS, STORAGE IMPORT VOLUME
Defines the name of the volume to move. A volume_id may be a single volume, a list of volumes, a volume range, separated by a dash, or a list of volume ranges. A volume range is a numeric range for up to the last three characters of the volume ID. Example ranges are (ABC001-ABC250), (ABC120-ABC125). A volume_id may also be a wildcard *, which means all scheduled volumes. The wildcard is only valid when the /SCHEDULE qualifier is specified. This parameter is required.
Specifies the name of the destination object. The destination object can be a location, magazine or a jukebox. The destination is optional when /SCHEDULE is entered, but required for commands when /SCHEDULE is not entered. The default destination is the appropriate offsite or onsite location specified in the volume object.
The MDMS MOVE VOLUME command moves a volume or volumes from one location to another. The volume(s) must be created prior to the move. Multiple volumes can be moved, where appropriate, in a single command. When /ASSIST is specified, a series of OPCOM messages may be displayed asking the operator to move volumes between locations, or in and out of a jukebox or magazine. No slots or spaces are displayed in the OPCOM message, but the operator should issue SHOW VOLUME/FULL for the associated volumes to determine slots or spaces involved in the move. These are shown in the placement field.
This command is not used to load volumes into or out of drives.
In either case, the level of information can be as specific or general as you want - MDMS will select specific locations if detailed information is not supplied.
The request requires MDMS_MOVE_ALL, MDMS_MOVE_POOL or MDMS_MOVE_OWN.
If the user is moving a volume for which he is the owner, MDMS_MOVE_OWN is sufficient.
If the user is moving a volume in a pool to which he is authorized, MDMS_MOVE_POOL is required. All other moves require MDMS_MOVE_ALL.
MDMS_ASSIST is also required unless /NOASSIST is specified.
The /DESCRIPTION qualifier requires MDMS_SET_ALL, MDMS_SET_POOL or MDMS_SET_OWN.
The default /ASSIST qualifier is used to output an operator message if the volume requires operator intervention. You can use /ASSIST even if no assistance is needed - MDMS will perform the operation automatically if it can. If you specify /NOASSIST and assistance is needed, the operation fails.
This qualifier requires the right MDMS_ASSIST
If moving to a volume to/from a silo, this qualifier specifies the Cartridge Access Port identifier into which the volume(s) are being physically injected or ejected. Required while moving a volume into or out of a silo. Valid for DCSC-controlled jukeboxes only.
Modifies comments about the object in the volume record. If the text contains spaces, then it must be enclosed within quotation marks. The length of the description can range from 0 to 255 characters. To clear the existing description, specify "".
This qualifier requires the right MDMS_SET_*
This qualifier requests that no internal jukebox calls (through DCSC or MRD) are made to implement the move. When used with /NOASSIST, the effect of the MOVE VOLUME command is to simply update the database to the new location. When used with the default of
/ASSIST, a single OPCOM message is displayed to move the volumes, but when the message expires, the database is automatically updated.
When moving to a location that is not already specified in the volume record, this qualifier specifies that the location is an offsite location, and the volume placement is offsite following the move. By default, an unspecified location is onsite.
The name of the symbol to receive the operator's reply when operator intervention is needed. The symbol will contain the operator reply to the DCL REPLY/TO or DCL REPLY/ABORT commands. The maximum length of a symbol name is 31 characters. This qualifier is only applicable when /ASSIST is specified.
The /SCHEDULE qualifier selects volumes whose offsite or onsite date has "expired" and the volumes are not in the new location. If both dates have expired, the later of the two dates is used. The optional keywords on the schedule qualifier may be:
If the OFFSITE keyword is used, then only those volumes scheduled to be moved offsite are selected. If the ONSITE keyword is used, then only those volumes scheduled to be moved onsite are selected. If the keyword is omitted, then volumes scheduled to be moved onsite and offsite are selected.
The /SLOTS qualifier specifies that the volume is being moved into a jukebox or magazine and specifying the slot range, or slot list, that the volumes are being moved to. If not specified, MDMS selects free slot locations for the volume(s).
In addition, the /SLOTS qualifier can be used to transfer volumes between slot locations inside a jukebox or magazine. If moving a single volume, specify a single slot. If moving multiple volumes, the slots in the range are assigned in order. If any of the specified slots is full, MDMS selects alternate slots.
Valid for MRD-controlled jukeboxes only.
The SPACES qualifier specifies the space(s) in a non-jukebox location to move the volume(s) to.
The /NOWAIT qualifier returns an informational message indicating that the move is being queued. The /WAIT qualifier causes the MDMS MOVE VOLUME command to wait until the command is complete.
$ MDMS MOVE VOLUME ABC001 JUKE_2 /SLOTS=20
This command moves volume ABC001 from its current location to jukebox JUKE_2 at slot 20.
$ MDMS MOVE VOLUME AGW081 SHELF /SPACES=42
This command moves the volume AGW081 to location SHELF at space 42.
$ MDMS MOVE VOLUME FLI050-FLI056 MAG001 /SLOTS=(0-6)
This command moves volumes FLI050 to FLI056 into magazine MAG001 in slots (0-6).
$ MDMS MOVE VOLUME /SCHEDULE=OFFSITE *
This command moves all volumes whose offsite date has expired to the volumes' offsite location.
$ MDMS MOVE VOLUME /SCHEDULE=OFFSITE ABC001-ABC100 ARGUS_VAULT
This command moves all volumes in the range ABC001-ABC100 whose offsite date has expired to the location ARGUS_VAULT.
This command moves all volumes whose offsite and onsite dates have expired to the volumes' offsite and onsite locations.
$ MDMS MOVE VOLUME ALS100-ALS150 WOLFCREEK /CAP=1
This command moves volumes ALS100-ALS150 into a DCSC-controlled silo using CAP 1.
The MDMS REPORT VOLUME command reports on volume objects.
Equivalent STORAGE Command: None
The field parameter selects attributes to display for the object. See Report Volume Field - Attributes comprises the list of attributes for this object. At least one field must be defined for a report to be generated.
A non-jukebox space in the specified location that the volume resides in |
|||
The time a volume stays in the transition state before going to the free state |
|||
The MDMS REPORT VOLUME command generates a report on the selected volumes. The contents of the report contain fields as specified in the field parameters. Each selected field is displayed unless the /NOPRINT field qualifier is specified. The report can be sorted on the field by using the /SORT qualifier on a single field (only one sort key supported per command). In addition, the width of each field can be specified with the /WIDTH qualifier - the default width is specific for each field size.
The request requires MDMS_SHOW_ALL, MDMS_SHOW_POOL or MDMS_SHOW_OWN.
If the user only has MDMS_SHOW_OWN, only those allocated volumes owned by the user will be included in the report. If the user has MDMS_SHOW_POOL, only those volumes in pool(s) for which the user is authorized will be displayed. If the user has MDMS_SHOW_ALL, all potential volumes matching the selection criteria will be displayed.
The /USER_NAME qualifier can only be used with the /FORECAST and /SUMMARY qualifiers. For all other type of reports use the selection value of the USER field.
Fields cannot be used with the /FORECAST and /SUMMARY qualifiers. The /FORECAST and /SUMMARY qualifiers are mutually exclusive Fields must be specified with the /SCHEDULE qualifier.
Displays all allocated volumes sorted by their scratch date. If the /USER_NAME qualifier is not specified, only those volumes allocated to the user are displayed. Do not specify any fields.
Directs the report output to the specified file instead of SYS$OUTPUT, which is usually the command screen.
The /NOPRINT field qualifier specifies that a field defined as a selection criteria is not included in the report.
The /SCHEDULE qualifier selects volumes whose offsite or onsite date has "expired" and the volumes are not in the new location. If both dates have expired, the later of the two dates is used. The optional keyword on the schedule qualifier may be:
If The OFFSITE keyword is used, then only those volumes scheduled to be moved offsite are selected. If the ONSITE keyword is used, then only those volumes scheduled to be moved onsite are selected. If the keyword is omitted, then volumes scheduled to be moved onsite and offsite are selected
This is a field qualifier, and is used as a sort key. Only one field can be used as a sort key, and no value may be specified.
Displays all volumes allocated to a user and sorted by volume ID. If the /USER_NAME qualifier is not specified, only those volumes allocated to the present user are displayed. Do not specify any fields.
Specifies the title of the report. If the text contains spaces, it must be enclosed in quotation marks. The maximum length of the title is 80 characters. If not supplied, a default title based on the volume ID and selection criteria is generated.
Selects volumes owned by this user. This qualifier can only be used with the /FORECAST and
/SUMMARY qualifiers. If /USER_NAME is not specified, only those volumes for the present user are selected.
A field qualifier, this specifies the number of characters to display for a field. If not specified, a default width is applied to each field type, and excess characters may be truncated.
$ MDMS REPORT VOLUME VOLUME, POOL=ABS_POOL, STATE, SCRATCH_DATE
This command prints a report for all volumes in pool ABS_POOL, and prints out the volume_id, pool name, allocation state and scratch date.
$ MDMS REPORT VOLUME VOLUME, STATE=ALLOCATED/NOPRINT, SCRATCH_DATE
This command prints a report for all allocated volumes, and prints out the volume id and scratch date.
$ MDMS REPORT VOLUME VOLUME, STATE=ALLOCATED, OWNER/SORT/WIDTH=10
This command prints a report for all allocated volumes, and prints out the volume id, allocation state and owner (maximum of 10 characters), and the report is sorted by owner.
$ MDMS REPORT VOLUME /FORECAST /USER_NAME=SMITH
This command prints a report for all volumes allocated to user smith, and prints out the volume id, allocation date, scratch date, format and description fields, sorted by scratch date.
The MDMS SET DOMAIN command modifies the MDMS Domain object. The MDMS domain contains attributes affecting all nodes, devices and locations that comprise an MDMS domain.
Equivalent STORAGE Command: None
The MDMS SET DOMAIN command modifies the MDMS domain. The MDMS domain contains attributes affecting all nodes, devices and locations that comprise an MDMS domain.
The request requires MDMS_SET_ALL.
The qualifiers associated with setting of privilege rights also require MDMS_SET_RIGHTS.
The /ADD, /REMOVE and /REPLACE qualifiers are mutually exclusive. If none are specified, attributes are added to list attributes by default.
The /ABS_RIGHTS qualifier enables a certain set of MDMS rights when users have an ABS right set in the UAF record. The /NOABS_RIGHTS qualifier does not give users with ABS rights any additional MDMS rights.
This qualifier requires the right MDMS_SET_RIGHTS
The /ADD qualifier works in conjunction with certain qualifiers that accept lists and adds specified attributes. This is the default while specifying list attributes.
/[NO]APPLICATION_RIGHTS[=(right[,...]
The /APPLICATION_RIGHTS qualifier sets the low-level rights associated with the high-level right MDMS_APPLICATION. If the qualifier is specified with no value, a default set of rights is set. The /REMOVE or /REPLACE qualifiers can be used to remove or replace rights in the list, rather than adding them by default.
Use /NOAPPLICATION_RIGHTS to remove all rights.
This qualifier requires the right MDMS_SET_RIGHTS
Refer to the Appendix - MDMS Rights and Privileges for details.
This attribute stores a text string stating the deallocation state of volumes. Allowable values are free and transition.
/[NO]DEFAULT_RIGHTS[=(right[,...])]
The /DEFAULT_RIGHTS qualifier sets the low-level rights associated with users with no MDMS rights in their UAF record. If the qualifier is specified with no value, a default set of rights is set. The /REMOVE or /REPLACE qualifiers can be used to remove or replace rights in the list, rather than adding them by default. Use /NODEFAULT_RIGHTS to remove all rights.
This qualifier requires the right MDMS_SET_RIGHTS.
Refer to the Appendix - MDMS Rights and Privileges for details.
This attribute is a list of OpenVMS system users who should receive notification when volumes are deallocated.
/MAXIMUM_SCRATCH_TIME=delta_time
The maximum scratch time is an OpenVMS delta time that specifies the greatest allocation time allowed.
This qualifier specifies the default MDMS media type, which is applied to drives and volumes if they are created without a media type definition.
Set the value of this attribute to the longest time you could expect normal network traffic to delay interprocess communication between MDMS clients and servers. Requests that go unanswered up to the amount of time specified by this attribute will not cause an error.
This attribute stores a text string identifying the name of the Location object representing your offsite storage location. This location is applied to all volumes and magazines that do not have an explicit offsite location specified
This attribute stores a text string identifying the name of the Location object representing your onsite storage location. This location is applied to all volumes and magazines that do not have an explicit onsite location specified.
Use this attribute to list the OpenVMS OPCOM classes to which MDMS OPCOM messages are directed. These OPCOM classes are applied to all nodes that do not have explicit OPCOM classes specified. The /REMOVE or /REPLACE qualifiers can be used to remove or replace classes in the list, rather than adding them by default.
/[NO]OPERATOR_RIGHTS[=(right[,...])]
The /OPERATOR_RIGHTS qualifier sets the low-level rights associated with the high-level right MDMS_OPERATOR. If the qualifier is specified with no value, a default set of rights is set. The /REMOVE or /REPLACE qualifiers can be used to remove or replace rights in the list, rather than adding them by default.
Use /NOOPERATOR_RIGHTS to remove all rights.
This qualifier requires the right MDMS_SET_RIGHTS.
Refer to the Appendix - MDMS Rights and Privileges for details.
Assign the default volume protection for all volumes with this attribute. Use the standard OpenVMS protection format. This protection is applied to all volumes that do not have an explicit protection specified.
The /REMOVE qualifier works in conjunction with certain qualifiers that accept lists and removes specified attributes from them.
The /REPLACE qualifier works in conjunction with certain qualifiers that accept lists and replaces the existing attributes list with the specified attributes list. By default, list attributes are added to the existing list.
Changes the request identifier for the next MDMS request in the domain.
Assign the default scratch date to volumes by applying the delta time specified with attribute to the allocation date of the volume. This scratch time is applied to all volumes that do not have an explicit scratch date defined.
The default /SYSPRV qualifier enables users with VMS privilege SYSPRV the low-level right MDMS_ALL_RIGHTS, which allows all operations. The /NOSYSPRV qualifier does not give users with SYSPRV any additional MDMS rights.
This qualifier requires the right MDMS_SET_RIGHTS
Defines the default transition time to be applied to volumes that do not have an explicit transition time defined.
/[NO]USER_RIGHTS[=(right[,...])]
The /USER_RIGHTS qualifier sets the low-level rights associated with the high-level right MDMS_USER. If the qualifier is specified with no value, a default set of rights is set.
The /REMOVE or /REPLACE qualifiers can be used to remove or replace rights in the list, rather than adding them by default.
Use /NOUSER_RIGHTS to remove all rights.
This qualifier requires the right MDMS_SET_RIGHTS
Refer to the Appendix - MDMS Rights and Privileges for details.
$ MDMS SET DOMAIN /OFFSITE_LOCATION=XCYX
This command sets the name of the domain offsite location to XCYX.
$ MDMS SET DOMAIN /MAIL_USERS=(NORDER,CRANDLE)/ADD
This command adds OpenVMS Cluster users Norder and Crandle to the mail distribution. They will be notified when volumes are deallocated.
$ MDMS SET DOMAIN /OPCOM_CLASSES=(OPER4) /REMOVE
This command prevents the further display of OPCOM messages on terminals enabled for the OPER4 OPCOM class.
$ MDMS SET DOMAIN /OPERATOR_RIGHTS=(MDMS_SET_ALL, MDMS_SET_PROTECTED)/ADD
This command adds the low-level rights MDMS_SET_ALL and MDMS_SET_PROTECTED to the high-level right MDMS_OPERATOR.
The MDMS SET DRIVE command modifies a drive definition in the MDMS configuration database.
Equivalent STORAGE Command: None
Specifies the name of the drive. Specify a drive name or a logical name. The maximum length of the drive name or logical name is 31 characters.
The MDMS SET DRIVE command modifies a drive definition in the MDMS configuration database.
The /NODES and /GROUPS qualifiers are mutually exclusive. The MDMS server will refuse this command if both qualifiers are used in the affirmative forms.
The /ADD, /REMOVE and /REPLACE qualifiers are mutually exclusive. If none are specified, attributes are added to list attributes by default
This qualifier defines the type of access to the drive, which can be one of the following keywords:
The /ADD qualifier works in conjunction with certain qualifiers that accept lists and adds specified attributes. This is the default when specifying list attributes.
Specifies that MDMS automatically replies to all OPCOM messages that can be polled for completion on requests for this particular drive.
Comments about the drive. If the text contains spaces, then it must be enclosed within quotation marks. The length of the description can range from 0 to 255 characters. To clear the description, specify "".
Modifies the OpenVMS device name of the drive. Do not include a node specification (NODE::drive) in the drive name - instead, use the /NODES or /GROUPS qualifier.
Places the drive in the disabled state. This prevents the drive from being selected and allocated for use. This takes effect immediately. However, if the drive is already in use, operations on that drive will continue until the drive is deallocated.
This qualifier defines the drive number for robot commands if the drive is in a jukebox.
The default is zero.
Places the drive in the enabled state. This allows the drive to be selected and allocated for use. This takes effect immediately. This is the default.
Specifies the names of groups of nodes that share common access to this device.
If the drive is in a jukebox, this qualifier specifies the jukebox name.
/MEDIA_TYPE=(media_type[,...])
Specifies one or more distinct media types that the drive can support for read-write access.
The /REMOVE or /REPLACE qualifiers can remove or replace objects in the list, rather than adding them by default. The /NOMEDIA_TYPES qualifier removes all media types.
Specifies one or more distinct nodes that have direct access to the drive. The /REMOVE or /REPLACE qualifiers can remove or replace objects in the list, rather than adding them by default. The /NONODE qualifier removes all nodes.
Specifies one or more distinct media types that the drive can support for read-only access.
The /REMOVE or /REPLACE qualifiers can remove or replace objects in the list, rather than adding them by default. The /NOREADONLY qualifier removes all read-only media types.
The /REMOVE qualifier works in conjunction with certain qualifiers that accept lists and removes specified attributes from them.
The /REPLACE qualifier works in conjunction with certain qualifiers that accept lists and replaces the existing attributes list with the specified attributes list. By default, list attributes are added to the existing list.
The /SHARED qualifier defines that the drive may be used by non-MDMS clients and that the drive is only partially managed. The default, /NOSHARED, indicates that all access to the drive is through MDMS. If the drive is set to the default /NOSHARED, the MDMS server allocates the drive at all times it is not used by an application or user. Setting the drive to /SHARED clears this allocation.
The /STACKER qualifier indicates that the drive is to be treated as a stacker gravity loader. The default /NOSTACKER indicates that the drive is to be treated as a standalone drive, or a robotically-controlled jukebox, as appropriate.
The MDMS SET GROUP command modifies a group definition in the MDMS configuration database.
Equivalent STORAGE Command: None
The MDMS SET GROUP command modifies a group definition in the MDMS configuration database.
The /ADD, /REMOVE and /REPLACE qualifiers are mutually exclusive. If no qualifier is specified, attributes are added to list attributes by default.
The /ADD qualifier works in conjunction with certain qualifiers that accept lists, and adds specified attributes. This is the default while specifying list attributes.
Comments about the group. If the text contains spaces, then it must be enclosed within quotation marks. The length of the description can range from 0 to 255 characters. To clear the description, specify "".
Specifies one or more distinct nodes that have direct access to the drive. The /REMOVE or
/REPLACE qualifiers can be used to remove or replace objects in the list, rather than adding them by default. The /NONODES qualifier removes all nodes.
The /REMOVE qualifier works in conjunction with certain qualifiers that accept lists and removes specified attributes from them.
The /REPLACE qualifier works in conjunction with certain qualifiers that accept lists and replaces the existing attributes list with the specified attributes list. By default, list attributes are added to the existing list.
The MDMS SET JUKEBOX command modifies a jukebox definition in the MDMS configuration database.
Equivalent STORAGE Command: None
The MDMS SET JUKEBOX command modifies a jukebox definition in the MDMS configuration database.
The /NODES and /GROUPS qualifiers are mutually exclusive. The MDMS server will refuse this command if both qualifiers are used in the affirmative forms.
The /ADD, /REMOVE and /REPLACE qualifiers are mutually exclusive. If none are specified, attributes are added to list attributes by default.
This qualifier defines the type of access to the jukebox, which can be one of the following keywords:
This qualifier specifies the Automated Cartridge System (ACS) Identifier for the jukebox. The default value is zero. Each MDMS jukebox maps to one Library Storage Module (LSM), and requires specification of the library, ACS and LSM identifiers. Valid for DCSC-controlled jukeboxes only.
The /ADD qualifier works in conjunction with certain qualifiers that accept lists and adds specified attributes. This is the default while specifying list attributes.
Specifies that MDMS automatically replies to all OPCOM messages that can be polled for completion on requests for this particular jukebox.
For DCSC jukeboxes equipped with Cartridge Access Points (CAPS), this attribute specifies the number of cells for each CAP. The first number is the size for CAP 0, the next for CAP 1 etc.
If a size is not specified for a CAP, a default value of 40 is used. Specifying the CAP size optimizes the movement of volumes to and from the jukebox by filling the CAP to capacity for each move operation. When specifying CAP sizes, the specified numbers always replace any previous sizes in the database. Valid for DCSC-controlled jukeboxes only.
This qualifier specifies the robot control facility used to control the jukebox's robot. The valid keywords are:
Defines comments about the object in the record. If the text contains spaces, then it must be enclosed within quotation marks. The length of the description can range from 0 to 255 characters. To clear the existing description, specify "".
Places the jukebox in the disabled state. This prevents all drives in the jukebox from being selected and allocated for use. This takes effect immediately. However, any drives in use will continue to be used until they are deselected.
Places the drive in the enabled state. This allows drives in the jukebox to be selected and allocated for use. This takes effect immediately. This is the default.
Specifies the names of groups of nodes that share common access to this device. The /REMOVE or /REPLACE qualifiers can be used to remove or replace objects in the list, rather than adding them by default. The /NOGROUPS qualifier removes all groups.
This qualifier specifies the library identifier for a silo. Valid values are 1, 2, 3, 4, and the default is 1 when the jukebox is controlled by DCSC and 0 (not applicable) when controlled by MRD. Each MDMS jukebox maps to one Library Storage Module (LSM), and requires specification of the library, ACS and LSM identifiers.
This qualifier specifies the Library Storage Module (LSM) Identifier for the jukebox. The default value is zero. Each MDMS jukebox maps to one LSM, and requires specification of the library, ACS and LSM identifiers. Valid for DCSC-controlled jukeboxes only.
Specifies one or more nodes that can directly access the jukebox. The /REMOVE or /REPLACE qualifiers can be used to remove or replace objects in the list, rather than adding them by default. The /NONODES qualifier removes all nodes.
The /REMOVE qualifier works in conjunction with certain qualifiers that accept lists and removes specified attributes.
The /REPLACE qualifier works in conjunction with certain qualifiers that accept lists and replaces the existing attributes list with the specified attributes list. By default, list attributes are added to the existing list.
The /ROBOT qualifier defines the OpenVMS device name of the robot. Applicable to MRD-controlled jukeboxes only.
The /SHARED qualifier defines that the jukebox may be used by non-MDMS clients and that the jukebox is only partially managed. The default, /NOSHARED, indicates that all access to the jukebox is through MDMS.
The /SLOTS qualifier specifies the total number of slots in the entire jukebox. For any jukebox, either the slot count or topology must be specified. Valid for MRD jukeboxes only.
The /STATE qualifier specifies the usgae state of the jukebox. This is normally set up by MDMS. The keyword values are:
This qualifier requires the right MDMS_SET_PROTECTED.
/TOPOLOGY=(TOWERS=(number[,...]), FACES=(number[,...]), -
LEVELS=(number[,...]), SLOTS=(number[,...]))
Specifies topology of jukebox, when a TL820-class jukebox is being used as a magazine.
The topology specification allows OPCOM messages to move magazines to be specified with TOWER, FACE, LEVEL rather than slot range. The specification of topology is optional.
For each tower in the configuration, a corresponding entry must also be placed in FACES LEVELS and SLOTS that reflects the configuration of that tower. The tower numbers start at zero. Other specifications are absolute counts. See example. Valid for MRD jukeboxes only.
The /USAGE=MAGAZINE qualifier specifies that the jukebox is configured for magazines, and that the movement of volumes is performed using magazines. The /USAGE=NOMAGAZINE qualifier does not support magazine use. The default is NOMAGAZINE. Valid for MRD jukeboxes only
The MDMS SET LOCATION command modifies a location definition in the MDMS configuration database.
Equivalent STORAGE Command: None
The MDMS SET LOCATION command modifies a location definition in the MDMS configuration database.
Defines comments about the object in the record. If the text contains spaces, then it must be enclosed within quotation marks. The length of the description can range from 0 to 255 characters. To clear the existing description, specify "".
The /LOCATION qualifier allows you to specify a higher level location, thus creating a location hierarchy. If there is no higher location, specify /NOLOCATION.
The /SPACES qualifier defines individual spaces for volumes or magazines at the location. Spaces are alphanumeric strings of up to 8 characters. The spaces can be specified as a range - only a single range is supported. The /NOSPACES qualifier removes all spaces.
The MDMS SET MAGAZINE command modifies a magazine definition in the MDMS configuration database.
Equivalent STORAGE Command: None.
Specifies the name of the magazine. The maximum length of the magazine name is 31 characters.
The MDMS SET MAGAZINE command modifies a magazine definition in the MDMS configuration database.
The request requires MDMS_SET_ALL.
The /JUKEBOX, /PLACEMENT, /POSITION and /START_SLOT qualifiers also require MDMS_SET_PROTECTED.
Defines comments about the object in the record. If the text contains spaces, then it must be enclosed within quotation marks. The length of the description can range from 0 to 255 characters. To clear the existing description, specify "".
The name of the jukebox from which the magazine will be selected. The maximum length of the jukebox name is 31 characters.
/OFFSITE=([LOCATION=location][,[NO]DATE[=date]])
This qualifier specifies the date that the magazine is to be taken offsite and the offsite location. The location field is required when using the /OFFSITE qualifier if no location has been previously specified. The LOCATION keyword cannot be negated and if specified must point to a valid location object. Specify a VMS absolute or delta time in the date field. The NODATE keyword may be used to remove the date. This has the effect of disabling the schedule for the magazine, while retaining the location. To clear the offsite date and location, specify /NOOFFSITE.
/ONSITE=([LOCATION=location][,[NO]DATE[=date]])
This qualifier specifies the date that the magazine is to be brought back onsite and the onsite location. The location field is required when using the /ONSITE qualifier if no location has been previously specified. The LOCATION keyword cannot be negated and if specified must point to a valid location object. Specify a VMS absolute or delta time in the date field. The NODATE keyword may be used to remove the date. This has the effect of disabling the schedule for the magazine, while retaining the location. To clear the onsite date and location, specify /NOONSITE.
This qualifier defines the current placement of the magazine. This is normally managed by MDMS. The following options are available:
The /POSITION qualifier specifies that the magazine is being created in a jukebox, and specifying the jukebox position that the magazine is being created. If not specified, MDMS selects a free position for the magazine. In addition, the /POSITION qualifier can be used to transfer a magazine between positions inside a jukebox (if physically possible). The position parameter is in the format (tower, face, level).
The /SLOT_COUNT qualifier specifies the number of slots in a magazine to store volumes.
This qualifier specifies the space(s) in a location in which the magazine is stored when not in a jukebox. Spaces are alphanumeric strings of up to 8 characters. The
/NOSPACES qualifier removes all spaces.
This qualifier specifies the starting jukebox slot when the magazine is placed in a jukebox. This is normally set up by MDMS.
The MDMS SET MEDIA_TYPE command modifies a media type definition in the MDMS configuration database.
Equivalent STORAGE Command: None
Specifies the name of the media type. The maximum length of the media type name is 31 characters.
The MDMS SET MEDIA_TYPE command modifies a media type definition in the MDMS configuration database. A media type definition consists of a density, compaction option and capacity, if applicable.
The /CAPACITY qualifier specifies the capacity in megabytes of the tape. This is used by some MDMS clients to estimate end-of-tape conditions. By default, capacity is set to zero.
The /COMPACTION qualifier specifies that the media type should use compaction when writing to tape. This is the default. If you do not wish to use compaction, then specify /NOCOMPACTION.
Specifies a freeform density keyword between 1 and 31 characters in length that the media type supports.
Defines comments about the media type. If the text contains spaces, then it must be enclosed within quotation marks. The length of the description is can range from 0 to 255 characters. Specify to clear the description.
The /LENGTH qualifier specifies the length of a 9-track magnetic tape, and is expressed in feet. By default, length is set to zero.
The MDMS SET NODE command modifies a node definition in the MDMS configuration database.
Equivalent STORAGE Command: None
The MDMS SET NODE command modifies a node definition in the MDMS configuration database.
The /ADD, /REMOVE and /REPLACE qualifiers are mutually exclusive. If none are specified, attributes are added to list attributes by default.
The /ADD qualifier works in conjunction with certain qualifiers that accept lists and adds specified attributes. This is the default while specifying list attributes.
The /DATABASE_SERVER qualifier means the node can be a database server, supporting fail-over operations. To be a database server, the node must have direct access to the MDMS database files.
/DECNET_PLUS_FULLNAME=node_fullname
This qualifier allows you to specify a full name (for example, a DECnet-Plus (Phase V) full name) for a node. The full name may be up to 255 characters. If not specified, the node name is used as the full name.
Defines comments about the node. If the text contains spaces, then it must be enclosed within quotation marks. The length of the description can range from 0 to 255 characters. Specify "" to clear the description.
Places the node in the disabled state. This prevents the node from participating in the MDMS domain as either a server or a client. This takes effect immediately.
Places the node in the enabled state. This allows the node to participate in MDMS operations. This takes effect immediately. This is the default.
The /LOCATION qualifier specifies the onsite location of the node. If there is no location, specify /NOLOCATION. By default, a node acquires the default location from the domain record.
The /OPCOM qualifier adds the specified classes used for notifying operators. All OPCOM for devices on the node are sent to all specified classes on the node. The /REMOVE or /REPLACE qualifiers can be used to remove or replace classes in the list, rather than adding them by default. Specify /NOOPCOM to disable OPCOM notification. By default, the node acquires OPCOM classes from the domain record. The following classes are valid:
The /REMOVE qualifier works in conjunction with certain qualifiers that accept lists and removes specified attributes.
The /REPLACE qualifier works in conjunction with certain qualifiers that accept lists and replaces the existing attributes list with the specified attributes list. By default, list attributes are added to the existing list.
This qualifier allows you to specify a TCP-IP full name for a node. The full name may be up to 255 characters. If not specified, the node name is used as the full name.
Specifies the transport protocol(s) to be used when communicating with other MDMS facilities on other nodes, as a prioritized ordered list. The /ADD or /REMOVE qualifier can be used to add or remove objects from the list, rather than setting to the specified values. Enter one or more of:
The MDMS SET POOL command modifies a pool definition in the MDMS configuration database.
Equivalent STORAGE Command: None
The MDMS SET POOL command modifies a pool definition in the MDMS configuration database.
The /ADD, /REMOVE and /REPLACE qualifiers are mutually exclusive. If no qualifier is specified, attributes are added to list attributes by default.
The /ADD qualifier works in conjunction with certain qualifiers that accept lists and adds specified attributes. This is the default while specifying list attributes.
/AUTHORIZED_USERS =(node/group_name::username[,...])
Specifies one or more distinct users to the pool specified by node or group name and user name. Only authorized or default users can allocate volumes belonging to the pool.
The /REMOVE or /REPLACE qualifier can be used to remove or replace users in the list, rather than adding them by default.
/DEFAULT_USERS=(node/group_name::username[,...])
Specifies one or more distinct users to the pool as the users default pool. Only authorized or default users can allocate volumes belonging to the pool. The /REMOVE or /REPLACE qualifier can be used to remove or replace users in the list, rather than adding them by default. A particular node/group::user combination can only be defined with the /DEFAULT qualifier for one pool.
Defines comments about the pool. If the text contains spaces, then it must be enclosed within quotation marks. The length of the description can range from 0 to 255 characters. Specify "" to clear the description.
The /REMOVE qualifier works in conjunction with certain qualifiers that accept lists and remove specified attributes from them.
The /REPLACE qualifier works in conjunction with certain qualifiers that accept lists and replace the existing attributes list with the specified attributes list. By default, list attributes are added to the existing list.
The MDMS SET SERVER command resets server conditions. Currently it only supports resetting the MDMS logging file.
Equivalent STORAGE Command: None
The MDMS SET SERVER command resets server conditions. Currently it only supports resetting the MDMS logging file.
The MDMS SET VOLUME command modifies a volume definition in the MDMS volume database.
Equivalent STORAGE Command: STORAGE SET VOLUME
Specifies the volume ID of the volume to be added. The volume ID is the external label for the volume. The maximum length of the volume ID is 6 characters. Alternatively, a volume range, separated by a dash, may be specified. A volume range is a numeric range for up to the last three characters of the volume ID. Example ranges are (ABC001-ABC250), (ABC120-ABC125).
The request requires MDMS_SET_ALL, MDMS_SET_POOL or MDMS_SET_OWN.
If the user is modifying a volume that is allocated to him, MDMS_SET_OWN is sufficient. If the user is modifying a volume that belongs to a pool to which he is authorized, MDMS_SET_POOL is required. For any other volume, MDMS_SET_ALL is required.
Several of the qualifiers are designated protected, and require the right MDMS_SET_PROTECTED. These fields are normally set up by MDMS, and modification is not recommended since that could put the database into an inconsistent state.
The /ADD, /REMOVE and /REPLACE qualifiers are mutually exclusive. If none are specified, attributes are added to list attributes by default.
Defines the account name of the volume. The account name may be up to 31 characters. If it contains spaces, it must be enclosed in quotation marks. Specify " " to clear the account name.
This qualifier requires the right MDMS_SET_PROTECTED.
The /ADD qualifier works in conjunction with certain qualifiers that accept lists and adds specified attributes. This is the default when specifying list attributes.
Specifies the date the volume was allocated. Normally this is set by MDMS. Specify a VMS absolute date and time. Specify /NOALLOCATED_DATE to clear the allocated date.
This qualifier requires the right MDMS_SET_PROTECTED.
The /AVAILABLE qualifier moves a volume from the unavailable state to the state it was previously in prior to the unavailable state. The volume may then be moved into the transition or free state if the scratch date and/or transition time have expired.
Specifies the block factor the volume. This qualifier only applies to volumes with the format attribute set to EBCDIC. The default is a block factor of zero.
The media manufacturer. The maximum length of the brand name is 31 characters. If it contains spaces it must be contained in quotation marks. Specify "" to clear the
This qualifier specifies the date the volume was last cleaned and is entered as a VMS absolute time. Specify /NOCLEANED_DATE to clear the cleaned date.
The date the volume is created. This attribute is set by MDMS, but may be overridden if necessary.
This qualifier requires the right MDMS_SET_PROTECTED.
This qualifier specifies the actual deallocation date for the volume. Specify a VMS absolute time. This date is normally set by MDMS.
This qualifier requires the right MDMS_SET_PROTECTED
Comments about the volume. If the text contains spaces, then it must be enclosed within quotation marks. The length of the description can range from 0 to 255 characters. Specify "" to clear the description.
Specifies the drive that the volume currently resides in or last resided in. This is normally set up by MDMS. To clear the drive, specify /NODRIVE.
This qualifier requires the right MDMS_SET_PROTECTED.
Specifies the format of the tape. Possible values are:
Specifies the date the volume was last freed (in the free state). Specify a VMS absolute date and time. This is normally set up by MDMS. To clear the freed date, specify /NOFREED_DATE.
This qualifier requires the right MDMS_SET_PROTECTED.
Specifies the date the volume was last initialized. Specify a VMS absolute date and time. This is normally set up by MDMS. To clear the initialized date,
specify /NOINITIALIZED_DATE.
This qualifier requires the right MDMS_SET_PROTECTED.
This qualifier allows you to set the number of I/O errors on the volume. The default value is zero.
This qualifier requires the right MDMS_SET_PROTECTED.
This qualifier allows you to specify the last job that accessed the volume. The job name can be from 0 to 31 characters. If it contains spaces, it must enclosed in quotation marks. Specify "" to clear the job name.
This qualifier requires the right MDMS_SET_PROTECTED.
This qualifier allows you to specify that the volume is currently residing or last resided in the specified jukebox. The maximum length of a jukebox name is 31 characters. This is normally set up by MDMS. To clear the jukebox name,
specify /NOJUKEBOX.
This qualifier requires the right MDMS_SET_PROTECTED.
Specifies the date the volume was last accessed. Specify a VMS absolute date and time. This is normally set up by MDMS. To clear the last access date,
specify /NOLAST_ACCESS_DATE.
This qualifier requires the right MDMS_SET_PROTECTED.
Specifies the magazine name if the volume resides in a magazine.
This qualifier requires the right MDMS_SET_PROTECTED.
/MEDIA_TYPES=(media_type[,...])
The media type qualifier allows you to add the media type(s) that the volume can support. Multiple media types are supported prior to the volume being initialized. After initialization, a volume can only support one media type. The /REMOVE or /REPLACE qualifier can be used to remove or replace objects in the list, rather than adding them by default. To specify the volume supports no media types, enter /NOMEDIA_TYPES.
Specifies the number of times the volume has been loaded and mounted. Normally set up by MDMS. The default mount count is zero.
/OFFSITE=([LOCATION=location][, [NO]DATE[=date]])
This qualifier specifies the date that the volume is to be taken offsite and the offsite location. The location field is required when using the /OFFSITE qualifier if no location has been previously specified. The LOCATION keyword cannot be negated and if specified must point to a valid location object. Specify a VMS absolute or delta time in the date field. The NODATE keyword may be used to remove the date. This has the effect of disabling the schedule for the volume, while retaining the location. To clear the offsite date and location, specify /NOOFFSITE. If a volume is under magazine control, the /OFFSITE qualifier is not allowed. The volume inherits these values from the magazine object. If /MAGAZINE is used on the SET VOLUME command when an existing /OFFSITE location and date are set, the values are cleared.
/ONSITE=([LOCATION=location][, [NO]DATE=date]])
This qualifier specifies the date that the volume is to be brought back onsite and the onsite location. The location field is required when using the /ONSITE qualifier if no location has been previously specified. The LOCATION keyword cannot be negated and if specified must point to a valid location object. Specify a VMS absolute or delta time in the date field. The NODATE keyword may be used to remove the date. This has the effect of disabling the schedule for the volume, while retaining the location. To clear the onsite date and location, specify /NOONSITE. If a volume is under magazine control, the /ONSITE qualifier is not allowed. The volume inherits these values from the magazine object. If /MAGAZINE is used on the SET VOLUME command when an existing /ONSITE location and date are set, the values are cleared.
This qualifier specifies the owner of a volume. The owner field must be a UIC in the format [USER] or [group, user]. This is normally set up by MDMS on allocate volume. To clear the owner field, specify /NOOWNER.
This qualifier requires the right MDMS_SET_PROTECTED.
This qualifier defines the current placement of the volume. This is normally managed by MDMS. The following options are available:
If a magazine name is specified on the /MAGAZINE qualifier, the volume placement can be in one of three states:
During a MOVE, LOAD or UNLOAD, a volume's placement may be set to MOVING indicating that the volume is being moved. If a volume is in a magazine, it is set to MOVING when the volume is being loaded or unloaded to/from a drive.
This qualifier requires the right MDMS_SET_PROTECTED.
The pool in which the volume belongs. The maximum length of the pool name is 31 characters. Spaces are not allowed in the pool name.
This qualifier specifies whether the volume has been initialized before creation. If /PREINITIALIZED is specified, the volume is placed in the FREE state rather than the UNINITIALIZED state.
The protection code for the volume. Use the standard OpenVMS protection code format.
The date when the volume was purchased. The date should be specified as an OpenVMS absolute time. Specify /NOPURHCASED_DATE to clear the purchased date.
This qualifier specifies the record length used on the volume. The default record length is zero.
This qualifier puts the volume into the free state from the TRANSITION state. It is not valid to release an allocated volume.
The /REMOVE qualifier works in conjunction with certain qualifiers that accept lists and removes specified attributes from them.
The /REPLACE qualifier works in conjunction with certain qualifiers that accept lists and replaces the existing attributes list with the specified attributes list. By default, list attributes are added to the existing list.
This qualifier puts the volume that is in the FREE state or TRANSITION state back into the allocated state with the former owner as the current owner
The /SCRATCH_DATE qualifier specifies the planned date to return the volume from the ALLOCATED state to either the TRANSITION state or the FREE state.
Specify /NOSCRATCH_DATE if the volume should not automatically transition from the allocated state.
When a volume ID is specified on the create, this qualifier specifies the jukebox or magazine slot that the volume currently resides in. Specify a number in the range of the jukebox or magazine. This is normally set up by MDMS. If the volume does not currently reside in a jukebox or magazine slot, specify /NOSLOTS. If no volume ID is specified, or a volume range is specified, you can specify a slot list.
This qualifier requires the right MDMS_SET_PROTECTED.
When a volume ID is specified on the create, this qualifier specifies the non-jukebox space in the specified location that the volume resides in. If the volume does not reside in a location space, specify /NOSPACES.
This qualifier allows you to modify the state of the volume. This is normally set up by MDMS and is not recommended. The keyword values are:
This qualifier requires the right MDMS_SET_PROTECTED.
This qualifier allows you to specify the number of times the volume has been cleaned. The default is zero.
The /TRANSITION_TIME qualifier specifies that the volume enters the transition state when the scratch date is reached, and is to stay in the transition state for the specified delta time. When the transition time has expired, the volume enters the free state. The /NOTRANSITION_TIME qualifier specifies that the volume enters the free state directly at the scratch/deallocated date.
Puts the volume in the unavailable state. The previous state is retained for when the volume is made available again.
Specifies the user for the volume. The username can be from 1-32 characters, and must reflect an authorized VMS username. To clear the username, enter /NOUSER.
This qualifier requires the right MDMS_SET_PROTECTED.
This qualifier specifies that volume IDs are to be read using a vision system in a suitably-equipped jukebox. No volume ID or volume range should be specified when using this qualifier. Valid only on CREATE VOLUME.
This qualifier specifies that all changes apply to the entire volume set. By default, attributes apply to a single volume or volume range specified. Valid only on SET VOLUME.
$ MDMS SET VOLUME ABC001 /ONSITE=(LOCATION=SHELF2) /SPACES=AA4
This command modifies the onsite location of volume ABC001.
$ MDMS SET VOLUME SFR024 /SLOTS=24
This command modifies the jukebox slot location for volume SFR024 to slot 24.
$ MDMS SET VOLUME HS0001-HS0007 /MAGAZINE=TX877B /SLOTS=(0-6)
This command modifies the magazine and slot definition for the seven volume records HS0001 - HS0007.
The MDMS SHOW DOMAIN command displays information about the MDMS domain.
Equivalent STORAGE Command: None
The request requires MDMS_SHOW_ALL.
If the /FULL qualifier is specified, MDMS_SHOW_RIGHTS is also required.
Shows the rights assignments in the display.
This qualifier requires the right MDMS_SHOW_RIGHTS
Specifies the output file in which to send the domain information. The default is SYS$OUTPUT.
This command displays a full listing of the MDMS domain.
Description: SYSTEM MDMS Domain
Mail: SYSTEM
Offsite Location: ARCUS
Onsite Location: Houston
Def. Media Type: TK85K
Deallocate State: FREE
Opcom Class: TAPES
Request ID: 460532
Protection: S:RW,O:RW,G:R,W
DB Server Node: NABSCO
DB Server Date: 31-AUG-1999 13:16:53
Max Scratch Time: NONE
Scratch Time: 365 00:00:00
Transition Time: NONE
$ MDMS SHOW DOMAIN /OUTPUT=DOMAIN.DAT
This command outputs a full listing of the MDMS domain to file DOMAIN.DAT.
The MDMS SHOW DRIVE command displays information about specified drive(s) or all drives defined in the MDMS configuration database.
Equivalent STORAGE Command: None
Specifies the name(s) of the drive(s). Specify a drive name or a logical name. The maximum length of the drive name or logical name is 31 characters. All drives are displayed if the drive_name parameter is omitted.
Wildcard characters are allowed in the drive_name, where * represents a variable-length wildcard, and % represents a single character wildcard.
The MDMS SHOW DRIVE command displays information about specified drive(s) or all drives defined in the MDMS configuration database.
Display drive information in the brief 1-line format. This is the default display when a drive name is not specified.
When the /CHECK qualifier is specified, the drive is physically accessed to determine its availability and its state. If the state varies from what is stored in the database, the state is updated (and associated volume records are also updated) and the new values are displayed. If the check cannot be performed, the original database settings are displayed with a warning message. With the default /NOCHECK, no physical checking is performed, and the current database contents are displayed.
This qualifier requires the right MDMS_SET_OWN
Display drive information in the full multi-line format. All attributes and status fields are displayed. This is the default display when a drive name is specified.
Specifies the output file in which to send the drive information. The default is SYS$OUTPUT.
In addition, if /CHECK is specified, the option requires MDMS_SET_OWN.
This command displays a full listing of drive information for drive $1$MUA5 to
SYS$OUTPUT.
$ MDMS SHOW DRIVE /FULL $1$MUA5 /OUTPUT=DRIVES.DAT
This command displays a full listing of drive information for drive $1$MUA5 and puts the output into file DRIVE.DAT.
$ MDMS SHOW DRIVE / FULL $1$MUA110:
This command displays the following full listing of drive information for $1$MUA110:.
Drive: $1$MUA110
Description:
Device: $1$MUA110
Nodes:
Groups: SYSGRP
Volume: BTY014
Load Volume: BTY014
Disabled: NO
Shared: NO
Available: YES
State: FULL
Stacker: NO
Automatic Reply: YES
RW Media Types: DLT_IV
RO Media Types:
Access: ALL
Jukebox: TL810_1
Drive Number: 0
Allocated: NO
The "Volume" field represents the magnetic volume label read from the drive, and will show as BLANK if there is no ANSI label on the volume. The "Load Volume" field represents the volume label as indicated on the barcode label on the volume, or the requested volume name in a load volume command.
These fields should always be the same for correct ABS/HSM operation. If they are different, you should use the "Load Volume" name for unload operations, or issue an unload drive command.
The MDMS SHOW GROUP command displays information about selected groups or all groups defined in the MDMS configuration database.
Equivalent STORAGE Command: None
Specify the group names. The maximum length of the drive name or logical name is 31 characters. All groups are displayed if the group_name parameter is omitted.
Wildcard characters are allowed in the drive_name, where * represents a variable-length wildcard, and % represents a single character wildcard.
The MDMS SHOW GROUP command displays information about specified groups in the MDMS configuration database.
Display drive information in the brief 1-line format. This is the default display when a group is not specified.
Display drive information in the full multi-line format. All attributes and status fields are displayed. This is the default display when a group name is specified.
Specifies the output file in which to send the drive information. The default is SYS$OUTPUT.
This command displays a full listing of nodes in the group HOSER.
$ MDMS SHOW GROUP /OUTPUT GROUPS.DAT /FULL
This command displays a full listing of all group information and sends the output into file HOSER.DAT.
This command displays a full listing of nodes in the group HOSER.
The following is an example of this display.
Group: HOSER
Description: SPP Engineering system
Nodes: TOOKUS,GREAT,NORTH
The MDMS SHOW JUKEBOX command displays information about specified jukebox(es) or all jukeboxes defined in the MDMS configuration database.
Equivalent STORAGE Command: None
Specifies the name(s) of the jukebox(es). The maximum length of the jukebox name is 31 characters. All jukeboxes are displayed if the jukebox_name parameter is omitted.
Wildcard characters are allowed in the drive_name, where * represents a variable-length wildcard, and % represents a single character wildcard.
The MDMS SHOW JUKEBOX command displays information about specified jukebox(es) or all jukeboxes defined in the MDMS configuration database.
Display jukebox information in the brief 1-line format. This is the default display when a jukebox name is not specified.
Display jukebox information in the full multi-line format. All attributes and status fields are displayed. This is the default display when a jukebox name is specified.
Specifies the output file in which to send the jukebox information. The default is SYS$OUTPUT.
This command displays a full listing of jukebox information for jukebox JUKE_1.
$ MDMS SHOW JUKEBOX /FULL /OUTPUT=JUKE_LIST.DAT
This command displays a full listing for all jukeboxes, which is stored in file JUKE_LIST.DAT instead of SYS$OUTPUT.
$ MDMS SHOW JUKEBOX TL810_1/FULL
This command displays a full listing for MRD-controlled jukebox TL810_1, as follows:
Jukebox: TL810_1
Description: TL810 for ABS incrementals and HSM
Nodes:
Groups: SYSGRP
Location: CXN
Disabled: NO
Shared: NO
Auto Reply: YES
Access: ALL
State: AVAILABLE
Control: MRD
Robot: $1$DUA810
Slot Count: 48
Usage: NOMAGAZINE
$ MDMS SHOW JUKEBOX DCSC_JUKE_1/FULL
This command displays a full listing for DCSC-controlled jukebox DCSC_JUKE_1, as follows:
Jukebox: DCSC_JUKE_1
Description:
Nodes: FUMBLE, MUMBLE
Groups:
Location: Colorado Springs
Disabled: NO
Shared: NO
Auto Reply: YES
Access: ALL
State: AVAILABLE
Control: DCSC
Library: 1
ACS: 0
LSM: 0
Cap Sizes: 20
The MDMS SHOW LOCATION command displays information about specified location(s) or all locations defined in the MDMS configuration database.
Equivalent STORAGE Command: None
Specifies the name of the location. The maximum length of the location name is 31 characters. All locations are displayed if the location parameter is omitted.
Wildcard characters are allowed in the drive_name, where * represents a variable-length wildcard, and % represents a single character wildcard.
The MDMS SHOW LOCATION command displays information about specified location(s) or all locations defined in the MDMS configuration database.
If the location parameter is supplied, only information on the specified location(s) is displayed, which are subject to further selection based on the qualifiers.
If no location parameter is specified, the qualifiers are used for selection; if no qualifiers are specified, all locations are displayed.
Display location information in the brief 1-line format. This is the default display when a location name is not specified.
Display location information in the full multi-line format. All attributes and status fields are displayed. This is the default display when a location name is specified.
Specifies the output file in which to send the location information. The default is SYS$OUTPUT.
This command displays a brief listing of all locations.
$ MDMS SHOW LOCATION SHELF1, SHELF2, SHELF3, SHELF4 /FULL
This command displays a full listing of location information for locations SHELF1 to SHELF4.
$ MDMS SHOW LOCATION /FULL /OUTPUT=LOC_LIST.DAT
This command displays a full listing of all location information in file LOC_LIST.DAT.
$ MDMS SHOW LOCATION /FULL ARGUS
This command displays location information for ARGUS. See the following example:
Location: ARGUS
Description: Top level DB
Spaces: 20:S101-20:S200
The MDMS SHOW MAGAZINE command displays information about specified magazine(s), selected magazines, or all magazines defined in the MDMS configuration database.
Equivalent STORAGE Command: STORAGE SHOW MAGAZINE
Specifies the name(s) of the magazine(s). The maximum length of the magazine name is 31 characters. All magazines are displayed if the magazine_name parameter is omitted.
Wildcard characters are allowed in the drive_name, where * represents a variable-length wildcard, and % represents a single character wildcard.
The MDMS SHOW MAGAZINE command displays information about specified magazine(s), selected magazines, or all magazines defined in the MDMS configuration database.
Display magazine information in the brief 1-line format. This is the default display when a magazine name is not specified.
Display magazine information in the full multi-line format. All attributes and status fields are displayed. This is the default display when a magazine name is specified.
Specifies the output file in which to send the magazine information. The default is SYS$OUTPUT.
The /SCHEDULE qualifier selects magazines whose offsite or onsite date has "expired" and the magazine is not in the new location. If both dates have expired, the later of the two dates is used. The optional keywords on the /SCHEDULE qualifier may be:
If the OFFSITE keyword is used, then only those magazines scheduled to be moved offsite are selected. If the ONSITE keyword is used, then only those magazines scheduled to be moved onsite are selected. If the keyword is omitted, then the magazines scheduled to be moved onsite and offsite are selected.
This command displays a brief listing of all magazines.
$ MDMS SHOW MAGAZINE PDMAG1 /OUTPUT=PDMAG1.DAT
This command outputs a full listing of magazine information for magazine PDMAG1 to file PDMAG1.DAT.
$ MDMS SHOW MAGAZINE /SCHEDULE
This command outputs a brief listing of all magazines scheduled to be moved onsite or offsite. The following example shows the magazine display:
Magazine: MAG_1
Description:
Placement: JUKEBOX JUKE_1, START SLOT 0
Slot Count: 7
Jukebox: JUKE_1
Position:
Start Slot: 0
Onsite Loc: CXO
Spaces:
Onsite Date: NONE
Offsite Loc: VAULT
Offsite Date: NONE
The MDMS SHOW MEDIA_TYPE command displays information about specified media types or all media types defined in the MDMS configuration database.
Equivalent STORAGE Command: None
Specifies the name(s) of the media_type(s). The maximum length of the media_type name is 31characters. All media types are displayed if the media_type parameter is omitted.
Wildcard characters are allowed in the drive_name, where * represents a variable-length wildcard, and % represents a single character wildcard.
The MDMS SHOW MEDIA_TYPE command displays information about specified media type(s), selected media types, or all media types defined in the MDMS configuration database.
Display media type information in the brief 1-line format. This is the default display when a media type is not specified.
Display media type information in the full multi-line format. All attributes and status fields are displayed. This is the default display when a media type is specified.
Specifies the output file in which to send the media type information.
The default is SYS$OUTPUT.
$MDMS SHOW MEDIA_TYPE TK88K_COMP /FULL
This command displays a full listing of media_type information for media_type TK88K_COMP.
$ MDMS SHOW MEDIA_TYPE /FULL /OUTPUT=MEDIA.DAT
This command outputs a full listing of media type information for all media types to file MEDIA.DAT.
$ MDMS SHOW MEDIA_TYPE TK88K_COMP /FULL
This command displays a full listing of media_type information for media_type TK88K_COMP. See the following example:
Media type: TK85K_COMP
Description: Used for financial reports
Density: TK85
Compaction: YES
Capacity: 10000
Length: 0
The MDMS SHOW NODE command displays information about specified node(s), selected nodes, or all nodes defined in the MDMS configuration database.
Equivalent STORAGE Command: None
Specifies the name(s) of the node(s). The maximum length of the node name is 31 characters. All nodes are displayed if the node_name parameter is omitted.
Wildcard characters are allowed in the drive_name, where * represents a variable-length wildcard, and % represents a single character wildcard.
The MDMS SHOW NODE command displays information about specified node(s) or all nodes defined in the MDMS configuration database.
Display node information in the brief 1-line format. This is the default display when a node name is not specified.
Display node information in the full multi-line format. All attributes and status fields are displayed. This is the default display when a node name is specified.
Specifies the output file in which to send the node information. The default is SYS$OUTPUT.
$ MDMS SHOW NODE /FULL /OUTPUT=NODES.DAT
This command outputs a full listing of node information for all nodes to file NODES.DAT.
This command displays a full listing of node information for node DSORDS.
This command displays a listing of local node information from the startup file. Database access is not performed with this command.
This command displays a full listing of node information for node SILAGE. See the following example:
Node: SILAGE
Description: Used DB Documentation
DECnet-Plus Fullname: COMPA:.SITE.SILAGE
TCP/IP Fullname: SILAGE.SITE.COMPA.COM:2501-2510
Disabled: NO
Database Server: NO
Location: CXO
Opcom Classes: TAPES
Transports: TCPIP,DECNET
The MDMS SHOW POOL command displays information about specified pool(s), selected pools, or all pools defined in the MDMS configuration database.
Equivalent STORAGE Command: None
Specifies the name of the pool. The maximum length of the pool name is 31 characters. All pools are displayed if the pool_name parameter is omitted.
Wildcard characters are allowed in the drive_name, where * represents a variable-length wildcard, and % represents a single character wildcard.
The MDMS SHOW POOL command displays information about specified pool(s) or all pools defined in the MDMS configuration database.
Display pool information in the brief 1-line format. This is the default display when a pool name is not specified.
Display pool information in the full multi-line format. All attributes and status fields are displayed. This is the default display when a pool name is specified.
Specifies the output file in which to send the pool information. The default is SYS$OUTPUT.
$ MDMS SHOW POOL ABS_POOL /FULL
This command displays a full listing of pool information for pool ABS_POOL.
$ MDMS SHOW POOL TEST_POOL /FULL
This command displays a full listing of pool information for pool TEST_POOL. See the following example:
Pool: TEST_POOL
Description: Test_system
Authorized Users: CROPS::MAJORS,CROPS::ANDERSON
Default Users: GREAT::FRANKLIN
The MDMS SHOW REQUEST command displays information about all requests currently active on the current node. It can also display certain completed requests.
Equivalent STORAGE Command: None
Specifies an identifier to show a specific request. You can obtain a list of request IDs by issuing a SHOW REQUEST command without a request ID.
The MDMS SHOW REQUEST command displays information about all requests currently active in the domain. In addition it can also display certain completed requests. Requests can be shown with a wildcard which displays all requests subject to privilege (see below). In addition, requests for a specific user can be shown.
The request requires MDMS_SHOW_ALL, MDMS_SHOW_POOL, or MDMS_SHOW_OWN.
If the user has only MDMS_SHOW_OWN or MDMS_SHOW_POOL, only requests issued by the user are shown. To see requests of other users MDMS_SHOW_ALL is required.
Displays requests information in the brief 1-line format. This is the default display if no request_id is specified.
Displays addresses of certain objects for debugging purposes.
Displays request information in the full multi-line format. This is the default display if a request_id is specified.
Specifies the output file in which to send the requests information. The default is SYS$OUTPUT.
Restricts the request list to those issued by the specified user.
This command displays a brief listing of all requests active on the current node.
This command displays a full listing of all requests active in the domain.
This command displays a full listing of request identifier 45
MDMS SHOW REQUEST/USER_NAME=FROEHLIN
This command displays a brief listing of all requests issued by user FROEHLIN.
The following is an example of a request display:
$ MDMS SHOW REQUEST 461418/FULL
Request ID: 461418
User: HSM$SERVER
Node: SYS001.SITE.COMP.COM
Process: 28015D17
Started: 31-AUG-1999 15:42:44
Completed: 31-AUG-1999 15:42:44
State: Completed
Wait Node:
State Duration: 0 00:00:36
Function: SHOW MEDIA TYPE TL810_HSM
Ext Status: %MDMS-S-SUCCESS, success
The MDMS SHOW SERVER command displays information about the local configuration of the MDMS server on the specified node(s).
Equivalent STORAGE Command: None
The MDMS SHOW SERVER command displays information about the local configuration of the MDMS server on the specified node(s). The information is derived from the specified nodes local startup configuration files rather then the MDMS database.
This command displays MDMS version information on the current node.
$ MDMS SHOW SERVER /NODES=(COOKIE, DSORDS)
This command displays local MDMS server information for nodes COOKIE and DSORDS.
MDMS SHOW SERVER -
/NODES=(SENILE,CORP:.DOM.PARANOID,DISORDERS.DOM.CORP:3001-3010)
This command displays information about servers on DECnet (Phase IV) node SENILE, DECnet-Plus (Phase V) node PARANOID and TCP/IP node DISORDERS.
$ MDMS SHOW SERVER /NODE=SYS001
Server node name: SYS001
TCP/IP Fullname: SYS001.DOM.CORP.COM:2501-2510
DECnet-Plus Fullname:
Transports: TCPIP,DECNET
Server Version: V3.0A(246)
Logfile: MDMS$ROOT:[LOGFILE]MDMS$LOGFILE_SYS001.LOG;8
Database location: DISK$UTIL_2:[MDMS.DATABASE]
DB server search list: SYS001, SYS002, SYS003
Database access: via remote node
DB server node name: SYS003
DB node TCP/IP Fullname: SYS003.DOM.CORP.COM:2501-2510
DB node DECnet-Plus Fullname:
This shows the server on node SYS001 is only using transport DECnet via its DECnet node name of SYS001. The node has TCP/IP running but it is not used by the MDMS server.
The MDMS SHOW VERSION command displays information about the version of various MDMS components on the specified node(s).
Equivalent STORAGE Command: None
The MDMS SHOW VERSION command displays information about the version of various MDMS components on the specified node(s).
Displays information about this server. The node name is either a DECnet (Phase IV) node name, a DECnet-Plus (Phase V) node name, or a TCP/IP node name. A TCP/IP node name can include a port number range. If no port number range is specified the default is 2501-2510.
Specifies the output file in which to send the version information. The default is SYS$OUTPUT.
This command displays MDMS version information on the current node.
$ MDMS SHOW VERSION /NODE=(COOKIE::, DSORDS)
This command displays MDMS version information for nodes COOKIE and DSORDS.
$ MDMS SHOW VERSION -
/NODES=(SENILE,CORP:.DOM.PARANOID,DISORDERS.COM.CORP:3001-3010)
This command displays the version of the servers on DECnet node SENILE, DECnet-Plus node PARANOID and TCP/IP node DISORDERS.
$ MDMS SHOW VERSION
Command Line Version: V3.0A-0(230)
Shareable Image Version: V3.0A-0(230)
Server Version: V3.0A(246)
The MDMS SHOW VOLUME command displays information about specified volume(s), selected volumes, or all volumes defined in the MDMS configuration database.
Equivalent STORAGE Commands: STORAGE SHOW VOLUME
Specifies the identifier(s) of the volume(s). The maximum length of the volume ID is 6 characters. Alternatively, a volume range, separated by a dash, may be specified. A volume range is a numeric range for up to the last three characters of the volume ID. Example ranges are (ABC001-ABC250), (ABC120-ABC125). Wildcard characters are allowed in the drive_name, where * represents a variable-length wildcard, and % represents a single character wildcard.
All volumes are displayed if the volume_id parameter is omitted, subject to qualifier selection.
The MDMS SHOW VOLUME command displays information about specified volume(s), selected volumes, or all volumes defined in the MDMS configuration database.
If the volume_id parameter is supplied, only information on the specified volume(s) is displayed, which are subject to further selection based on the qualifiers.
If no volume_id parameter is specified, the qualifiers are used for selection; if no qualifiers are specified, all volumes are displayed.
The request requires MDMS_SHOW_ALL, MDMS_SHOW_POOL or MDMS_SHOW_OWN.
If the user has only MDMS_SHOW_OWN, only volumes allocated and owned by the user are displayed. If the user has MDMS_SHOW_POOL, then volumes in pools authorized to the user are displayed. To display any other volumes requires MDMS_SHOW_ALL.
/SYMBOLS can only be specified on a show of a single volume.
/ALLOCATED, /NOALLOCATED, /FORECAST, /SYMBOLS are mutually exclusive.
This qualifier displays the ABS volset records, those beginning with "&+". By default, these pseudo volume records are not displayed.
Displays only volumes that are currently either allocated or not allocated.
Display volume information in the brief 1-line format. This is the default if no volume_id parameter is specified.
Display volume information in the full multi-line format. All attributes and status fields are displayed. This is the default when a volume_id parameter is
specified.
Specifies the output file in which to send the volume information. The default is SYS$OUTPUT.
The /SCHEDULE qualifier selects volumes whose offsite or onsite date has "expired" and the volumes are not in the new location. If both dates have expired, the later of the two dates is used. The optional keyword on the schedule qualifier may be:
If the OFFSITE keyword is used, then only those volumes schedule to be moved offsite are selected. If the ONSITE keyword is used, then only those volumes scheduled to be moved onsite are selected. If the keyword is omitted, the volumes scheduled to be moved onsite and offsite are selected.
Stores selected volume information in process symbols. The symbols created are:
Selects volumes owned by this user.
This qualifier specifies that the show applies to all volumes of the volume set. By default, the show command only applies to specified volume(s).
$ MDMS SHOW VOLUME FRM001 /SYMBOLS
This command displays a full listing of volume information for volume FRM001, and stores selected information in DCL symbols.
$ MDMS SHOW VOLUME /ALLOCATED /USER_NAME=HSM$SERVER /FULL
This command displays a full listing of volume information for all volumes allocated to user HSM$SERVER.
$ MDMS SHOW VOLUME /NOALLOCATED
This command displays a brief listing of volume information for the all volumes that are not allocated, i.e. those that are in the UNINITIALIZED, FREE or TRANSITION states.
$ MDMS SHOW VOLUME BDJ530/FULL
This command displays a full listing of the volume BDJ530. See the following example:
Volume: BDJ530
Description: COOKIE INCREMENTAL BACKUPS
Placement: JUKEBOX JUKE_1
Media Types: TK85K Username: ABS
Pool: INCREMENTAL Owner UIC: [ABS]
Error Count: 0 Account: SYSTEM
Mount Count: 12 Job Name:
State: ALLOCATED Magazine:
Avail State: ALLOCATED Jukebox: JUKE_1
Previous Vol: BDJ516 Slot: 127
Next Vol: BDJ541 Drive: $1$MUA600
Format: BACKUP Offsite Loc: VAULT
Protection: S:RW,O:RW,G:R,W:R Offsite Date: NONE
Purchase: 15-AUG-1997 08:38:18 Onsite Loc: CXN
Creation: 16-DEC-1998 05:59:03 Space: Space 123
Init: 10-OCT-1998 02:00:08 Onsite Date: NONE
Allocation: 16-FEB-1999 05:59:03 Brand: COMPAQ
Scratch: 20-JAN-2000 05:59:03 Last Cleaned: 15-AUG-199708:38:18
Deallocation: NONE Times Cleaned: 1
Trans Time: NONE Rec Length: 0
Freed: 21-JAN-1999 06:21:29 Block Factor: 0
Last Access: 16-FEB-1999 07:13:54
The MDMS command starts an MDMS session.
Equivalent STORAGE Command: None.
The MDMS starts an MDMS session. The default session is a DCL session, from which you may enter multiple MDMS commands without the MDMS verb. Your prompt is MDMS>. If you enter the /INTERFACE=GUI qualifier, you will instead initiate a GUI session on the system.
The following lines need to be appended to the file SYS$STARTUP:JAVA$SETUP.COM before activating the GUI on OpenVMS:
$ DEFINE JAVA$CLASSPATH -
MDMS$ROOT:[GUI.VMS]MDMS.ZIP, -
MDMS$ROOT:[GUI.VMS]SYMANTEC.ZIP, -
MDMS$ROOT:[GUI.VMS]SWINGALL.JAR, -
SYS$COMMON:[JAVA.LIB]JDK118_CLASSES.ZIP
Before initiating the MDMS command, the following commands should be issued:
$ @SYS$STARTUP:JAVA$SETUP.COM
$ SET DISPLAY/CREATE/NODE=monitor_node_name/TRANSPORT=transport
monitor_node_name:
Is the name of the node on which the monitor resides. Depending on the transport you select, you may need to enter the TCP/IP fullname, or the DECnet-Plus fullname, rather than the DECnet Phase IV node name.
transport:
Is one of the following:
This qualifier is required to start the Graphical User Interface on an OpenVMS system.
Note that native GUIs are also provided that execute directly on Windows NT systems (Intel and Alpha) and Windows 95/98 systems. To activate these GUIs, do the following:
After activating the GUI, you may log into any OpenVMS system in the MDMS domain to manipulate MDMS. Both the Windows system and the OpenVMS system must support the
TCP/IP protocol for the GUI to access MDMS.
While using the GUI (from any system), you cannot set the SYSPRV privilege to grant all rights from the GUI. As such, the account you are logging into should have SYSPRV defined as an authorized privilege to support the SYSPRV privilege. If this is not desired, then the appropriate MDMS rights must be defined in the account.
This command initiates an MDMS DCL session.
$ SET DISPLAY/NODE=NOD001.XYZ.COM/TRANSPORT=TCPIP
$ MDMS/INTERFACE=GUI
This command initiates an MDMS GUI session on the current system (running OpenVMS V7.1 or later), on the monitor connected to node NOD001 (which can be running any OpenVMS version supporting X-windows, a UNIX operating system or a Windows NT operating system), using the TCP/IP protocol.
The MDMS UNBIND VOLUME command unbinds a volume from a volume set.
Equivalent STORAGE Command: STORAGE SPLIT
Specifies the volume ID of the volume to unbind. The maximum length of a volume ID is 6 characters.
The MDMS UNBIND VOLUME command unbinds a volume from a volume set. By default, when a volume is unbound from a volume set, all volumes in the volume set are unbound.
To cause the volume set to be split into separate volumes, use the
/VOLSET qualifier. Be aware that unbinding a volume from a volume set could cause data loss if the volume set contains valid data on every volume. Unbound volumes will remain in the ALLOCATED state.
The request requires MDMS_UNBIND_ALL or MDMS_UNBIND_OWN.
If the user has only MDMS_UNBIND_OWN, he can unbind only those volumes allocated to him. Unbinding any other volume requires MDMS_UNBIND_ALL.
The user that owns the volume set. This qualifier is used to unbind a volume from a volume set on behalf of the user. The maximum length of the username is 31 characters.
This qualifier requires the right MDMS_UNBIND_ALL
By default, the entire volume set containing the volume will be splits into single volumes.
Use the /NOVOLSET qualifier to split the volume set into two volume sets, with the second set beginning with the specified volume. Note that it is not possible to unbind the first volume of a volume set using the /NOVOLSET qualifier.
Volume set contains VOL001, VOL002, VOL003, VOL004. This command unbinds all the volumes in the volume set, leaving VOL001, VOL002, VOL003 and VOL004 all as single volumes. The volumes remain allocated.
$ MDMS UNBIND VOLUME VOL003 /USER_NAME=SMITH /NOVOLSET
Volume set contains VOL001, VOL002, VOL003, VOL004 owned by user SMITH. This command unbinds the volume set starting at VOL003 from the volume set. The remaining volume sets contain volumes VOL001 and VOL002 and the second set contains VOL003 and VOL004.
The MDMS UNLOAD DRIVE command unloads the volume contained in the specified drive.
Equivalent STORAGE Command: STORAGE UNLOAD DRIVE
Specifies the name of the drive to unload. Specify a drive name or a logical name. The maximum length of the drive name or logical name is 31 characters.
The MDMS UNLOAD DRIVE command unloads the volume currently contained in the specified drive.
The default /ASSIST qualifier requests operator assistance and prompts the operator to unload the volume from the drive. If /NOASSIST is specified, the operator is not notified.
This qualifier requires the right MDMS_ASSIST
The name of the symbol to receive the operator's reply when operator intervention is needed. The symbol will contain the operator reply to the DCL REPLY/TO or DCL REPLY/ABORT commands. The maximum length of a symbol name is 31 characters. This qualifier is only applicable when /ASSIST is specified.
The /NOWAIT qualifier returns an informational message indicating that the unload is being queued. The /WAIT qualifier causes the MDMS UNLOAD DRIVE command to wait until a drive is unloaded.
The MDMS UNLOAD VOLUME command unloads the specified volume from a drive.
Equivalent STORAGE Command: STORAGE UNLOAD VOLUME
Specifies the Volume ID of the volume to unload. The maximum length of the volume_id is 6 characters. The volume_id should be the same as the "Load Volume" field as displayed in a SHOW VOLUME command.
The MDMS UNLOAD VOLUME command will unload a volume from a drive. If the volume resides in a jukebox, it will be returned to its jukebox slot.
The request requires MDMS_UNLOAD_ALL, MDMS_UNLOAD_POOL or MDMS_UNLOAD_OWN.
If the user only has MDMS_UNLOAD_OWN, only those volumes allocated to the user can be unloaded. With MDMS_UNLOAD_POOL, the user can unload a volume in a pool to which he is authorized. Unloading any other volume requires MDMS_UNLOAD_ALL.
The default /ASSIST qualifier requests operator assistance and prompts the operator to unload the volume from the drive. If /NOASSIST is specified, the operator is not specified.
Requests operator assistance to prompt the operator to unload the volume from the drive.
This qualifier requires the right MDMS_ASSIST
The name of the symbol to receive the operator's reply when operator intervention is needed. The symbol will contain the operator reply to the DCL REPLY/TO or DCL REPLY/ABORT commands. The maximum length of a symbol name is 31 characters. This qualifier is only applicable when /ASSIST is specified.
The /NOWAIT qualifier returns an informational message indicating that the unload is being queued. The /WAIT qualifier causes the MDMS UNLOAD VOLUME command to wait until a volume is unloaded.
$ MDMS UNLOAD VOLUME VOL003 /NOWAIT
This command unloads volume VOL003 from the drive on which it is loaded and the command does not wait until the unload is complete.
MDMS V3.0A Rights and Privileges
This appendix has explanation for MDMS user rights and privileges.
Every MDMS user/potential user will be assigned zero or more rights in their SYSUAF file.
These rights will be examined on a per-command basis to determine whether a user has sufficient privilege to issue a command. The command is accepted for processing only if the user has sufficient privilege. In case the user has no rights the entire command is rejected.
Each right has a name in the following format:
Rights are looked-up on the client OpenVMS node that receives the request, as such each user must have an account on the client node.
MDMS has the following rights:
These rights are designed for a specific kind of user, to support a typical MDMS installation, and make the assignments of rights to users easy. The three high-level MDMS rights, the default right, administrator right and the additional right are described in See High Level Rights
You can disable the mapping of SYSPRV to MDMS_ALL_RIGHTS using a SET DOMAIN command
Each command or command option will be tagged with one or more low-level rights that are needed to perform the operation. Where more than one right is specified, the command indicates the appropriate combination of rights needed. The MDMS administrator can assign a set of low-level rights to each high-level right. The administrator can then simply assign the high-level right to the user.
MDMS translates the high-level right to respective low-level rights while processing a command. For additional flexibility, the user can be assigned a combination of high-level and low-level rights. The result will be a sum of all rights defined.
The default set of mapping of high-level to low-level rights will be assigned at installation (by default) and stored in the domain record. However, the MDMS administrator can change these assignments by using the SET DOMAIN command.
The low-level rights are designed to be applied to operations. A given command, with a given set of qualifiers or options, requires the sum of the rights needed for the command and all supplied options. In many cases some options require more privilege than the command, and that higher privilege will be applied to the entire command if those options are specified.
The following are usable low level rights:
Enable all operations |
|
MDMS can be defined to recognize ABS rights and map them to MDMS rights. This capability is disabled by default and can be enabled with a SET DOMAIN command. The exact mapping for ABS rights is as in See ABS Rights:
This section defines the default high to low-level mapping for each high-level right.
SET DOMAIN
/[NO]ABS_RIGHTS
/ADD
/[NO]APPLICATION_RIGHTS[=(right[,...])]
/[NO]DEFAULT_RIGHTS[=(right[,...])]
/[NO]OPERATOR_RIGHTS[=(right[,...])]
/REMOVE
/[NO]SYSPRV
/[NO]USER_RIGHTS[=(right[,...])]
SET DOMAIN /OPERATOR_RIGHTS=MDMS_SET_PROTECTED /ADD
This command adds the MDMS_SET_PROTECTED right to the operator rights list.
The MDMS installation procedure installs files and defines logical names on your system. This appendix lists the names of the files installed and logical names that are added to the system logical name -table. See MDMS File Names lists names of the files installed and See MDMS Logical Names lists the logical names that are added to the system logical names table.
See MDMS Installed Files contains the names of all MDMS files created on the system after MDMS V3.0A is successfully installed.
When the MDMS installation procedure is complete, logical names are entered into the system logical name table and stored in the startup file, SYS$STARTUP:MDMS$SYSTARTUP.COM. They are automatically entered into the system logical name table whenever the system reboots or whenever MDMS is started with this command:
See MDMS Logical Namesdescribes the logical names in the system table
This glossary contains terms defined for the Archive/Backup System for OpenVMS (ABS). It also contains terms associated with the following products when related to ABS:
A data-entry format for specifying the date or time of day. The format for absolute time is [dd-mmm-yyyy[:]][hh:mm:ss.cc]. You can specify a date and time, or use the keywords TODAY, TOMORROW, or YESTERDAY.
The port on a DCSC-controlled silo where volumes can be inserted into the silo.
MDMS server process that is currently active. The active server process responds to requests issued from an MDMS client process.
To reserve something for private use. In MDMS software, a user is able to allocate volumes or drives.
The state of a drive or volume when a process is granted exclusive use of that drive or volume. The drive or volume remains allocated until the process gives up the allocation.
One of four volume states. Volumes that are reserved for exclusive use by a user (such as ABS) are placed in the allocated state. Allocated volumes are available only to the user name (such as ABS) assigned to that volume.
The abbreviation for the American National Standards Institute, an organization that publishes computer industry standards.
A magnetic tape that complies with the ANSI standards for label, data, and record formats. The format of VMS ANSI-labeled magnetic tape volumes is based on Level 3 of the ANSI standard for magnetic tape labels and file structure.
A repository of data that consists of
The file system that contains the archived data.
The data object that resides in offline storage.
Saving data for the purpose of long-term storage.
The abbreviation for the American Standard Code for Information Interchange.
This code is a set of 8-bit binary numbers representing the alphabet, punctuation, numerals, and other special symbols used in text representation and communications protocols.
To make duplicate copies of one or more files, usually onto different media than the original media. This provides the availability to restore the original data if it is lost or corrupted.
The client or utility that performs the actual save or restore operation. Examples are the VMS BACKUP Utility and the RMU Backup Utility.
The backup engine moves data to and from the storage policy. Examples of backup engines: VMS BACKUP, RMU BACKUP, and UBS.
Standard OpenVMS BACKUP format. The BACKUP format is the recording format used by the VMS Backup utility to back up data to save sets.
A node or OpenVMS Cluster system that has control over creating save requests. A backup management domain is usually controlled by a single storage administrator.
The act of logically binding volumes into a magazine. This makes the volumes a logical unit that cannot be separated unless an UNBIND operation is done on the volumes.
The number of records in a physical tape block. The length of a physical block written to magnetic tape is determined by multiplying the record length by the blocking factor. For example, if a record length of 132 and a blocking factor of 20 are specified, the length of each physical block written to tape will be 2640 bytes (or characters).
The blocking factor is only used when MDMS software is writing an EBCDIC tape.
Contains records of data movement operations. Each time a save request is initiated, the history of the data movement operation is recorded in an associated ABS central security domain: The node or OpenVMS Cluster system where the ABS policy server is installed. This domain controls all ABS policy objects, particularly storage and environment policies.
Client nodes send database requests to the the server node.combination time: A data-entry format for specifying date and time. Combination time consists of an absolute time value plus or minus a delta time value.
An instruction, generally an English word, entered by the user at a terminal. The command requests the software to perform a predefined function.
The acronym for cyclic redundancy check. It is a verification process used to ensure data is correct.
The criteria under which ABS creates new volume sets.
The number of days (in VMS time format) between the creation of new volume sets.
The desired maximum number of volumes allowed in a volume set.
A data object specification, such as an OpenVMS file name or an Rdb/VMS database file name.
Either a save or restore request initiated through either the DCL command interface or ABS graphcial user interface.
To relinquish ownership of a drive, volume, or volume set.
The day on which an allocated volume is scheduled to go into the transition state or the free state.
A value or operation automatically included in a command or field unless the user specifies differently.
The number of bits per inch (bpi) on magnetic tape. Typical values are 6250 bpi and 1600 bpi.
A physical device, such as a tape drive or disk device.
One of four volume states. Volumes that are either damaged, lost, or temporarily removed from MDMS volume database for cleaning are placed in the down state.
Extended Binary Coded Decimal Interchange Code. EBCDIC is an unlabeled IBM recording format. Volumes in EBCDIC format do not have records in MDMS volume database.
ABS policy object that defines the environment in which data ABS save and restore requests occur.
The date and time at which an archived data is no longer considered useful. The archived data can be deleted and its space removed.
The volume state that allows volumes to be selected by users or other software applications.
The physical opening in a jukebox where volumes can be imported.
A shared physical or logical boundary between computing system components. Interfaces are used for sending and/or accepting information and control between programs, machines, and people.
The act of automatically updating MDMS database. MDMS can mount each volume located in a magazine and update MDMS volume database through this process.
A jukebox component that enables an operator to manually insert and retrieve volumes. The I/O station consists of an I/O station door on the outside of the jukebox and an I/O station slot on the inside. See also I/O station door and I/O station slot.
An actual door on the outside of the jukebox that can be opened and closed. Behind the I/O station door is the I/O station slot.
An I/O slot that holds a volume when it is entering or leaving the jukebox.
A recording format that includes a volume label.
Labeled EBCDIC format. See also EBCDIC.
The process which makes a volume physically available to the computer system, such as for read or write operations.
A symbol meaningful only to the module or DCL command procedure that defines it.
Any file into which status and error messages are written to reflect the progress of a process.
The active server node to which all MDMS database requests are sent to be serviced. In a high-availability configuration, when the active server node fails, another node (see MDMS standby server process) in the OpenVMS Cluster system becomes the active server node.
MDMS software is an OpenVMS software service that enables you to implement media and device management for your storage management operations. MDMS provides services to SLS, ABS, and HSM.
Any MDMS server process that is not currently active. The standby server process waits and becomes active if the active server process fails.
A physcial container that holds from 5 to 11 volumes. The magazine contains a set of logically bound volumes that reside in MDMS database.
MDMS database that contains the magazine name and the volume names associated with that magazine.
A mass storage unit. Media is referred to in this document as a volume. Volumes provide a physical surface on which data is stored. Examples of physical volumes are magnetic tape, tape cartridge, and optical cartridge.
A set of site-specific names associated with volume densities and drives.
Storage in which file headers are accessible through the operating system, but accessing data requires extra intervention.
Nearline storage employs a robotic device to move volumes between drives and volume storage locations. Nearline storage is less costly for each megabyte of data stored. Access times for data in nearline storage may vary. Access to data may be nearly instantaneous when a volume containing the data is already loaded in a drive. The time required for a robotic device to move to the most distant storage location, retrieve a volume, load it into a drive, and position the volume determines the maximum access time.
The devices of nearline storage technology include, but are not limited to, automated tape libraries and optical jukeboxes.
Storage in which neither the file headers nor the data is accessible by the operating system and requires extra intervention.
Offline storage requires some type of intervention to move volumes between drives and the volumes' storage location. Offline storage is the least costly for each megabyte of data stored. Access times for data in offline storage vary for the same reasons as described for nearline storage. For archive data stored in a remote vault, access time can take more than a day.
The devices of offline storage technology include, but are not limited to, standalone tape drives, optical disk drives, and sequential stack loader tape drives.
Storage in which file headers and data can be accessed through the operating system. Online storage is the most costly for each megabyte of data stored.
As a trade off, online storage also offers the highest access performance. Online storage devices offer continuous service. The devices of online storage technology include disk storage and electronic (RAM) storage that uses disk I/O channels.
OpenVMS Operator Communication Manager. An online communication tool that provides a method for users or batch jobs to request assistance from the operator, and allows the operator to send messages to interactive users.
The level of privilege required by a system operator to suspend an MDMS operation and to perform a variety of maintenance procedures on volumes, as well as archive files and saved system files.
The physical opening in a jukebox where volumes can be exported from the jukebox.
The decisions and methods in which you implement your ABS policy. This includes when and how often you back up or archive data from online to nearline or offline storage.
The component in ABS that makes intelligent decisions based upon the implementation of your ABS policy.
The method in which ABS enables you to implment your ABS policy. ABS provides the following policy objects:
ABS server component. Placement of this component determines the central security domain (CSD).
A set of volumes in the free state. Those volumes can be allocated by users who have access to the volume pool. The storage administrator creates and authorizes user access to pools.
A set of related data treated as a unit of information. For example, each volume that is added to the MDMS volume database has a record created that contains information about the volume.
The length of a record in bytes. See also blocking factor.
The label recorded on the volume.
The unique arrangement of data on a volume according to a predetermined standard. Examples of recording format are BACKUP, EBCDIC, and ANSI.
The method by which the contents of a file or disk are recovered from a volume or volumes that contain the saved data. ABS software will restore data by querying ABS catalog for the file or disk name specified in the restore request, and then locate the BACKUP save sets from one or more volumes, extract the data from those save sets, and place the information onto a Files-11 structured disk where the restored data can be accessed by a user.
A request to restore data from the archives to either its original location or an alternate location. Restore requests are initiated either through the DCL command interface or ABS graphical user interface.
The user who creates a save or restore request.
The requester profile is the profile of the user who is creating the save or restore request. This profile is captured at the time the request is created.
ABS policy object that defines the request for the restoration of data.
A tape or optical drive that provides automatic loading of volumes, such as a TF867 or a TL820.
The method by which copies of files are made on magnetic or optical volumes for later recovery or for transfer to another site.
For BACKUP formatted volumes, an ABS save operation creates BACKUP save sets on magnetic tape volume, a system disk, or optical volume.
ABS policy object that defines the request for saving data.
A file created by the VMS Backup Utility on a volume. When the VMS Backup Utility saves data, it creates a file in BACKUP format called a save set on the specified output volume. A single BACKUP save set can contain numerous files. Only BACKUP can interpret save sets and restore the data stored in the save set.
A vertical storage space for storing a volume. The storage racks and cabinets used in data centers contain multi-row slots that are labeled to easily locate stored volumes.
One or more privileged users responsible for installing, configuring, and maintaining ABS software. This user has enhanced ABS authorization rights and privileges and controls the central security domain (CSD) by creating and maintaining ABS storage and environment policies.
ABS policy object that defines where to store data saved using ABS.
The level of privilege required to install the software and add user names to the system.
An ABS system typcially saves the system disk, also known as a full disk backup. The system backup can direct ABS software to perform automatic save operations on a predefined schedule.
Volumes in the transition state are in the process of being deallocated, but are not yet fully deallocated. The transition state provides a grace period during which a volume can be reallocated to the original owner if necessary.
Unlabeled ASCII format. See also ASCII.
User identification code. The pair of numbers assigned to users, files, pools, global sections, common event flag clusters, and mailboxes. The UIC determines the owner of a file or ABS policy object. UIC-based protection determines the type of access available to the object for its owner, members of the same UIC group, system accounts, and other (world) users.
A globally unique identifier for this instance of an object.
The act of unbinding a volume or volumes from a magazine.
A recording format that does not include a recorded label.
A save request created by an individual user (not the system) when they would like to make copies of a file or set of files for later recovery or for transfer to another site.
The set of information about a user that defines the user's right to access data or the user's right to access an ABS policy object. For ABS on OpenVMS, this includes the following information:
An offsite storage location to where volumes are transferred for safekeeping.
An OpenVMS Operating System utility that performs save and restore operations on files, directories, and disks using the BACKUP recording format.
A physical piece of media (volume) that is known logically to MDMS volume database. A volume can be a single magnetic tape or disk, or as in the case of an optical cartridge, can refer to one side of double-sided media. A volume is assigned a logical name, known as the volume label.
The volume's internal identification used to verify that the correct volume has been selected. The volume label should be the same as the volume ID.
One or more volumes logically connected in a sequence to form a single volume set. A volume set can contain one or more save sets. ABS adds volumes to a volume set until the storage policy's consolidation criteria has been met or exceeded.
A volume status flag. In MDMS software, volumes are placed in one of the following states:
A nonnumeric or nonalphanumeric character such as an asterisk (*) or percent sign (%) that is used in a file specification to indicate "ALL" for a given field or portion of a field. Wildcard characters can replace all or part of the file name, file type, directory name, or version number.
ABS CREATE ENVIRONMENTcommand 1-2
ABS CREATE STORAGE_CLASS command 1-7
ABS DELETE ENVIRONMENT command 1-11
ABS DELETE RESTORE command 1-12
ABS DELETE STORAGE_CLASS command 1-14
ABS REPORT SAVE_LOG command 1-22
ABS SET ENVIRONMENT command 1-47
ABS SET STORAGE_CLASS command 1-54
ABS SHOW ENVIRONMENT command 1-56
ABS SHOW REQUEST_STATUS command 1-58
MDMS ALLOCATE DRIVE command 2-2
MDMS ALLOCATE VOLUME command 2-6
MDMS CANCEL REQUEST command 2-12
MDMS CREATE DRIVE command 2-14
MDMS CREATE GROUP command 2-18
MDMS CREATE JUKEBOX command 2-20
MDMS CREATE LOCATION command 2-25
MDMS CREATE MAGAZINE command 2-27
MDMS CREATE MEDIA_TYPE command 2-30
MDMS CREATE VOLUME command 2-38
MDMS DEALLOCATE DRIVE command 2-45
MDMS DEALLOCATE VOLUME command 2-46
MDMS DELETE DRIVE command 2-48
MDMS DELETE GROUP command 2-49
MDMS DELETE JUKEBOX command 2-50
MDMS DELETE LOCATION command 2-51
MDMS DELETE MAGAZINE command 2-52
MDMS DELETE MEDIA_TYPE command 2-53
MDMS DELETE VOLUME command 2-56
MDMS INITIALIZE VOLUME command 2-57
MDMS INVENTORY JUKEBOX command 2-60
MDMS MOVE MAGAZINE command 2-67
MDMS REPORT VOLUME command 2-73
MDMS SET LOCATION command 2-91
MDMS SET MAGAZINE command 2-92
MDMS SET MEDIA_TYPE command 2-94
MDMS SHOW DOMAIN command 2-107
MDMS SHOW JUKEBOX command 2-113
MDMS SHOW LOCATION command 2-115
MDMS SHOW MAGAZINE command 2-117
MDMS SHOW MEDIA_TYPE command 2-119
MDMS SHOW REQUESTS command 2-125
MDMS SHOW VERSION command 2-129
MDMS SHOW VOLUME command 2-130
MDMS UNBIND VOLUME command 2-136
MDMS UNLOAD DRIVE command 2-138
ABS CREATE ENVIRONMENTcommand 1-2
ABS CREATE STORAGE_CLASS command 1-7
ABS DELETE ENVIRONMENT command 1-11
ABS DELETE RESTORE command 1-12
ABS DELETE STORAGE_CLASS command 1-14
ABS REPORT SAVE_LOG command 1-22
ABS SET ENVIRONMENT command 1-47
ABS SET STORAGE_CLASS COMMAND 1-54
ABS SHOW ENVIRONMENT command 1-56