Administrator’s Guide Release 8 · Using cmd_proc in Curses Mode..... 1-3 Example - Default...

496
[1]StorageTek Automated Cartridge System Library Software Administrator’s Guide Release 8.5 E96380-05 June 2020

Transcript of Administrator’s Guide Release 8 · Using cmd_proc in Curses Mode..... 1-3 Example - Default...

  • [1]StorageTek Automated Cartridge System LibrarySoftwareAdministrator’s Guide

    Release 8.5

    E96380-05

    June 2020

  • StorageTek Automated Cartridge System Library Software Administrator's Guide, Release 8.5

    E96380-05

    Copyright © 2019, 2020, Oracle and/or its affiliates.

    This software and related documentation are provided under a license agreement containing restrictions onuse and disclosure and are protected by intellectual property laws. Except as expressly permitted in yourlicense agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license,transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverseengineering, disassembly, or decompilation of this software, unless required by law for interoperability, isprohibited.

    The information contained herein is subject to change without notice and is not warranted to be error-free. Ifyou find any errors, please report them to us in writing.

    If this is software or related documentation that is delivered to the U.S. Government or anyone licensing iton behalf of the U.S. Government, then the following notice is applicable:

    U.S. GOVERNMENT END USERS: Oracle programs (including any operating system, integrated software,any programs embedded, installed or activated on delivered hardware, and modifications of suchprograms) and Oracle computer documentation or other Oracle data delivered to or accessed by U.S.Government end users are "commercial computer software" or "commercial computer softwaredocumentation" pursuant to the applicable Federal Acquisition Regulation and agency-specificsupplemental regulations. As such, the use, reproduction, duplication, release, display, disclosure,modification, preparation of derivative works, and/or adaptation of i) Oracle programs (including anyoperating system, integrated software, any programs embedded, installed or activated on deliveredhardware, and modifications of such programs), ii) Oracle computer documentation and/or iii) other Oracledata, is subject to the rights and limitations specified in the license contained in the applicable contract. Theterms governing the U.S. Government's use of Oracle cloud services are defined by the applicable contractfor such services. No other rights are granted to the U.S. Government.

    This software or hardware is developed for general use in a variety of information managementapplications. It is not developed or intended for use in any inherently dangerous applications, includingapplications that may create a risk of personal injury. If you use this software or hardware in dangerousapplications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and othermeasures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damagescaused by use of this software or hardware in dangerous applications.

    Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks oftheir respective owners.

    Intel and Intel Inside are trademarks or registered trademarks of Intel Corporation. All SPARC trademarksare used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD,Epyc, and the AMD logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is aregistered trademark of The Open Group.

    This software or hardware and documentation may provide access to or information about content,products, and services from third parties. Oracle Corporation and its affiliates are not responsible for andexpressly disclaim all warranties of any kind with respect to third-party content, products, and servicesunless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and itsaffiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use ofthird-party content, products, or services, except as set forth in an applicable agreement between you andOracle.

  • iii

    Contents

    Preface ............................................................................................................................................................ xxvii

    Documentation Accessibility ................................................................................................................ xxvii

    1 Overview

    About ACSLS ........................................................................................................................................... 1-1The acssa and acsss User IDs ................................................................................................................ 1-1

    Logging in Remotely.......................................................................................................................... 1-1Starting and Stopping ACSLS ............................................................................................................... 1-2

    The acsss command ........................................................................................................................... 1-2Changing ACSLS Run State.............................................................................................................. 1-2

    Using cmd_proc ....................................................................................................................................... 1-2Starting cmd_proc .............................................................................................................................. 1-2Suspending and Resuming cmd_proc ............................................................................................ 1-3Terminating cmd_proc ...................................................................................................................... 1-3Using cmd_proc in Curses Mode..................................................................................................... 1-3

    Example - Default Curses Mode............................................................................................... 1-3Limited Command History, Limited Length in Curses Mode............................................. 1-3

    Using cmd_proc in Line Mode......................................................................................................... 1-4Status Messages Intermixed with Commands in Line Mode............................................... 1-4

    cmd_proc Keyboard Shortcuts in cmd_proc (curses and line modes) ...................................... 1-4Using cmd_proc in Shell-Friendly Mode (cmd_proc_shell) ........................................................ 1-5Redirecting Input to cmd_proc - Input Files and Command Scripts ......................................... 1-5Redirecting Output from cmd_proc................................................................................................ 1-6ACSLS Directory Structure .............................................................................................................. 1-6

    2 Starting and Monitoring ACSLS

    Starting ACSLS ........................................................................................................................................ 2-1Monitoring ACSLS ................................................................................................................................. 2-1Stopping ACSLS ...................................................................................................................................... 2-2SMF Timeout on Solaris ........................................................................................................................ 2-2ACSLS Startup Policy ............................................................................................................................. 2-2

    Additional Startup Time .................................................................................................................. 2-2Desired (offline) Startup State for an ACS ..................................................................................... 2-3

  • iv

    3 ACSLS GUI

    Starting the ACSLS GUI ........................................................................................................................ 3-1Administering GUI Users and Passwords .................................................................................... 3-2

    Overview of the GUI .............................................................................................................................. 3-2The GUI Welcome Screen ................................................................................................................ 3-2Masthead ............................................................................................................................................ 3-3

    Alarms Color Codes .................................................................................................................. 3-4System Preferences ............................................................................................................. 3-4

    Navigation Tree ................................................................................................................................. 3-5Overview and Status ................................................................................................................. 3-5Configuration and Administration ......................................................................................... 3-6

    The Log Viewer ................................................................................................................... 3-6System Events ...................................................................................................................... 3-6Logical Library Configuration .......................................................................................... 3-6

    Tape Library Operations ........................................................................................................... 3-6Tape Libraries & Drives ............................................................................................................ 3-6

    System Operations Excluded in the ACSLS 8.5 GUI ................................................................... 3-7Firewall and the GUI .............................................................................................................................. 3-7

    On Solaris ........................................................................................................................................... 3-8On Linux ............................................................................................................................................. 3-8Configuring a Self-Assigned Digital Certificate for HTTPS ....................................................... 3-9

    4 Installing and Configuring Your Library Hardware

    Installing Connections to Your Library Hardware ........................................................................... 4-1Adding the SCSI mchanger Device Driver .................................................................................... 4-1Enabling SL8500 or SL3000 Dual TCP/IP Support ...................................................................... 4-2Synchronizing SL4000 Library and ACSLS Server Clock ............................................................ 4-2Configuring or Reconfiguring Library Hardware ....................................................................... 4-2

    Using acsss_config to Configure Your Library Hardware .............................................................. 4-3Before Running acsss_config for the SL4000.................................................................................. 4-4Running acsss_config ........................................................................................................................ 4-5

    Renumbering an ACS ............................................................................................................................. 4-9

    5 Setting Variables that Control ACSLS Behavior

    Accessing the ACSLS Feature Configuration Menu ......................................................................... 5-2Verifying and Changing Dynamic and Static Variables .................................................................. 5-3

    Setting CSI Tuning Variables............................................................................................................ 5-3Setting Event Logging Variables...................................................................................................... 5-6Setting General Product Behavior Variables.................................................................................. 5-8Setting Access Control Variables .................................................................................................. 5-15Setting Automatic Backup Variables............................................................................................ 5-16Rebuilding Access Control Information ...................................................................................... 5-17Defining Event Notification Settings............................................................................................ 5-17Configuring or Updating your Library Hardware .................................................................... 5-18Setting OSCI Variables with dv_config ....................................................................................... 5-18

    Registering for Email Notification of System Events .................................................................... 5-19

  • v

    6 Access Control

    Volume Access Control .......................................................................................................................... 6-1Enabling Volume Access Control ................................................................................................... 6-1Defining other users that are allowed access to the user's volumes .......................................... 6-3Establishing Ownership of Your Volumes .................................................................................... 6-4

    Ownership policies .................................................................................................................... 6-4Verifying Ownership ................................................................................................................. 6-5

    Volume Access Summary ................................................................................................................ 6-5Command Access Control ...................................................................................................................... 6-6

    Enabling Command Access Control .............................................................................................. 6-6Associating a client identity with a user name ............................................................................. 6-7Defining What Commands are Available to Which Users ......................................................... 6-7

    Command Names for Command Access Control allow and disallow Files ..................... 6-7Logging Access Control Messages ....................................................................................................... 6-9

    7 Library Management

    Specifying ACS Numbers ...................................................................................................................... 7-1Reconfiguring ACSLS When Tape Drives are Moved, Added, or Removed .............................. 7-2

    Updating Tape Drives Configured to ACSLS ............................................................................... 7-2Auditing the Library ............................................................................................................................... 7-3

    How Audit Works ............................................................................................................................. 7-3When to Run an Audit ..................................................................................................................... 7-3Audit Intervals ................................................................................................................................... 7-4

    Adding a SCSI or fibre-attached library to ACSLS ........................................................................... 7-4Using the Extended Store Feature ........................................................................................................ 7-4Managing a Mixed-Media Library ....................................................................................................... 7-6

    Displaying the ACSLS Mixed-Media Settings .............................................................................. 7-6Mixed-Media Restrictions for SCSI-Attached LSMs .................................................................... 7-7Setting Scratch Preferences .............................................................................................................. 7-7

    User-Defined Mixed-Media Files ............................................................................................ 7-7System-Defined Mixed-Media Files ........................................................................................ 7-8How ACSLS Uses the Mixed-Media Files .............................................................................. 7-8Defining a Scratch Preferences File ......................................................................................... 7-8

    Managing Dual TCP/IP Connections .................................................................................................. 7-9Managing a Dual-LAN Client Configuration .................................................................................... 7-9

    Registering the IP Addresses of Primary and Secondary LANs ............................................. 7-10Installing a Second Ethernet Port for a Multi-Homed ACSLS Server .................................... 7-10Setting the TCP/IP Connection Timeout Interval ..................................................................... 7-11

    Registering for Event Notification .................................................................................................... 7-11Automatic Recovery to Desired State ............................................................................................... 7-11

    Current state and desired state ..................................................................................................... 7-12Current state cascades down, desired state does not ................................................................ 7-12

    Queue and Retry Mounts and Dismounts when Library is Temporarily Unavailable ......... 7-13Reconfiguring ACSLS When Tape Drives are Moved, Added, or Removed ........................... 7-13

    Updating Tape Drives Configured to ACSLS ............................................................................ 7-14Media Validation .................................................................................................................................. 7-15

  • vi

    Adding Drives to the Media Validation Pool ............................................................................ 7-15Removing Drives from the Media Validation Pool ................................................................... 7-15

    8 Cartridge Management

    Populating the LSM ................................................................................................................................ 8-2Using the CAP .......................................................................................................................................... 8-2

    CAP Types .......................................................................................................................................... 8-2CAP States .......................................................................................................................................... 8-2CAP Modes ........................................................................................................................................ 8-3CAP Priorities .................................................................................................................................... 8-4Displaying CAP Information ........................................................................................................... 8-5

    Entering Cartridges ................................................................................................................................. 8-5Terminating an Enter Request ......................................................................................................... 8-6

    Ejecting Cartridges .................................................................................................................................. 8-7Recovering CAPs ..................................................................................................................................... 8-7

    General CAP Recovery Procedures ................................................................................................ 8-7Complete Enters and Ejects Before Doing CAP Recovery ................................................... 8-7Recover a Hung CAP by Varying it with Offline Force Then Online ................................ 8-7

    Recovering a CAP After Opening the Access Door ..................................................................... 8-8CAP used for automatic enter will not unlock ...................................................................... 8-8CAP used for manual enter will not unlock .......................................................................... 8-8CAP used for ejects will not unlock ........................................................................................ 8-8

    Automatically Applying Policies to New and Reactivated Cartridges ......................................... 8-9Automatic Assignment of Cleaning Cartridge Attributes .......................................................... 8-9watch_vols Policies ........................................................................................................................... 8-9

    Cleaning Cartridges ............................................................................................................................. 8-10Automatic Cleaning by ACSLS .................................................................................................... 8-10Cleaning Cartridge Maximum Usage ......................................................................................... 8-11Manually Defining Cleaning Cartridges .................................................................................... 8-11Monitoring Cleaning Cartridges .................................................................................................. 8-11Entering Cleaning Cartridges ....................................................................................................... 8-12Ejecting Used Cleaning Cartridges .............................................................................................. 8-12Manually Cleaning a Drive ........................................................................................................... 8-13Cleaning Cartridges on Fibre-Attached Libraries ..................................................................... 8-14What To Do When Drives Are Not Being Cleaned ................................................................... 8-14

    Verify Auto-Cleaning is Enabled .......................................................................................... 8-14Verify there are Cleaning Cartridges for the Drives .......................................................... 8-14Verify Auto-Cleaning is Disabled Using SL Console for an SL8500 or SL3000 Library ..........8-14Check if Cleaning Cartridges are Marked as Questionable .............................................. 8-15

    Managing Scratch Cartridges ............................................................................................................. 8-15Displaying Scratch Pool and Scratch Cartridge Information .................................................. 8-16Adding Scratch Cartridges to the Library .................................................................................. 8-16Rebalancing Scratch Pools ............................................................................................................ 8-17Deleting Scratch Pools ................................................................................................................... 8-17

    Emptying a Scratch Pool ........................................................................................................ 8-17Deleting a Single Pool ............................................................................................................. 8-18

  • vii

    Deleting All Empty Pools ...................................................................................................... 8-18Mounting Scratch Cartridges ....................................................................................................... 8-18

    Single-Media Environments .................................................................................................. 8-18Mixed-Media Environments ................................................................................................. 8-18

    Unscratching Cartridges ............................................................................................................... 8-19Using Absent and Ejected Cartridge Support ................................................................................ 8-19Absent, Ejected and Missing Cartridges .......................................................................................... 8-20

    Cartridge (Volume) Status Reporting ......................................................................................... 8-20Cartridge Recovery ............................................................................................................................... 8-21Missing Cartridges ............................................................................................................................... 8-21Absent and Ejected Cartridge ............................................................................................................ 8-22

    Cartridges Not Found .................................................................................................................... 8-22Cartridges Found ........................................................................................................................... 8-22

    Using the Manual Volume Delete Utility ....................................................................................... 8-22Identifying Expired Cartridges .......................................................................................................... 8-23

    Cartridge End-of-Life Percentages .............................................................................................. 8-23Access Counts ................................................................................................................................. 8-24ACSLS Cartridge Mount Count Details ...................................................................................... 8-24Cartridge Warranty and End-of-life Thresholds ....................................................................... 8-25

    Moving Least-Recently Accessed Cartridges from Active LSMs ............................................... 8-25Identify the LSMs with too Few Free Cells and LSMs with Empty Cells .............................. 8-26Review Cartridges in an LSM by Access Date ........................................................................... 8-26

    Ensure Access Date is Reported for Easy Sorting .............................................................. 8-26Look at the Distribution of Last Access Dates for Cartridges in an LSM ....................... 8-26

    Move the cartridges from Full LSMs to LSMs with Empty Cells ........................................... 8-27Create Lists of Cartridges to Move ....................................................................................... 8-27Move the Cartridges to an LSM with Free Space ............................................................... 8-27

    Manually Loading Cartridges Into Drives in a Disabled LSM ................................................... 8-27

    9 Database Administration

    Utilities Used ............................................................................................................................................ 9-1Exporting the Database .......................................................................................................................... 9-2

    Removing Unsupported Tape Libraries, Drives, and Cartridges Before Exporting to an EarlierRelease 9-3Removing Logical Libraries before Exporting to Linux .............................................................. 9-3Exporting to a Disk File .................................................................................................................... 9-3Exporting to Tape .............................................................................................................................. 9-4

    Importing the Database .......................................................................................................................... 9-5Importing From a Disk File ............................................................................................................. 9-6Importing from Tape ........................................................................................................................ 9-8

    Migrating mchangers for Fibre to a New Platform ........................................................................... 9-8Record Details about Fibre-attached Libraries on the Old ACSLS Server ................................ 9-9Reconfigure ACSLS to Change mchanger Names for Fibre-attached Libraries ...................... 9-9

    Verifying the Imported Database and Library Configuration .................................................... 9-10Automatic Database Backup .............................................................................................................. 9-11Performing Manual Backups to Tape ............................................................................................... 9-11Backing up to a Specified Tape Device Attached to the ACSLS Server .................................... 9-11

  • viii

    Backing up to a UNIX File .................................................................................................................. 9-12Recovering and Restoring ................................................................................................................... 9-12Restoring the Database to the Most Recent Backup ...................................................................... 9-13Recovering from a Failed Server ....................................................................................................... 9-13Restoring ACSLS Control Files ......................................................................................................... 9-14

    10 Reporting and Logging

    Creating a Custom Volume Report.................................................................................................... 10-1Custom Volume Report.................................................................................................................. 10-1

    Custom Volume Report Example.......................................................................................... 10-3Creating a Logging Volume Statistics Report ................................................................................. 10-3

    11 Utility Reference

    Overview ................................................................................................................................................ 11-2Legacy Start/Stop Scripts ............................................................................................................. 11-3

    Utility Commands ................................................................................................................................ 11-3acs_partition.sh................................................................................................................................ 11-3acs_renumber.sh ............................................................................................................................. 11-4acs_rewallet.sh................................................................................................................................. 11-6The acsss Macro .............................................................................................................................. 11-7

    Format ....................................................................................................................................... 11-7Options ..................................................................................................................................... 11-8

    bdb.acsss .......................................................................................................................................... 11-8Format ....................................................................................................................................... 11-9Options ..................................................................................................................................... 11-9Usage ......................................................................................................................................... 11-9

    Dynamic Configuration (config) utilities .................................................................................. 11-10Limitations of Dynamic Configuration .............................................................................. 11-11Things You Should Not Do ................................................................................................. 11-11

    config acs ....................................................................................................................................... 11-11Format ..................................................................................................................................... 11-12Adding a new ACS ............................................................................................................... 11-12Reconfiguring an existing ACS ........................................................................................... 11-13Limitation of config acs ........................................................................................................ 11-13

    config drives .................................................................................................................................. 11-13Format ..................................................................................................................................... 11-14Usage ....................................................................................................................................... 11-14

    config lsm ...................................................................................................................................... 11-14Format ..................................................................................................................................... 11-14Usage ....................................................................................................................................... 11-14Limitation of config lsm ....................................................................................................... 11-15

    config ports .................................................................................................................................... 11-15Format ..................................................................................................................................... 11-15Usage ....................................................................................................................................... 11-15Limitations of config ports ................................................................................................... 11-16

    db_export.sh .................................................................................................................................. 11-16Format ..................................................................................................................................... 11-16

  • ix

    Options ................................................................................................................................... 11-16Usage ....................................................................................................................................... 11-17

    db_import.sh ................................................................................................................................. 11-17Format ..................................................................................................................................... 11-17Options ................................................................................................................................... 11-17Usage ....................................................................................................................................... 11-17

    db_restore.sh ................................................................................................................................. 11-18Format ..................................................................................................................................... 11-18Options ................................................................................................................................... 11-18Usage ....................................................................................................................................... 11-18

    del_vol ............................................................................................................................................ 11-18Format ..................................................................................................................................... 11-19Options ................................................................................................................................... 11-19Usage ....................................................................................................................................... 11-19Example .................................................................................................................................. 11-20

    drives_media.sh ............................................................................................................................ 11-20Format ..................................................................................................................................... 11-20Options ................................................................................................................................... 11-20

    ejecting.sh ...................................................................................................................................... 11-20Format ..................................................................................................................................... 11-21Options ................................................................................................................................... 11-21ejecting.sh Logs ...................................................................................................................... 11-23

    free_cells.sh ................................................................................................................................... 11-23Format ..................................................................................................................................... 11-23Option ..................................................................................................................................... 11-23

    getHba.sh ....................................................................................................................................... 11-23Format ..................................................................................................................................... 11-23

    greplog ........................................................................................................................................... 11-25Format ..................................................................................................................................... 11-25Options ................................................................................................................................... 11-25Usage ....................................................................................................................................... 11-26

    install_scsi_Linux.sh .................................................................................................................... 11-26Format ..................................................................................................................................... 11-26

    lib_type.sh ..................................................................................................................................... 11-26Format ..................................................................................................................................... 11-26

    moving.sh ...................................................................................................................................... 11-27Format ..................................................................................................................................... 11-27Usage ....................................................................................................................................... 11-27Examples ................................................................................................................................ 11-32

    probeFibre.sh ................................................................................................................................ 11-33Format ..................................................................................................................................... 11-34Options ................................................................................................................................... 11-34

    rdb.acsss ......................................................................................................................................... 11-34Format ..................................................................................................................................... 11-34Menu Options ........................................................................................................................ 11-34See: ........................................................................................................................................... 11-37

    showDevs.sh ................................................................................................................................. 11-37

  • x

    Format ..................................................................................................................................... 11-37Options ................................................................................................................................... 11-37

    showDrives.sh .............................................................................................................................. 11-37Format ..................................................................................................................................... 11-38

    stats_report .................................................................................................................................... 11-38Format ..................................................................................................................................... 11-38Usage ....................................................................................................................................... 11-38

    userAdmin.sh ............................................................................................................................... 11-39Format ..................................................................................................................................... 11-40

    volrpt .............................................................................................................................................. 11-41Format ..................................................................................................................................... 11-41Options ................................................................................................................................... 11-41Usage ....................................................................................................................................... 11-42Examples ................................................................................................................................ 11-43

    watch_vols ..................................................................................................................................... 11-45Format ..................................................................................................................................... 11-45Usage ....................................................................................................................................... 11-45Example .................................................................................................................................. 11-46

    12 Command Reference

    General Command Syntax .................................................................................................................. 12-2Component Types and Identifiers .................................................................................................... 12-3Common Command Error Messages ................................................................................................ 12-5Commands ............................................................................................................................................. 12-5

    audit ................................................................................................................................................. 12-5Format ....................................................................................................................................... 12-6Usage ......................................................................................................................................... 12-6Examples .................................................................................................................................. 12-8Command Area Messages ..................................................................................................... 12-8Display Area Messages ........................................................................................................ 12-10

    cancel .............................................................................................................................................. 12-10Format ..................................................................................................................................... 12-10Options ................................................................................................................................... 12-10Examples ................................................................................................................................ 12-12Command Area Messages ................................................................................................... 12-13Display Area Messages ....................................................................................................... 12-13

    clear lock ........................................................................................................................................ 12-13Format ..................................................................................................................................... 12-13Options ................................................................................................................................... 12-13Usage ....................................................................................................................................... 12-14Examples ................................................................................................................................ 12-14Command Area Messages ................................................................................................... 12-14Display Area Messages ........................................................................................................ 12-15

    define pool ..................................................................................................................................... 12-15Format ..................................................................................................................................... 12-15Options ................................................................................................................................... 12-15Usage ....................................................................................................................................... 12-15

  • xi

    Examples ................................................................................................................................ 12-15Command Area Messages ................................................................................................... 12-16Display Area Messages ........................................................................................................ 12-16

    delete pool ..................................................................................................................................... 12-16Format ..................................................................................................................................... 12-17Options ................................................................................................................................... 12-17Usage ....................................................................................................................................... 12-17Examples ................................................................................................................................ 12-17Command Area Messages ................................................................................................... 12-18

    dismount ........................................................................................................................................ 12-18Format ..................................................................................................................................... 12-18Options ................................................................................................................................... 12-18Usage ....................................................................................................................................... 12-18Examples ................................................................................................................................ 12-19Command Area Messages ................................................................................................... 12-20Display Area Messages ........................................................................................................ 12-21

    eject ................................................................................................................................................. 12-21Format ..................................................................................................................................... 12-22Options ................................................................................................................................... 12-22Usage ....................................................................................................................................... 12-23Examples ................................................................................................................................ 12-23Command Area Messages ................................................................................................... 12-24Display Area Messages ........................................................................................................ 12-25

    enter ................................................................................................................................................ 12-25Options ................................................................................................................................... 12-26Usage ....................................................................................................................................... 12-27Examples ................................................................................................................................ 12-27Command Area Messages ................................................................................................... 12-27Display Area Messages ........................................................................................................ 12-28

    idle .................................................................................................................................................. 12-29Format ..................................................................................................................................... 12-29Options ................................................................................................................................... 12-29Usage ....................................................................................................................................... 12-29Examples ................................................................................................................................ 12-30Command Area Messages ................................................................................................... 12-30Display Area Messages ........................................................................................................ 12-30

    lock ................................................................................................................................................. 12-30Format ..................................................................................................................................... 12-31Options ................................................................................................................................... 12-31Usage ....................................................................................................................................... 12-31Examples ................................................................................................................................ 12-31Command Area Messages ................................................................................................... 12-32Display Area Messages ........................................................................................................ 12-32

    logoff .............................................................................................................................................. 12-32Format ..................................................................................................................................... 12-33Options ................................................................................................................................... 12-33Usage ....................................................................................................................................... 12-33

  • xii

    Examples ................................................................................................................................ 12-33Command Area Messages ................................................................................................... 12-33Display Area Messages ........................................................................................................ 12-33

    mount ............................................................................................................................................. 12-33Format ..................................................................................................................................... 12-33Options ................................................................................................................................... 12-33Usage ....................................................................................................................................... 12-34Examples ................................................................................................................................ 12-34Command Area Messages ................................................................................................... 12-35Display Area Messages ........................................................................................................ 12-36

    mount * .......................................................................................................................................... 12-36Format ..................................................................................................................................... 12-36Options ................................................................................................................................... 12-36Usage ....................................................................................................................................... 12-36Examples ................................................................................................................................ 12-37Command Area Messages ................................................................................................... 12-38Display Area Messages ....................................................................................................... 12-39

    move ............................................................................................................................................... 12-39Format ..................................................................................................................................... 12-39Options ................................................................................................................................... 12-40Usage ....................................................................................................................................... 12-40Examples ................................................................................................................................ 12-40Command Area Messages ................................................................................................... 12-40

    query commands .......................................................................................................................... 12-41Format ..................................................................................................................................... 12-41Command Area Messages ................................................................................................... 12-41Display Area Messages ........................................................................................................ 12-42

    query acs ........................................................................................................................................ 12-42Format ..................................................................................................................................... 12-42Options ................................................................................................................................... 12-42Usage ....................................................................................................................................... 12-42Examples ................................................................................................................................ 12-43

    query cap ....................................................................................................................................... 12-43Format ..................................................................................................................................... 12-43Options ................................................................................................................................... 12-43Usage ....................................................................................................................................... 12-43Examples ................................................................................................................................ 12-45

    query clean .................................................................................................................................... 12-45Format ..................................................................................................................................... 12-45Options ................................................................................................................................... 12-45Usage ....................................................................................................................................... 12-45Examples ................................................................................................................................ 12-46

    query drive .................................................................................................................................... 12-46Format ..................................................................................................................................... 12-46Options ................................................................................................................................... 12-46Usage ....................................................................................................................................... 12-46Examples ................................................................................................................................ 12-47

  • xiii

    query lmu ...................................................................................................................................... 12-48Format ..................................................................................................................................... 12-48Options ................................................................................................................................... 12-48Usage ....................................................................................................................................... 12-48Examples ................................................................................................................................ 12-50

    query lock ...................................................................................................................................... 12-50Format ..................................................................................................................................... 12-51Options ................................................................................................................................... 12-51Usage ....................................................................................................................................... 12-51Examples ................................................................................................................................ 12-52

    query lsm ....................................................................................................................................... 12-52Format ..................................................................................................................................... 12-52Options ................................................................................................................................... 12-52Examples ................................................................................................................................ 12-53

    query mount .................................................................................................................................. 12-53Format ..................................................................................................................................... 12-54Options ................................................................................................................................... 12-54Usage ....................................................................................................................................... 12-54Examples ................................................................................................................................ 12-55

    query mount * ............................................................................................................................... 12-55Format ..................................................................................................................................... 12-55Options ................................................................................................................................... 12-55Usage ....................................................................................................................................... 12-56Examples ................................................................................................................................ 12-57

    query pool ..................................................................................................................................... 12-57Format ..................................................................................................................................... 12-57Options ................................................................................................................................... 12-57Usage ....................................................................................................................................... 12-57Examples ................................................................................................................................ 12-58

    query port ...................................................................................................................................... 12-58Format ..................................................................................................................................... 12-58Options ................................................................................................................................... 12-58Usage ....................................................................................................................................... 12-58Examples ................................................................................................................................ 12-59

    query request ................................................................................................................................ 12-59Format ..................................................................................................................................... 12-59Options ................................................................................................................................... 12-59Usage ....................................................................................................................................... 12-59Examples ................................................................................................................................ 12-60

    query scratch ................................................................................................................................. 12-60Format ..................................................................................................................................... 12-60Options ................................................................................................................................... 12-60Usage ....................................................................................................................................... 12-60Examples ................................................................................................................................ 12-61

    query server .................................................................................................................................. 12-61Format ..................................................................................................................................... 12-61Options ................................................................................................................................... 12-61

  • xiv

    Usage ....................................................................................................................................... 12-61Examples ................................................................................................................................ 12-62

    query volume ................................................................................................................................ 12-62Format ..................................................................................................................................... 12-62Options ................................................................................................................................... 12-62Usage ....................................................................................................................................... 12-62Examples ................................................................................................................................ 12-63

    set commands ............................................................................................................................... 12-64Format ..................................................................................................................................... 12-64Command Area Messages ................................................................................................... 12-64Display Area Messages ........................................................................................................ 12-64

    set cap mode .................................................................................................................................. 12-64Format ..................................................................................................................................... 12-64Options ................................................................................................................................... 12-64Usage ....................................................................................................................................... 12-65Examples ................................................................................................................................ 12-65Command Area Messages ................................................................................................... 12-65

    set cap priority .............................................................................................................................. 12-66Format ..................................................................................................................................... 12-66Options ................................................................................................................................... 12-66Usage ....................................................................................................................................... 12-66Examples ................................................................................................................................ 12-66Command Area Messages ................................................................................................... 12-67Display Area Messages ........................................................................................................ 12-67

    set clean .......................................................................................................................................... 12-67Format ..................................................................................................................................... 12-67Options ................................................................................................................................... 12-67Usage ....................................................................................................................................... 12-68Examples ................................................................................................................................ 12-68Command Area Messages ................................................................................................... 12-68Display Area Messages ........................................................................................................ 12-69

    set lock ........................................................................................................................................... 12-69Format ..................................................................................................................................... 12-69Options ................................................................................................................................... 12-69Usage ....................................................................................................................................... 12-69Examples ................................................................................................................................ 12-69Command Area Messages ................................................................................................... 12-70Display Area Messages ........................................................................................................ 12-70

    set owner ....................................................................................................................................... 12-70Format ..................................................................................................................................... 12-70Options ................................................................................................................................... 12-70Usage ....................................................................................................................................... 12-70Examples ................................................................................................................................ 12-70Command Area Messages ................................................................................................... 12-71Display Area Messages ........................................................................................................ 12-71

    set scratch ...................................................................................................................................... 12-71Format ..................................................................................................................................... 12-71

  • xv

    Options ................................................................................................................................... 12-71Usage ....................................................................................................................................... 12-71Examples ................................................................................................................................ 12-71Command Area Messages ................................................................................................... 12-72Display Area Messages ........................................................................................................ 12-72

    show ............................................................................................................................................... 12-73Format ..................................................................................................................................... 12-73Options ................................................................................................................................... 12-73Usage ....................................................................................................................................... 12-73Examples ................................................................................................................................ 12-73Command Area Messages ................................................................................................... 12-73Display Area Messages ........................................................................................................ 12-74

    start ................................................................................................................................................. 12-74Format ..................................................................................................................................... 12-74Options ................................................................................................................................... 12-74Usage ....................................................................................................................................... 12-74Examples ................................................................................................................................ 12-74Command Area Messages ................................................................................................... 12-74Display Area Messages ........................................................................................................ 12-75

    switch lmu ..................................................................................................................................... 12-75Format ..................................................................................................................................... 12-75Options ................................................................................................................................... 12-75Usage ....................................................................................................................................... 12-75Examples ................................................................................................................................ 12-75Command Area Messages ................................................................................................... 12-76Display Area Messages ........................................................................................................ 12-77

    unlock ............................................................................................................................................. 12-77Format ..................................................................................................................................... 12-77Options ................................................................................................................................... 12-77Usage ....................................................................................................................................... 12-77Examples ................................................................................................................................ 12-77Command Area Messages ................................................................................................... 12-78Display Area Messages ........................................................................................................ 12-78

    uptime ............................................................................................................................................ 12-78Format ..................................................................................................................................... 12-78Usage ....................................................................................................................................... 12-79Example ................................................................................................................................... 12-79

    vary ................................................................................................................................................. 12-79Format ..................................................................................................................................... 12-79Options ................................................................................................................................... 12-79Usage ....................................................................................................................................... 12-80Examples ................................................................................................................................ 12-81Command Area Messages ................................................................................................... 12-82Display Area Messages ........................................................................................................ 12-84

    13 Display Command Reference

    Using display Command Options .................................................................................................... 13-2

  • xvi

    Using Wildcard Characters ........................................................................................................... 13-2Examples .................................................................................................................................. 13-2

    Using Ranges .................................................................................................................................. 13-3Examples .................................................................................................................................. 13-3

    Format .............................................................................................................................................. 13-3Options ..................................................................................................................................... 13-3

    Start cmd_proc in Line Mode when Displaying Lines Longer than 80 Characters ............. 13-4Commands ............................................................................................................................................. 13-4

    display cap ...................................................................................................................................... 13-4Format ....................................................................................................................................... 13-5Fields ......................................................................................................................................... 13-5Options ..................................................................................................................................... 13-5Examples .................................................................................................................................. 13-7

    display cell ....................................................................................................................................... 13-7Format ....................................................................................................................................... 13-7Fields ......................................................................................................................................... 13-7Options ..................................................................................................................................... 13-7Example .................................................................................................................................... 13-8

    display drive ................................................................................................................................... 13-8Format ....................................................................................................................................... 13-8Fields ......................................................................................................................................... 13-8Options ..................................................................................................................................... 13-8Examples ................................................................................................................................ 13-12

    display lock ................................................................................................................................... 13-12Format ..................................................................................................................................... 13-12Fields ....................................................................................................................................... 13-12Options ................................................................................................................................... 13-12Example .................................................................................................................................. 13-13

    display lsm .................................................................................................................................... 13-13Format ..................................................................................................................................... 13-13Fields ....................................................................................................................................... 13-13Examples ...........................................................................................