hit counter code
Download
Share
Print this page
Dell DLm8700 User Manual
  1. Manuals
  2. Brands
  3. Dell Manuals
  4. Network Hardware
  5. DLm8700
  6. User manual
Dell DLm8700 User Manual

Dell DLm8700 User Manual

Disk library for mainframe with powermax and cloud
Hide thumbs

Advertisement

Quick Links

Download this manual
Dell Technologies® Disk Library for
mainframe
User Guide for DLm8700 with PowerMax and Cloud
7.0.0.0
November 2024
Rev. 1.0

Advertisement

loading

Related Manuals for Dell DLm8700

Summary of Contents for Dell DLm8700

  • Page 1 Dell Technologies® Disk Library for mainframe User Guide for DLm8700 with PowerMax and Cloud 7.0.0.0 November 2024 Rev. 1.0...
  • Page 2 A WARNING indicates a potential for property damage, personal injury, or death. © 2024 Dell Inc. or its subsidiaries. All rights reserved. Dell Technologies, Dell, and other trademarks are trademarks of Dell Inc. or its subsidiaries. Other trademarks may be trademarks of their respective owners.
  • Page 3 Contents Figures............................8 Tables............................9 Chapter 1: Overview of Dell Technologies Disk Library for mainframe.......... 10 Introduction to Disk Library for mainframe........................10 DLm architecture................................11 VTEC overview................................11 VTE....................................11 DLm 8700 management network..........................13 DLm8700 Ethernet data network..........................14 DLm8700 fibre channel data network........................14 Backend storage................................15...
  • Page 4 Installing the license on DLm System Manager....................27 Rebooting a VTE................................28 Powering on, off, and rebooting DLm.......................... 28 Powering up the PowerMax............................. 28 Powering on a VTE..............................29 Powering off the VTE..............................31 Powering off the back-end storage systems....................... 32 Chapter 4: DLm workflow configuration..................33 Managing configuration..............................
  • Page 5 Manual Tape Library (MTL)............................. 71 Defining DLm devices with HCD..........................71 MTL considerations for VTE drive selection.......................72 Enabling a Dell Technologies DLm Mainframe/Host utility to communicate with a specific VTE... 72 MTL-related IBM maintenance............................73 Dell Unit Information Module............................73 Missing Interrupt Handler..............................74 MIH command................................
  • Page 6 Query Config command............................. 82 Ring-Out Mount request............................83 Scratch request................................83 Configuration for Unisys..............................83 Device type................................... 83 Labels..................................... 83 Scratch tapes................................83 Initializing tapes for Unisys............................. 83 Configuring the Unisys mainframe for DLm........................84 Appendix A: Virtual tape operator command reference..............85 Syntax....................................
  • Page 7 Appendix B: SMP/E Installation....................115 Introduction to SMP/E Installation ..........................115 Loading DLMSxyz.XMITLIB to disk..........................115 Preparing DLMSxyz.XMITLIB(#EXTRACT)....................... 117 Customizing the RIMLIB JCL ............................118 Running the installation jobs ............................120 Performing a cleanup...............................121 Applying maintenance ..............................121 Authorizing DLm LINKLIB and Recycle DLMHOST....................122 Shutting down and restarting DLMHOST ........................
  • Page 8 Figures DLm8700 Multiple Rack Solution for PowerMax architecture...............11 VTE front — right control panel...........................12 VTE front — left control panel..........................12 Rear Panel of DLm 7.0 VTE for OCFS2 and NFS operations................ 13 Dell N3248TE-ON switch............................14 Dell S5248-ON switch.............................14 Brocade DS-7720B switches..........................
  • Page 9 Tables Ports used by the DLm 7.0 VTE for OCFS2 and NFS operations..............13 Status Indicators...............................16 DLm system access details............................ 19 VTE operating system licenses for DLm models....................26 VTE indicators................................29 VTE front left control panel buttons and LEDs....................30 Storage class considerations..........................
  • Page 10 This section provides an introduction to Disk Library for mainframe (DLm). The Dell Technologies Disk Library for mainframe (DLm) family of products provides IBM System z mainframe customers the ability to replace their physical tape libraries, including traditional virtual tape libraries such as the IBM VTS and Sun/STK VSM, with dynamic tapeless virtual tape solutions, eliminating the challenges tied to traditional tape-based processing.
  • Page 11 DLm architecture This section describes the major components of a DLm. The major components of a DLm8700 system are the virtual tape emulation controller (VTEC) and the PowerMax back-end storage system. VTEC overview The VTEC is a subsystem that connects to an IBM or IBM-compatible mainframe and provides the emulation of IBM 3480/3490/3590 tape drives.
  • Page 12 The following figure shows the left control panel on the front panel of the VTE: Figure 3. VTE front — left control panel Label Component System health and system ID indicator Drive indicator Temperature indicator Electrical indicator Memory indicator Overview of Dell Technologies Disk Library for mainframe...
  • Page 13 This section describes the management network in a DLm8700 system. The DLm has an internal Gigabit Ethernet network for management purposes. In a DLm8700, the management ports of the VTE and PowerMax systems are connected to a pair of 1 GbE Dell N3248TE-ON switches to protect against a single switch failure.
  • Page 14 Network switches. Figure 6. Dell S5248-ON switch DLm8700 fibre channel data network In a DLm8700, the data from the mainframe is transferred to the PowerMax back-end storage systems over 32 Gigabit Fibre Channel switches. Figure 7. Brocade DS-7720B switches Overview of Dell Technologies Disk Library for mainframe...
  • Page 15 Backend storage This section describes the backend storage that is used with a DLm8700 system. The DLm8700 uses two Fibre Channel switches to connect to up to two PowerMax storage systems to serve as the backend storage. One of the benefits of a DLm8700-based system is the use of SRDF for replicating data to remote systems thereby allowing customers to take advantage of the associated Disaster Recovery (DR) capabilities and applications of SRDF.
  • Page 16 The virtual tape emulation software performs the following functions: ● Receives and interprets channel command words (CCWs) from the host. ● Sends and receives the tape data records and reads and writes corresponding disk data in response to the CCWs. Overview of Dell Technologies Disk Library for mainframe...
  • Page 17 ● VTEs provide redundant data and control paths. The redundant data path provides failover to protect against link failures, network card failures, and switch failures. ● In DLm 8700, two 10 GbE data switches provide a redundant data path, and two 1 GbE switches provide a redundant management path. Overview of Dell Technologies Disk Library for mainframe...
  • Page 18 If any one of these ports exceeds the packet loss threshold of 5%, a call home is generated. The call home has details about the exact port and the component that is affected. This data enables Dell Technologies customer Support personnel to troubleshoot the issue and resolve it.
  • Page 19 Accessing DLm This chapter explains how to access the Disk Library for mainframe (DLm). Topics: • Management access to DLm • Connecting to the DLm System Manager • Exiting DLm System Manager Management access to DLm This section describes the management and support access to DLm. The first two VTEs in a multi-VTE DLm (VTE1 and VTE2) provide management and support access to the DLm system.
  • Page 20 ● Mobile versions of the above and other browsers are not supported. ● Dell recommends that you move to one of the officially supported browser versions as soon as possible, as earlier browser versions could cause serious usability issues to DLm System Manager.
  • Page 21 DLm system tasks This chapter describes the DLm system tasks. Topics: • Setting date and time • Viewing DLm versions • Configuring user administration • Uploading or generating server certificates • Virtuent console • License activation • Rebooting a VTE •...
  • Page 22 4. Select the time zone applicable to you from the Time zone drop-down list, and click the Apply button ( ) in the upper-left corner. Viewing DLm versions This section explains the procedure to view DLm versions. To see the versions of the DLm components, go to System > Dashboard (The Dashboard page is the default page when you log in to the DLm System Manager).
  • Page 23 Configuring native authentication This section describes the procedure to configure native authentication. About this task Native user administration stores the username and passwords on the VTE and is the default type. Steps 1. To modify a user, modify the content of the Name, Password, or Read-only fields. 2.
  • Page 24 NOTE: If LDAP/S is selected but no certificate is uploaded, the public certificate authority certificates in a standard SuSE LDAP installation are used for authentication. 5. Under Account Filters, enter LDAP criteria to use to authenticate user access from their LDAP server. DLm provides fields for you to enter three access filters: ●...
  • Page 25 If your organization uses the internal CA server to issue and sign certificates, then you must upload your internal CA root chain first. Otherwise, the connection to the DLm System Manager is lost. Contact Dell Technologies support if there is a problem.
  • Page 26 The following table lists the VTE OS licenses for different DLm models. Table 4. VTE operating system licenses for DLm models  DLm Model Model Number of License Description DLm8700 with PowerMax 149-BBZC DLM7 VTEOS GROUP 8=IE POWERMAX DLm 7.x feature licenses: 149-BBZG...
  • Page 27 2. Follow the instructions in the LAC to activate the software. 3. Save one or more license files. 4. Provide the license files to the Dell Technologies service personnel during installation. Receiving the LAC and activating the license This section describes the procedure to receive the LAC and activate the license.
  • Page 28 Powering off a DLm system is also a multistep process. Power off the DLm components in this order: a. Each VTE VTEx VTE2 VTE1 b. Each PowerMax Powering up the PowerMax Follow the procedure in the Dell Technologies PowerMax Power Off and Power On Procedures to power on the PowerMax system. DLm system tasks...
  • Page 29 Powering on a VTE This section describes the procedure to power on a VTE. About this task NOTE: Before you power on the VTE, ensure that the storage systems are powered on. Steps Press the Power/sleep button on the front of the VTE. NOTE: You can power on the VTEs in any order as they operate independently of each other.
  • Page 30 Figure 10. VTE front left control panel Table 6. VTE front left control panel buttons and LEDs  Name State Function 1. System health and Solid blue Indicates that the system is turned on, healthy, and system ID mode is system ID not active.
  • Page 31 No paths currently established and assigned. f. If you do not see this response, see Dell Technologies knowledge base article 336176 "What to do if there are active paths when shutting down or restarting a VTE" for information about how to identify and remove any online devices.
  • Page 32 The VTE turns off. Pressing the power button after a poweroff command turns the VTE on again. Powering off the back-end storage systems Follow the procedure in the Dell Technologies PowerMax Power Off and Power On Procedures to power off the PowerMax system.
  • Page 33 DLm workflow configuration This chapter describes the DLm workflow configuration. Topics: • Managing configuration • DLm Long term retention • Configuring Migration Policies • Migration Policies configuration fields • Storage class recommendation • Data Integrity Checking Managing configuration The DLm System Manager lets you manage configurations in the following ways: ●...
  • Page 34 When you click Install, Virtuent may restart if ALWAYS or IF REQUIRED option is selected. If your VTE is online to the mainframe, Dell Technologies strongly recommends that you idle all tape drives and vary them offline before installing the new configuration.
  • Page 35 Copying a configuration Copy a selected configuration into a new configuration or replace the existing configuration. Steps 1. Go to the Configuration panel in the DLm System Manager. 2. Select the configuration that you want to copy from the configuration list. NOTE: The configuration list also provides information about where the configuration is applied at the moment and what is the status of it.
  • Page 36 Editing a configuration This section describes how to edit a configuration. About this task When you select a specific configuration on the Configuration panel, all changes that are made to that configuration on any page apply only to that selected configuration. For example, if you have two configurations, config, which is the default and a configuration that is named config1, and you select config1, all changes that you make on any page, for example, Devices, apply only to config1.
  • Page 37 Lock or Unlock a configuration This section describes how to lock or unlock a configuration. Locked configuration does not allow changes to be made and provides all the information about Configuration pages in read-only mode. Click to lock or to unlock a selected configuration. Deleting a configuration This section describes how to delete a configuration.
  • Page 38 DLm does not support a configuration where some VTEs use enhanced file system and the other VTEs in the configuration use a DLm 2.x (legacy) style file system. Dell Technologies service personnel use the following steps to define a tape library: Steps 1.
  • Page 39 If you have not defined storage classes (other than the default class 0), you need to initialize only a single range of tape volumes to the library. But if you have defined multiple storage classes then you must initialize a range of VOLSERs for each class you have defined.
  • Page 40 ● If you plan to run the DLm z/OS started task (DLMHOST), you need two devices offline: one to remain offline and used by DLMHOST to communicate with the VTE, and one virtual device if DLMHOST logging is requested. See the Dell Technologies Disk Library for mainframe Command Processors and Utilities for z/OS Guide for more details on DLMHOST.
  • Page 41 NOTE: File systems must be created by Dell Technologies personnel during initial setup before you add devices. Steps 1. Add one or more controllers to the configuration by entering a valid control unit number and selecting a device type for the devices to be defined on the VTE: a.
  • Page 42 ○ LABELS=S/N/A — Most operating system mount requests specify a label type, but for those that do not, the LABELS parameter sets the default label type for the drive. The label types are: S = IBM standard (EBCDIC) labels (the default) N = Unlabeled A = ANSI (ASCII) labels.
  • Page 43 Scratch synonyms This section describes the scratch synonyms. When the mainframe wants a tape volume (VOLSER) mounted on a tape device, it sends a load display command (CCW) over the channel to the device identifying the VOLSER to be mounted. For example, in z/OS, if a user codes JCL for a tape volume that reads VOL=SER=000001, z/OS sends DLm a load display CCW indicating that the tape volume with VOLSER '000001' must be mounted on the drive.
  • Page 44 on free space and frequency of use. If a class is not specified, then the scratch synonym by default only applies to the default storage class of 0. 5. Once you start typing a scratch synonym, the ADD button is enabled. Click ADD to add the scratch synonym. 6.
  • Page 45 2. Open the Virtuent Console from System > Console. 3. Select the appropriate command: STARTVT, or STOPVT from the list of available commands and construct the line of options, using options format below. NOTE: Before Virtuent is stopped or restarted, you must vary all DLm devices offline to the host. For example, to start Virtuent, select: STARTVT 4.
  • Page 46 KMIP standard. DLm supports KMIP to enable third party key managers for obtaining keys to encrypt and decrypt virtual tape volumes. Dell Technologies Customer Support personnel configure and initialize KMIP on the VTEs and define channel devices for KMIP encryption.
  • Page 47 3. You can monitor the status and expiry date of the Certificates from the Certificates Manager panel. The status descriptions or color codes are as follows: ● Green - valid ● Yellow - about to expire in about 15 days or lesser ●...
  • Page 48 Time-to-Live erase policy The Time-to-Live (TTL) erase policy gives you better control over the length of time that the data on a scratch tape is retained when the tape is in the scratch pool. The data on a particular tape is erased when the amount of time since this tape was moved from the active pool to the scratch pool exceeds the duration that is specified for TTL in the Params column.
  • Page 49 LTR storage. The assumption is that LTR storage will be second-tier, cheaper, possibly “lights out” storage, and could be offsite (for example, in the cloud). DLm8700 offers AWS or Dell Technologies ECS solution for LTR.
  • Page 50 The appearing form allows you to specify a bucket on S3 cloud storage that should be used for S3 LTR migration from specific tape library. 5. In the Add New S3 Buckets panel, enter the required fields, as per the below descriptions: ●...
  • Page 51 3. In the Policies page, select the LTR tab and click the + . 4. In Settings tab, specify valid values in the following fields: ● Enabled: Click the button to On to enable LTR policy. If it is Off, the policy is disabled but all the parameters of the policy are saved.
  • Page 52 About this task Perform the following steps to configure Cloud storage parameters: Steps 1. Go to Settings > Storage. 2. In the Storage Global Settings panel, click Cloud Storage tab. CLOUD1 Configuration panel appears. 3. You can modify the connectivity settings of the selected cloud storage using the options in Settings panel. The description of available settings are as follows: ●...
  • Page 53 3. In Steps tab you can choose the type of tapes (Non-scratches, Scratches, Mask) to migrate and the order of migration steps. Order of these steps in configuration defines the order of migration. Mask option allows you to migrate only volsers that fit the specified mask.
  • Page 54 Data Integrity Checking Data Integrity Checking for tapes written on a DLm8700 (or higher) with PowerMax running on OCFS/2 file systems enables Virtuent to identify data corruption in volumes as soon after they are written as possible. This feature provides a mechanism for...
  • Page 55 Monitoring DLm This chapter explains how to monitor DLm. Topics: • VTE logs and DLm statistics • DLm diagnostic reporting VTE logs and DLm statistics This section describes VTE logs and DLm statistics. The DLm System Manager allows you to view and gather the most recent VTE logs for diagnostic purposes. It also provides statistics such as capacity or performance of the system.
  • Page 56 NOTE: Once you select the check box, the system prompts you to enter start and end date. Click in the blank field to set the date and time. ● Include Stat database dump (select the check box, if required). 6. Click OK to close the dialog box. In the lower right corner of the page, the DLm logs collection started window appears.
  • Page 57 4. Select one or multiple tapelibrary from the drop-down list of File Systems, and click OK button or type the name of the VOLSER in the Search by VOLSER field. The tapes in the directory are listed. If you select a tape in the list, the details of that tape are displayed.
  • Page 58 Steps 1. Access the DLm System Manager using a web browser: a. Open a web browser and type the Management VTE's HA IP address as follows: https://<IP address> b. Type the DLm System Manager username and password in the login page. 2.
  • Page 59 2. In the Components list, click DLM. 3. In the DLm panel, under Overall tab, you can see Health check window. 4. Click button to start health check. You can run the Health Check on demand, and the report file can be downloaded. You can see the system status for each DLm component in the System status table.
  • Page 60 ● Info 4. Click Type to sort the messages by type. 5. In the upper left corner of the page, click to save and apply the notification and message settings, or click to discard changes. Configuring DLm to send SNMP alerts This section describes how to configure DLm to send SNMP alerts.
  • Page 61 Configuring messages and recipients provides detailed instructions. The DLMHOST section in the Dell Technologies Disk Library for mainframe Command Processors and Utilities for z/OS Guide also provides information. Configuring messages and recipients You can configure which message is sent to an SNMP management console or the z/OS primary console.
  • Page 62 ConnectEMC This section describes about ConnectEMC function. The ConnectEMC function can automatically notify the Dell service center or other service providers when the VTEC or the backend storage system detects a serious problem. ConnectEMC sends messages using email. The email connection requires the DLm to have access to your company LAN.
  • Page 63 SRDF Replication This chapter provides information about the SRDF Replication (SRDF) feature of DLm8700 with PowerMax. The major topics include: Topics: • SRDF replication overview • Disaster recovery capabilities • SRDF benefits SRDF replication overview Dell Technologies Symmetrix-based remote replication technology (SRDF) enables the remote mirroring of data center information at scale and with minimal impact to production application performance.
  • Page 64 SRDF in offers uni-directional mirror relationship replication connections. The DLm systems support FICON directors, and also offer native Gigabit Ethernet and Fibre capability. An Dell Technologies Gigabit Ethernet director can be installed in place of a traditional Remote Link Director (RLD) or Remote Fibre Director (RFD) or native Gigabit Ethernet connectivity. There is a built-in compression to maximize the bandwidth utilization of the DLm systems while using a Gigabit Ethernet director.
  • Page 65 Configuration files on source and target systems Only the source DLm has filesystems mounted and exported and devices defined. The active configuration file on the source DLm is usually called Production configuration. The source DLm also has a Standby configuration that has no filesystems mounted and no devices defined.
  • Page 66 If a local or regional disaster occurs, GDDR can determine which of the surviving sites will execute the recovery. A DLm communicates with GDDR via the DLmDRD or DLmAUT software. The DLm8700 with PowerMax supports both DLmDRD 1.0 and DLMAUT 1.0 protocols.
  • Page 67 1. Controlling the recovery after an outage 2. Controlling a planned site swap One of the C-Systems is designated as the primary C-System. During normal operations, the primary C-System is the central control point for all GDDR activities. Some GDDR functions can only be carried out by the primary C-System, for example: ●...
  • Page 68 LPAR (using GDDR or DLMDRC) and the DLm so that disaster recovery operations can be initiated and controlled by the customer (using DLMDRC) or Dell Technologies GDDR. The communication between the DLMDRD and GDDR/DLMDRC (running on the customer's mainframe LPAR) is based on a Client/Server model using the TCP/IP protocol.
  • Page 69 DLMAUT is a TCP/IP-based software module which runs on the DLm Management VTEs (VTE1 and VTE2). It interfaces with Dell Technologies GDDR to perform DLm disaster recovery and DR test operations for DLm from the mainframe with minimal or no direct user intervention.
  • Page 70 NOTE: Dell Technologies UIMs are no longer supported. The two alternatives for configuring DLm devices on the mainframe are: ● Configure the devices as real 3480, 3490, or 3590 tape drives.
  • Page 71 Manual Tape Library (MTL) It is recommended that you use the MTL to define DLm devices. If you plan to use DLm devices with OAM or any application that verifies device type, you must define your DLm devices as real 3490 or 3590 tape drives and include them in an MTL, so that they are not misallocated.
  • Page 72 To enable a Dell Technologies DLm Mainframe/Host utility to communicate with a specific VTE in an MTL defined with multiple VTEs, you can omit a single drive from the MTL in each VTE’s device group. Dell Technologies recommends that you leave this drive offline to prevent inadvertent allocation by other jobs.
  • Page 73 This section describes about the Dell UIM. As an alternative to defining real 3480s, 3490s, or 3590s or using an MTL, Dell provides a user UIM that allows DLm tape devices to be configured to HCD using a unique device type. Using the Dell UIM prevents the operating system from allocating DLm virtual tape drives to jobs requesting a mount of a real tape cartridge.
  • Page 74 The generic names for these devices are also V3480, V3481, V3482, and V3483. If you have already defined a generic name of V348x, contact Dell for support. You must define multiple virtual device types to support the multiple DLm systems or a single DLm with multiple virtual tape libraries configured.
  • Page 75 Ensure you follow the considerations under Critical considerations for operator-initiated swap functions when you use the operator-initiated z/OS SWAP command to move virtual volumes to drives on different VTEs on the same DLm to permit VTE FRU changes or for other reasons. The system-initiated (DDR) swap function is not supported.
  • Page 76 The file-size values that are reported by the QUERY command and the awsprint utility (using CP503), reflect the compressed data size and not the original uncompressed size. DLm z/OS components Dell Technologies provides utilities for the z/OS environments. The utilities are: ● DLMSCR—A scratch utility that sends VOLSER scratch requests to DLm.
  • Page 77 3. From the mainframe, write the stand-alone IPL tape to the virtual tape drive where the target tape is mounted, being sure to explicitly specify the VOLSER you mounted in the previous step. Once the stand-alone IPL tape has been created, it is ready to use. Mounting and IPLing from the stand-alone IPL tape This section provides information about mounting and IPLing from the stand-alone IPL tape.
  • Page 78 Figure 13. DR logging overview These log files are hidden from view so that they cannot be mistaken for tape volume (VOLSER) files. If a controller outage should occur, a DLm “Still in Use” report can be generated using the CP988 or CP989 command processors utility.
  • Page 79 Enabling IPv6 This section describes the procedure to enable IPv6. About this task Enable IPv6 by performing the following procedure: Steps 1. Uncomment and activate an IPv6 NETWORK statement in SYS1.PARMLIB(BPXPRMxx). There are two of these: one for INET, one for CINET. Uncomment the one you are already using for IPv4. The following is a commented CINET statement: /*NETWORK DOMAINNAME(AF_INET6) DOMAINNUMBER(19) */ /* For IPv6 */ /* TYPE(CINET) 2.
  • Page 80 4. If you are not already doing so, convert the GATEWAY statement in your TCPIP profile to a BEGINRoutes statement. The GATEWAY statement is not supported for IPv6 and will eventually be dropped for IPv4. GATEWAY and BEGINRoutes statements may not co-exist, so, to combine the two in a single stack, IPv4 must be converted to BEGINRoutes and IPv6 added to it.
  • Page 81 Steps 1. Add and activate a TRLE statement to VTAMLST using available OSA device numbers. TRLOSA VBUILD TYPE=TRL TRL01 TRLE LNCTL=MPC,READ=0004,WRITE=0005,DATAPATH=(0006), PORTNAME=OSAQDIO1,MPCLEVEL=QDIO TRL01B TRLE LNCTL=MPC,READ=0008,WRITE=0009,DATAPATH=(000A), PORTNAME=OSA01A,MPCLEVEL=QDIO Where: PORTNAME is the one designated on the INTERFACE statement. 2. Test the activated changes by pinging a host with a known IPv6 address: For example: ISPF Command Shell Enter TSO or Workstation commands below:...
  • Page 82 Using DLm with Unisys This chapter describes how to use DLm with Unisys. Topics: • Unique DLm operations for Unisys mainframes • Configuration for Unisys • Initializing tapes for Unisys • Configuring the Unisys mainframe for DLm Unique DLm operations for Unisys mainframes This section describes the unique DLm operations that are required for Unisys mainframe systems.
  • Page 83 Ring-Out Mount request The Unisys Load Display mount request uses the eighth position of the mount message as a file protection indicator. If that position contains the character 'F', the Unisys mainframe expects to have the tape mounted "ring-out" (read-only). DLm honors the 'F' indicator and mounts the requested volume in read-only mode.
  • Page 84 Configuring the Unisys mainframe for DLm Configure DLm devices in OS2200 using SCMS/SCMS-II as one or more CTS5136-VSM (nonlibrary) subsystems of 1 to 16 units. The resulting ODB or .PTN file must be installed and the operating system must be rebooted with the proper definitions. Steps The Unisys equipment code for DLm devices is U47M.
  • Page 85 Virtual tape operator command reference This appendix describes the virtual tape operator command reference. Topics: • Syntax • DETAIL MOUNT • FIND • HELP • INITIALIZE • KMRESTART • LOAD • • MIGRATE • QUERY • QUIESCE • READY • REWIND •...
  • Page 86 DETAIL MOUNT This section describes the DETAIL MOUNT command. Syntax DETAIL MOUNT Description The DETAIL MOUNT command returns detailed information about the mounted tapes. Example DETAIL MOUNT Sample Output Devicename VOLSER Load Time Duration Requestor Path Last I/O Time Tape Library Path ---------- ------ ------------------- -------- ----------------- F400 D30321 2016/04/24 09:50:50...
  • Page 87 Example FIND VOL=000001 The example returns the status of the tape volume with the serial number 000001. Sample Output DLm0409I: Command received: 'FIND VOL=D40316 DEV=F400' find volume(s) 'D40316' Fri Apr 24 10:02:50 2015 (Julian 114) Volume Type Size Modified Mounted St Class Path ====================================================================================...
  • Page 88 INITIALIZE This section describes the INITIALIZE command. Syntax INITIALIZE VOL=volser DEVICE=devname [COUNT=count] [CLASS=n] [DIR=subdirectory] [LABEL=S|A|N] [SCRATCH=Y|N] [EPIC=N|Y] [ERRORS=nnnnn] [VIRTUALSCRTCH=NO|YES] [INCREMENT=NUMERIC|HEX|LITERAL|ALPHANUMERIC] Description Creates and initializes one or more AWS-format virtual tape volumes in the tape library. NOTE: In DLm command syntax, you can use DEVICE and DEV interchangeably. Options Table 11.
  • Page 89 KMRESTART Description This command restarts the keymanager daemon. It is used to reinitialize new certificates and parameters. Dell Customer Support personnel upload the new certificate in DLm System Manager and then initialize the keymanager daemon. Virtual tape operator command reference...
  • Page 90 NOTE: This command is NOT disruptive and does not require a restart of Virtuent. LOAD This section describes the LOAD command. Syntax LOAD [VOL=volser] [ON] [DEVICE=devicename|*] [UNLABELED|LABELED|NL|SL|AL] [PROTECTED] Description Use the LOAD command to perform a manual load of a virtual tape volume. Use a manual load to load a volume for a host system that does not send Load Display Mount messages, or in a situation where you want to mount a tape other than the tape the host is requesting.
  • Page 91 This section describes the LTR command. Syntax LTR [ENABLE | DISABLE] policyname FAILURES [CLEAR|LIST] policyname REVERT VOLSER=volname MODIFICATION={COMPRESSED|UNCOMPRESSED} {TAPELIBRARY=tapelibname [CLASS=nn] | POLICY=policyname} MIGRATE POLICY=policyname [VOLSER=volname] [START={NOW|NEXT}] KILL Description The LTR command enables you to manage LTR policies configured on VTE, perform on-demand migration of any tape volume to LTR target storage, and bring back the previously migrated tape volume to the primary storage.
  • Page 92 MIGRATE This section describes the MIGRATE command. Syntax MIGRATE [ENABLE policyname[*]] [DISABLE policyname[*]] [STATUS] [FAILURES LIST policyname [*]] [FAILURES CLEAR policyname [*]] [KILL] Description Use the MIGRATE ENABLE or MIGRATE DISABLE command to enable or disable one or more specified migration policies. Besides, you can use the MIGRATE KILL command to disable the Migration feature, disable all migration policies, and terminate all migrations in progress.
  • Page 93 QUERY This section describes the QUERY command. Syntax QUERY [[DEV=]devicename[+] | ALL] [MOUNTED] QUERY [CONFIG] | [CRITICAL] | [PATHS [ASSIGNED]] | [EFS] | [LABELS] [[DEV=]devicename] QUERY [VERSION]| [SCRATCHNAMES] | QUERY [STATISTICS|STATS] QUERY [STCLASS] QUERY [WARNING|RECOVER|RECOVERAMT] QUERY [CHANNEL ADAPTERS] QUERY [DRIVE LIST] QUERY [REJECTED PATHS] QUERY [SPACE [BYCLASS] [WIDEFORMAT]] QUERY [CRITICAL]...
  • Page 94 Table 15. Query command—option description (continued) Value Description The WIDEFORMAT option prints all the information about one line for each tape library directory, regardless of the length of the tape library path names. The column positioning is adjusted to accommodate the longest path name.
  • Page 95 ○ rw is read/write. ○ ro is read-only. ○ lfp is a logical file protect set by the host. ○ If a volume is mounted, the current block position or LP (for loadpoint) is displayed, and whether the last operation was a read or write.
  • Page 96 HDR2U000000000000DPHILL6D/DUMP 00000 0000065520 QUERY LOCKS sample output DLm0409I: Command received: 'query locks' DLm0256I: EFS Short Term Lock Directory set to: /lockfs/LOCK/ DLm0953I: Locking with .lk lock files turned ON DLm0957I: Locking with NLM Locks turned OFF ===================================================== .lk long term lock files owner lock file name ------------------------- ---------------------------...
  • Page 97 QUERY SPACE sample output The QUERY SPACE output for PowerMax backend systems is similar to: Tape library space for drives: 6000-600F Path Size Active Scratch / Qty Free Filesystem ---------------- -------- ------------- -------------------- ------------- ---------- /tapelibTEST/PMAX1_LUN16_FS1 18.9TiB 26.9MiB 3.7KiB 18.8TiB 99% /dev/mapper/ 36000097* /tapelibTEST/PMAX1_LUN17_FS1...
  • Page 98 QUERY VERSION sample output This section provides a sample output for the QUERY VERSION command. DLm0409I: Command received: 'QUERY VERSION' Copyright (c) 2017-2024 Dell Inc. or its subsidiaries. All rights reserved. Virtuent version 10.0.0.0.1823 Model Family: dlm2700 Program started at Tue Oct 15 15:14:48 2024...
  • Page 99 Example QUIESCE TAPELIB PATH=/tapelib/FS1 QUIESCE DEVICE=4000 READY This section describes the READY command. Syntax READY [DEVICE=]devicename Description Use the READY command to change a virtual drive from the Not Ready to the Ready state. Typing the READY command for a virtual tape drive is equivalent to pressing the Ready button on a physical tape drive. To make a virtual drive ready, it must already have a volume that is mounted and be in the Not Ready (Intervention Required) state.
  • Page 100 emergency situation when a tape volume is known and to not be in use by a host application, but must be rewound to load point immediately. Example REWIND DEVICE=940A ROTATE Syntax ROTATE [LOCAL|DRLOG] Description The ROTATE command rotates the local statistics file (LOCAL) or the DR Logging files (DRLOG) in each of the tape library directories.
  • Page 101 Description The SCRATCHNAMES ADD command adds a scratch synonym for the given Tape Library. The SCRATCHNAMES DELETE command deletes an existing synonym from the list of synonyms of a given Tape Library. Synonym is a 1 to 8 character scratch synonym (pool name).
  • Page 102 This section describes the SET command. Syntax SET [AMDD=ON|OFF|DEFAULT] [CRITICALEFSMOVE=YES|NO] [CRITICALLEOT=YES|NO] [CRITICALPERCENT=nn] [CRITICALRO=YES|NO] [CRITICALSCRATCH=YES|NO] [DELETES3TARGET=ON/OFF] [DEVICE=devicename|ALL] [EFSMOVE=SPACE|RANDOM|NEVER] [EFSMOVEFLR=ON/OFF] [EFSMOVEDDRL=ON/OFF] [EFSMOVEGR=ON/OFF] [ERASEMOVE=SPACE|COUNT|RANDOM|NEVER] [ERASEPOLICYTTL=nnn|nnnH|nnnD|OFF] [FLRLOCKIFEXPIRED=YES/NO] [FSALLOCATION=RR|SPACE] [GR=YES | NO | SYNC | RUN [DEVICE=devname]] [HWCOMP=ON|OFF|FORCE] [HWDECOMP=ON|OFF|FORCE] [IDRC=ON|OFF|FORCE] [IGNORES3ETAG=ON/OFF] [KEYCLASS=key_class|NONE] [LEOT=xxx] [LTR=ON/OFF] [MIGRATE=ON/OFF] [NONTRUNCATEWRITE=YES|NO] [PATH=pathname [NOCHECK]] [PROTECTVOL1=ON|OFF]...
  • Page 103 AMDD value can be ON, OFF and DEFAULT, which means that AMDD will be done for devices on dedupable storage, and has no effect on non-dedupable storage. Dell Technologies recommends that the AMDD feature be left on, for improved de-duplication of data written by the host to a dedupable storage.
  • Page 104 Table 18. Set command—option description (continued) Value Description SPACE specifies that the scratch volume should be moved to the filesystem of the same class with the most free space. RANDOM specifies that the scratch volume should be moved to another random filesystem of the same class. NEVER specifies that scratch volumes are not moved to a different filesystem when written to.
  • Page 105 Table 18. Set command—option description (continued) Value Description limited number of file systems rather than spreading them out more evenly. NOTE: This parameter can also be set in Additional parameters field described in Configuring global parameters. GR=YES|NO|SYNC|RUN [DEVICE=devname] Enables or disables the Guaranteed Replication or Replication on RUN for one or more devices.
  • Page 106 Table 18. Set command—option description (continued) Value Description NOTE: This parameter can also be set in Additional parameters field described in Configuring global parameters. LTR=ON/OFF Controls the LTR feature. The default is ON. MIGRATE=ON/OFF Enables or disables the migration feature. If the migration feature is turned off with the SET MIGRATE=OFF command, any migrations in progress continue to normal completion, but no new migrations are started until the feature is re-enabled.
  • Page 107 Table 18. Set command—option description (continued) Value Description QSPACETIMEOUT=nn Sets the number of minutes that QUERY SPACE can run before it is automatically canceled. RDC256K=[ON|OFF] Can be used to disable the default behavior of setting the"256 K writes supported" bit in the 3490 Read Configuration Data. The default is ON.
  • Page 108 Table 18. Set command—option description (continued) Value Description default is 95 percent. If you want to never automatically erase scratched tapes to recover space, specify 100 percent. SPACEWARNINGPERCENT=nn Sets the usage level at which the system starts to warn that a tape library's disk space utilization is getting high.
  • Page 109 Table 18. Set command—option description (continued) Value Description pushed forward from the date of the modification by the same amount as the original first write. The new FLR/DDRL retention date is determined by first calculating the original retention period by subtracting the modify-date from last- access-date of the original file, VOLSER.
  • Page 110 Table 18. Set command—option description (continued) Value Description NOTE: This parameter can also be set in Additional parameters field described in Configuring global parameters. <storage>WRITEVERIFY=ON/OFF/CRC/DATA/ <storage>WRITEVERIFY is used to control the operations on HEADERS back ends of specified storage. <storage> can be DD/ECS/ PMAX/VNX/VG8/UNITY/LEGACYDD/LEGACYVNX/NAS/ UNKNOWNNFS/UNKNOWNOCFS2/UNKNOWN TPFWRITEVERIFY defines if <storage>WRITEVERIFY flags...
  • Page 111 Description This command starts Virtuent on the VTE. This command is only valid when the Virtuent Console window indicates that the VT status is Not Running. Once the VT status is Running, tape devices on this VTE may be varied online on the mainframe. NOTE: The STARTVT command works only when entered directly through the Virtuent Console.
  • Page 112 NOTE: Unloading the tape results in an I/O error (Intervention Required) if the host tries to read from or write to the drive after it is unloaded. For this reason, use the UNLOAD command only in an emergency situation when a tape volume is known to not be in use by a host application, but must be unloaded immediately.
  • Page 113 UNREADY This section describes the UNREADY command. Syntax UNREADY [DEVICE=]devicename Description Use the UNREADY command to change a virtual drive from the Ready to the Not Ready (Intervention Required) state. Using the UNREADY command for a virtual tape drive is equivalent to pressing the Not Ready button on a physical tape drive. The UNREADY command is run immediately regardless of whether the host may be using the tape.
  • Page 114 DLm0833I: Writing to statistics database is enabled DLm0833I: Hourly statistics are On DLm0833I: Hourly statistics filename is /var/bti/stats/hourly, size is currently 0 bytes DLm0833I: Hourly statistics counters are by the minute DLm0833I: Hourly statistics seconds value is 1 DLm0833I: Hourly statistics useconds value is 0 DLm0833I: Volume statistics are On DLm0833I: Volume statistics filename is /var/bti/stats/vstats, size is currently 12.2K bytes...
  • Page 115 JCL that you use to perform an SMP/E indirect-library installation on the product. The PDS is packaged as a TSO TRANSMIT file on a CD or in an open systems .zip file, called DLMSxyz.zip, for an electronic download from the Dell Online Support Downloads section.
  • Page 116 Click Downloads. In the Type a Product Name field, type Disk Library for mainframe immediately followed by the applicable DLm model (for example, DLm8700) for which you are searching. Select the text that automatically displays for the appropriate DLm model and click the Search button.
  • Page 117 ===> receive INDA('EMC.DLMS700.XMITFILE') INMR901I Dataset EMC.DLMS700.XMITLIB from LLINKE1 on NODENAME INMR906A Enter restore parameters or 'DELETE' or 'END' + DA('EMC.DLMS700.XMITLIB') IEBCOPY MESSAGES AND CONTROL STATEMENT PAGE IEB1135I IEBCOPY FMID HDZ1C10 SERVICE LEVEL UA56546 DATED 20100830 DFSMS 01. 12.00 z/OS 01.12.00 HBB7770 CPU 2818 Û} IEB1035I RGUSER7...
  • Page 118 Enter is pressed. The following is a sample of the SETUP Customization panel: +---------------------- Dell JCL Customization Utility ---------------------+ | COMMAND ==> _____________________________________________________________ | | Type EXEC on the command line and press ENTER to proceed, or PF3 to exit. | | CLIST library ==>...
  • Page 119 The RIMLIB dataset also includes a $$README member with includes installation instructions. NOTE: Dell strongly suggests that you use the DLMJCL utility, contained in the RIMLIB dataset to perform this task. However, if you prefer to do it manually, see the $$README member for manual editing instructions.
  • Page 120 Do not use any parameter that contains an ampersand (&), such as NOTIFY=&SYSUID. An ampersand in the job card can cause edit-macro errors. 3. Enter the following information in the Dell JCL Customization Utility panel to customize your installation: +---------------------- Dell JCL Customization Utility ----------------------+ | COMMAND ==>...
  • Page 121 #04DDDEF e. #05RECEV f. #06APPLY g. #07ACCPT h. #08CLEAN 2. Installing into an old SMP/E CSI from a previous version of DLM or a version of Dell Mainframe Enablers V7.0.0 or higher: a. #U1ALLOC b. #U4DDDEF c. #05RECEV d. #06APPLY e.
  • Page 122 3. When you are finished reading or copying from Dell online support, return to the previous pages to view other products and services, or choose Logout from the menu bar at the top of any page. Authorizing DLm LINKLIB and Recycle DLMHOST This section describes how to authorize DLm LINKLIB and recycle DLMHOST.
  • Page 123 About this task In this task, "x.y.z" and "xyz" are the DLMDRC version. The Dell Disk Library for mainframe Release Notes contains the latest DLMDRC version. For example, if the DLMDRC version is 3.5.2, replace occurrences of "x.y.z" and "xyz" with "3.5.2" and "352", respectively.
  • Page 124 NOTE: EMC.DLMSxyz.SAMPLIBD is then populated with the DLMDRC sample JCL library. 6. Type the following: receive indataset('uid. EMC.DLMSxyz.REXXDRC.XMI') 7. At the prompt, enter restore parameters or delete or end. Type the following: da('EMC.DLMSxyz.REXXDRC') NOTE: EMC.DLMSxyz.REXXDRC is then populated with the DLMDRC REXX program library. 8.
  • Page 125 The awsprint utility enables you to produce lists of the tapes in the virtual tape library within the DLm. You can use the command processor CP503 to obtain the awsprint output from the mainframe. The Dell Technologies Disk Library for mainframe Command Processors User Guide provides information about CP503.
  • Page 126 Running awsprint with no options specified. A report is generated with awsprint syntax and a description of its options. vte1:~ # awsprint Copyright (c) 2017-2024 Dell Inc. or its subsidiaries. All rights reserved. awsprint Version 10.0.0.0.1823, Compiled Sep 6 2024 20:21:47...
  • Page 127 Example 3 Running awsprint with the recursive option. vte1:~ # awsprint /tapelibMTL1 -r Copyright (c) 2017-2024 Dell Inc. or its subsidiaries. All rights reserved. awsprint Version 10.0.0.0.1823, Compiled Sep 6 2024 20:21:47 Sorted by Name 11/05/2024 04:03:23 AM Path: /tapelibMTL1...
  • Page 128 Running awsprint with tapelib specified along with recursive and detail options. A report of all tape volumes in a tapelib is generated. vte1:~ # awsprint /tapelibMTL1 -r -d Copyright (c) 2017-2024 Dell Inc. or its subsidiaries. All rights reserved. awsprint Version 10.0.0.0.1823, Compiled Sep 6 2024 20:21:47...
  • Page 129 0 Blocks Compressed 2 Blocks not Compressed <TM> End of tape. ************************************************************************* ************************************************************************* Copyright (c) 2017-2024 Dell Inc. or its subsidiaries. All rights reserved. awsprint Version 10.0.0.0.1823, Compiled Sep 6 2024 20:21:47 Sorted by Name 11/05/2024 04:04:37 AM Path: /tapelibMTL1/FS_3...
  • Page 130 ************************************************************************* Example 5 Running awsprint with recursive and fewer options. vte1:~ # awsprint /tapelibMTL1 -r -l Copyright (c) 2017-2024 Dell Inc. or its subsidiaries. All rights reserved. awsprint Version 10.0.0.0.1823, Compiled Sep 6 2024 20:21:47 Sorted by Name 11/05/2024 04:07:21 AM...
  • Page 131 TAPE INFO TAPE SIZE WORM EXP No Tapes Matching Selection Criteria Found. ************************************************************************* Copyright (c) 2017-2024 Dell Inc. or its subsidiaries. All rights reserved. awsprint Version 10.0.0.0.1823, Compiled Sep 6 2024 20:21:47 Sorted by Name 11/05/2024 04:07:21 AM Path: /tapelibMTL1/FS_2...
  • Page 132 Volume Handling This appendix describes volume handling in DLm. Topics: • Volume serial numbers • Scratch volumes • Mount volumes Volume serial numbers This section describes Volume serial numbers. DLm supports those VOLSERs that conform to the IBM standard VOLSER naming convention. IBM standard VOLSERs contain one to six alphanumeric EBCDIC characters of uppercase A through Z, 0 through 9, and hyphen.
  • Page 133 Virtuent never moves an active volume to scratch status on its own. You can move volumes from active to scratched state by using the DLMSCR utility running on the host. The Dell Technologies Disk Library for mainframe Command Processors and Utilities for z/OS Guide provides more information about the DLMSCR utility. DLMSCR processes a host-generated scratch report and sends scratch volume requests over the channel to Virtuent.
  • Page 134 Requested VOLSER exists This section describes the scenario where a requested VOLSER exists. When the host requests a specific VOLSER, the VTE receiving the Load Display command first searches for the requested VOLSER as an active volume in the tape library. If not found, the VTE searches for it as a scratch volume. If the VTE finds the specified VOLSER, it opens the file and positions the file at the beginning of the volume (load point).
  • Page 135 Virtuent allows scratch volume allocations to be restricted to a specific range of tape volumes beginning with the prefixes defined in the VOL parameter. VOLSER prefix or prefixes set with VOL are honored during scratch mounts ONLY. The VOL prefixes filter is applied after all other class, space, age, label-type, penalty, and synonym filters have been applied. NOTE: In an erased volume, no data follows the standard labels.
  • Page 136 Load Display Command — CCW Opcode x'9F' This appendix describes the Load Display command (CCW Opdcode x’9F’). Major topics are: Topics: • Load display messages • Load display data Load display messages This section describes the Load display messages. IBM-compatible 3480/3490/3590E tape drives support a Load Display command (CCW Opcode x’9F’) that is used to display messages on the LED display of the tape drive.
  • Page 137 Examples: "MAA1234S", "MPRIVATS", "MPRIVS" ● 'M'+volser+' ' - where volser is a 1-character to 6-character VOLSER or a scratch synonym, left aligned, with trailing spaces. NOTE: This format invokes a scratch synonym search. Examples: "MAA1234 ", "MPRIVAT ", "MPRIV " ●...
  • Page 138 Load display data This section provides information about load display. Table 22. Load display data  Bytes Description Format Control Byte 1–8 Message 0 9–16 Message 1 Format Control Byte Table 23. Format Control Byte   Bits Value Description 0–2 Function select The message that is specified in bytes 1–8 and 9 to16 is maintained until the tape drive next starts tape motion or the...
  • Page 139 Table 23. Format Control Byte  (continued) Bits Value Description the message is displayed. The sequence repeats until the message is replaced on the display. When bit 3 is set to 1, bits 4 and 5 are ignored. Blink message The message that is specified by setting bit 5 does not blink.