StorageTek 6 Bedienungsanleitung

Host Software Component (VM Implementation) System Pr ogrammer’ s Guide Release 6.0 312579601[...]

Information contained in thi s publication is subject to change without notice. Comments concerning the contents of this publication should be directed to: Global Learning Solutions Storage T echnology Corpo ration One StorageT ek Drive Louisville, CO 80028-3526 USA sid@stortek.com Export Destination Control S tatement These commodities, technology[...]

Document Effectivity iii Document Effectivity 1st ed., 6/30/04 - 312579601 EC Number Date Doc Kit Number T ype Effectivity 128976 June, 2004 --- First Edition T his document applies to the Host Software Component for VM (VM/HSC), V ersion 6.0.[...]

iv VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601[...]

Contents v Contents 1st ed., 6/30/04 - 312579601 What’s New With This Release? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxv Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxvii Scope . . . . . . . . . .[...]

vi VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Matching VOLATTR and TAPEREQ Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 Precedence of VOLATTR and TAPEREQ Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 Mount/Dismount Functions . . . . . . . . . . . . . . . . . . . . .[...]

Contents vii 1st ed., 6/30/04 - 312579601 Options Offered by PARMLIB Control Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 Control Statement Conti nuation Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 CDS Definition (CDSDEF) Control Statement . . . . . . . . . . . . . . . . [...]

viii VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Utility Environmental Requir ements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173 ACS UTIL Exec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174[...]

Contents ix 1st ed., 6/30/04 - 312579601 Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214 JCL Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217 Invoking the BACKup Utility .[...]

x VM/HSC 6.0 Syst em Programmer’s Guide 1st ed., 6/30/04 - 312579601 Journal Offload Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253 Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . [...]

Contents xi 1st ed., 6/30/04 - 312579601 JCL Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292 Invoking the Scratch Redistribution Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292 JCL Examples . . . . . . . . . . . . . . . . . .[...]

xii VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SCP Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347 Abend Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .[...]

Contents xiii 1st ed., 6/30/04 - 312579601 Using the Performance Meas urement and Predictive Maintenance System (PM2) . . . . . . . . 413 Redistribute Scratch Volumes in the Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414 Maintain Quantities of Scratch Cartridges . . . . . . . . . . . . . . . . . . . [...]

xiv VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 How to Specify a CAPid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434 CAPid Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434 Ranges And [...]

Contents xv 1st ed., 6/30/04 - 312579601 Reconfiguration utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460 REPLace utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 460 RESTore utility . . . . . . . . .[...]

xvi VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 DUMP Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488 FILE Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489 HELP Command[...]

Contents xvii 1st ed., 6/30/04 - 312579601 SLSSLHDR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526 SLSSVLG1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531 SLSSBLOG . . . . . . . . . . . [...]

xviii VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 LSM Robotics Error Codes: 0701 - 0718 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617 LSM Hardware Error Codes: 08 01 - 0809 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618 LSM Logical Error Codes: 0901 - 097[...]

Figures xix Figures 1st ed., 6/30/04 - 312579601 Figure 1. HSC Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Figure 2. Virtual Machine Relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Figure 3. Shared [...]

xx VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 Figure 27. Subsystem Data Relationships . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404 Figure 28. Using LSMs as Scratch Loaders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428 F[...]

Tables xxi Ta b l e s 1st ed., 6/30/04 - 312579601 Table 1. HSC Command Execution at Base and Full Service Levels . . . . . . . . . . . . . . . . . . . . . . . . . . 23 Table 2. Utility Execution at Base and Full Service Levels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 Table 3. MODel/RECtech Translation . . . . . . . . . [...]

xxii VM/HSC 6.0 System Programmer’s Gu ide 1st ed., 6/30/04 - 312579601 Table 27. SLLUIPCS Print Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400 Table 28. Performance Parameters Cont rolled by PARMLIB Control Statements . . . . . . . . . . . . . . . . 415 Table 29. MEDia, RECtech[...]

Tables xxiii 1st ed., 6/30/04 - 312579601 Table 60. SLUVHDAT Record Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574 Table 61. SLUVIDAT Record Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577 Table 62. SLUVSDAT Record Format . .[...]

xxiv VM/HSC 6.0 System Pro grammer’s Guide 1st ed., 6/30/04 - 312579601[...]

What’s New With This Release? xxv 1st ed., 6/30/04 - 312579601 What’ s Ne w With This Release? HSC 6.0 includes the following enhancements and modifications: Enhancement/Modification Publication(s)/ Primary Locations Support for the StreamLine (SL8500) library . Installation Guide Chapter 2, Calculating DASD Space Chapter 6, SLILSM , SLIDRIVS m[...]

xxvi VM/HSC 6.0 System Programmer’s Guid e 1st ed., 6/30/04 - 312579601 The HSC mount/dismount component has been changed to allow any host to mount or dismou nt a volume. Previously , only the mounting host could perform mount/dismount op erations. System Programmer ’ s Guide Chapter 2 The V olume Report utility displays mounted volume s in a [...]

Preface xxvii 1st ed., 6/30/04 - 312579601 Preface Scope This guide provides information about the Storage T echnology Corporation (StorageT ek®) Host Software Component (HSC) and its use with the Automated Cartridge System. Reference info rmation is provided for syst ems programmers to install, debug, and prov ide systems support to u sers of the[...]

xxviii VM/HSC 6.0 System Programmer’s Gu ide 1st ed., 6/30/04 - 312579601 • Chapter 4, “Utility Functions” describes control statem ent conventions for the utilities and presents an overview description, syntax, JCL requirements, JCL examples and a description of output for each utility . Example re ports are shown for those utilities produ[...]

Preface xxix 1st ed., 6/30/04 - 312579601 Referenc es to HSC Pr oduct Releases For purposes of convenience, the HSC Release 6.0.0 product is referred to as HSC 6.0 throughout all guides of th e HSC documentation set. Related Publications The following document s are refe renced in this guide. A dditional information may be obtained on specific topi[...]

xxx VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601[...]

Chapter 1. System Description 1 1st ed., 6/30/04 - 312579601 Chapter 1. System Description A utomated Cartridg e System Overview The StorageT ek Automated Cartridge System (ACS), called the library , is an automated storage and retrieval facility for tape cartridges. The lib rary incorporates the Host Software Component (HSC) to accomplish automate[...]

2 VM/HSC 6.0 Syst em Programmer’s Guide 1st ed., 6/30/04 - 312579601 - TimberW olf (9740) 10 -cell removable ma gazine or 14-cell perma nent rack CAP - StreamLine (8500) includes 3, 13-cel l removable maga zines. An optional 39-cell CAP can be ad ded. The complete inventory of each LSM and th e storage location for each cartridge is contained in [...]

Chapter 1. System Description 3 1st ed., 6/30/04 - 312579601 Host Software Component Overview The HSC performs a variety of functions inclu ding: • assisting the tape management system in devi ce allocation • processing mount an d dismount requ ests • delivering library mount/dismount instruc tions to the LMU via a terminal control unit • p[...]

4 VM/HSC 6.0 Syst em Programmer’s Guide 1st ed., 6/30/04 - 312579601 HSC Subsystem Components The HSC is a secondary s ubsystem that execu tes in various enviro nments including a standard class G virtual machine. The HSC contains the follo wing components: • External Components — External components in terface with other virtual machines, an[...]

Chapter 1. System Description 5 1st ed., 6/30/04 - 312579601 T ape Management Interface external component The tape management interface compon ent receives and directs requests for configuration, status, mount, dismou nt, and other information, from users and programs. USER’S ADDRESS SP ACE HSC ST ARTUP COMMAND (S SLS) HSC ADDRESS SP ACE APPLICA[...]

6 VM/HSC 6.0 Syst em Programmer’s Guide 1st ed., 6/30/04 - 312579601 VM En vir onment The VM version of the HSC pr oduct is the implementation of the ACS Host Software Component (HSC) prod uct on VM. The princi pal interfaces and components under VM are: • VM Operating System (CP and CMS) • The System Control Program (SCP) • The Host Softwa[...]

Chapter 1. System Description 7 1st ed., 6/30/04 - 312579601 System Contro l Program (SCP) The service virtual machine executes a pr oprietary System Control Program which provides a small subset of MVS services that include the following ma jor components: • S torage management • Device management • File management • T ask management • J[...]

8 VM/HSC 6.0 Syst em Programmer’s Guide 1st ed., 6/30/04 - 312579601 T ask Management Multi-tasking is provided by the SCP to supp ort the MVS-type task requests such as POST , W AIT , A TT ACH, etc. that the HS C expect s. All modules are made resident at the time of initialization. Also included in this component is the processing of System Man[...]

Chapter 1. System Description 9 1st ed., 6/30/04 - 312579601 T ask Recovery/T ermination T ask recovery is concerned with resource recovery , possible retry ope rations, and the logging of software-detected errors. T ermina tions can be considered a special case of recovery where resources must still be recove red but no retry or logging is necessa[...]

10 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 HSC and A utomated Cartridg e System Interaction After the HSC is started and the tape mana gement system (TMS) service mach ine has begun a dialog, moun t or dismount requests are process ed from the TMS, and the library control data set is used to determine the loca tion of t[...]

Chapter 1. System Description 11 1st ed., 6/30/04 - 312579601 PRIMARY CONTROL DA T A SET SECONDARY CONTROL DA T A SET ST ANDBY CONTROL DA T A SET LSM CD TMS SERVICE MACHINE TMS REQUESTOR (CMS) NONLIBRARY T APE DRIVE C27925 LMU VM HOST A LMU 3174/3274 TERMINAL CONTROL UNIT OPERA TOR OPERA TOR VM HOST B HSC SCP ACS SERVICE MACHINE ADMINISTRA TOR ADMI[...]

12 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 Automated cartridge mounts/dismounts are perfo rmed in response to calls to the tape management interface. The HSC determines th at a mount/dismount is required for a volume under automated library control (cartridge resides in an LSM storage cell), and it communicates with th [...]

Chapter 1. System Description 13 1st ed., 6/30/04 - 312579601 A utomated Mount Figure 4 on page 14 shows the LMU communica ting with the LSM thro ugh LAN 0. In this illustration, LAN 1 is repres ented as the backup used in case of a LAN 0 failure. Note: The HSC can select either LAN for comm unications with the LSM(s). Whichever LAN is not picked b[...]

14 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 PRIMARY CONTROL DA T A SET SECONDARY CONTROL DA T A SET ST ANDBY CONTROL DA T A SET JOURNALS HOST 1 HOST 2 HOST 3 HOST 16 3274 CONTROL UNIT (0) 3274 CONTROL (7) LOCAL AREA NETWORK LOCAL AREA NETWORK (ST A TIONS 1 - 16) (ST A TIONS 1 - 16) LMU 0 LAN 0 LAN 0 LAN 1 LAN 1 LMU 255 L[...]

Chapter 1. System Description 15 1st ed., 6/30/04 - 312579601 In a library configuration containin g more than one LSM, if a cartridge exchange operation occurs to obtain the cartridge for mounting, the cartridge may be returned by one of these possible ways: • If the MNTD Float command is set to ON (t he HSC initi al value), the cartridge is ret[...]

16 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 User Contr ol of HSC Functions V arious controls are in place in the HSC so ftware to permit you to select how the HSC functions. Macros, Utilities, and P ARMLIB cont rol statements are normally used by the systems programmer to tune and customize the system. Commands are norma[...]

Chapter 1. System Description 17 1st ed., 6/30/04 - 312579601 Commands Operator commands are available for Systems Operators to use in daily library operation to perform various tasks. Commands perform su ch functions as: • assigning a preference to a specific cartridge access port (CAP) • displaying system status, such as control data set stat[...]

18 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601[...]

Chapter 2. Host Software Component Functio ns 19 1st ed., 6/30/04 - 312579601 Chapter 2. Host Software Component Functions Overview of HSC Functions This chapter describes the basic function of the HSC. Functions for each of the HSC components fit within the archit ecture structure presented in Figure 1 on page 4. Not all of the compon ents of the [...]

20 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 • automatic cleaning of tape transports with cleaning cartridges under the control of the HSC and the library • restricting the write access to volumes in th e library through the V irtual Thumbwheel feature • dual LMU support • control data set recovery . F acilities A[...]

Chapter 2. Host Software Component Functio ns 21 1st ed., 6/30/04 - 312579601 Initialization/T erm ination Functions Initialization/termination fu nctions control initializatio n and termination of HSC components. This section d escribes the major initializa tion/termination functions. HSC Ser vice Levels T o provide you with a more flexible, dynam[...]

22 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 Description of Full Service Le vel The full service level of operation for the HSC provides all of the functions available and necessary to invoke and sustain complete li brary operations. These functions include: • mount/dismount processing • CAP processing • cartridge a[...]

Chapter 2. Host Software Component Functio ns 23 1st ed., 6/30/04 - 312579601 T able 1. HSC Co mmand Exe cu tio n at Base and Full Service Levels Command Service Level Execution Base Full CAPPref NO YES CDs YES YES CLean NO YES COMMPath YES YES DISMount NO YES Display YES * YES DRAin NO YES EJect NO YES ENter NO YES Journal YES YES LIst YES YES MNT[...]

24 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 T able 2. Uti li t y Ex ecution at Base and Full Service Levels Utility Service Level Execution Base Full AUDIt NO YES BACKup YES YES EJECt NO YES ENTEr NO YES LIBGen YES YES MOV e NO YES OFFLoad YES YES REPLaceall YES YES REST ore NO NO SCRAtch YES YES SCREdist NO YES SET YES [...]

Chapter 2. Host Software Component Functio ns 25 1st ed., 6/30/04 - 312579601 Display ing/Setting Service Level An HSC opera tor command, SR Vlev , sets a diff erent service level. Refer to information presented on the Display command in Chapte r 2, ‘ ‘C ommands, Control Statements, and Utilities’ ’ in the HSC Operator ’ s Guide for infor[...]

26 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 Media T y pe and Recording T echnique Processing When a job requests specif ic media type and recording technique, the HSC uses information provided by T APEREQ control st atements to select a cartridge with the appropriate media type and influence the tape management system to[...]

Chapter 2. Host Software Component Functio ns 27 1st ed., 6/30/04 - 312579601 MEDia and RECtech P arameter s When a TMI request or MOUNT command is executed, the HSC searches the appropriate control statements to determine the media type and recording technique to assign to the data set. The MEDia and RECtech parameters are specified on the T A PER[...]

28 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 Model P arameter The MODel parameter is specified on th e T APEREQ and UNIT A TTR sta tements. MODel values are processed as if they were RECt ech values. UNIT A TTR control statements do not use the RECtech param eter . T able 3 shows the relationship between MODel and RECtech[...]

Chapter 2. Host Software Component Functio ns 29 1st ed., 6/30/04 - 312579601 Matching V OLA TTR and T APEREQ Statements The type of request (specific or nonsp ecific) determines whether the HSC uses media type and recording technique in formation from the VOLA TTR statement or the T APEREQ statement. (See “Precedence of VOLA TTR and T APEREQ Sta[...]

30 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 Precedence of V OLA TTR a nd T APEREQ Statements The precedence of VOLA TTR and T APEREQ statements depends on whether the request is for a specific or nonspecific volume. Specific V olume Requests For a specific volume request, VOLA TTR in formation overrides T APEREQ informat[...]

Chapter 2. Host Software Component Functio ns 31 1st ed., 6/30/04 - 312579601 How T o Resolve Scratch Sh or tages Whenever the HSC cannot satisfy a library mount request for a sc ratch cartridge, the following message is issued: ... SHORTAGE ACS AA; MMMMMMMM; RRRR RRRR; SSSSSSSS; ... This indicates that one of the following has occurred: • there [...]

32 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 If the recording technique specified in the request is 36-t rack, examine the T APEREQ statements to determine if the requested media must be: • Standard and 36track • Long and 36track • S tandard and LONGItud • Standard and no recording technique specified. Notes: If t[...]

Chapter 2. Host Software Component Functio ns 33 1st ed., 6/30/04 - 312579601 Mount/Dismount Functions Mount and dismount functions cons ist of the following proc essing: • mounting specific volumes • mounting scratch volumes • dismounting library volumes • handling abnor mal mounts and dismounts • virtual thumbwheel (VTW) • automated t[...]

34 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 Mount Processing f o r Scratch V olumes T o process scratch mount requests, the HSC determines which volumes within an LSM are considered as scratch volumes. The HS C makes the determina tion from information contained in the library control data set. Note: A scratch tape is ma[...]

Chapter 2. Host Software Component Functio ns 35 1st ed., 6/30/04 - 312579601 The MNTD P ASSTHRU parame ter works with SCRDISM by setting the maximum number of pass-thrus that can occur for a cartridge that is to be archived. Refer to the ‘ ‘MNTD (Mount/Dismount Opti ons) Command and Control S tatement’ ’ in the HSC Operator ’ s Guide for[...]

36 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 • The TMS is unsatisfied with the scratch cartridge provided. - The HSC dismounts the current volume , removes it from the scratch list, and mounts another scratch volume. Virtual Thumbwheel (VTW) V irtual thumbwhe el is the HSC function that a llows read-only access to a car[...]

Chapter 2. Host Software Component Functio ns 37 1st ed., 6/30/04 - 312579601 T ape T ranspor t Cleaning The HSC allows you to a u tomate the cleaning process or to manually clean library-attached tape transports . When a library transport needs to be cleaned, it informs the LMU, which broadcasts a ‘ ‘drive needs cleaning’ ’ message to all [...]

38 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 Once auto-cleaning is activated, the CLean command can be issu ed to initiate cleaning of specified drives on specified hosts. An exampl e of issuing the CLean command is: Notes: 1. The MNTD AUtocln command must be set to ON before attempting to use the CLean command. 2. The CL[...]

Chapter 2. Host Software Component Functio ns 39 1st ed., 6/30/04 - 312579601 VOLA TTR control statement MAXclean parameter(s). For example, if the helical cleaning cartridges ha ve vo lsers between CLN500 and CLN599, the following VOLA TTR statement can be used to set a different maximum cleaning usage limit for this range of helical cleaning cart[...]

40 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 during tape transpo rt cleaning. The default ca n be changed by using the MNTD EJctauto command. Managing Over-use Cleaning Cartridg es If an operator is not available to empty a CAP , it may be desirable to retain over-use cleaning cartridges in th e LSM for later removal. The[...]

Chapter 2. Host Software Component Functio ns 41 1st ed., 6/30/04 - 312579601 Messages are written to the console if any ov er-use cleaning cartridges are found in the ACS, how many were found, and if an ov er-use cleaning cartridge has been kept in the ACS. These messages help the operator ma nage cleaning cartridges in the ACS. Managing Cleaning [...]

42 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 solution. This task can be used to initia te the clean process for all drives at a predeterm ined time.[...]

Chapter 2. Host Software Component Functio ns 43 1st ed., 6/30/04 - 312579601 V olume/Cell Control Functions V olume/cell control functions c oordinate and control the locatio n of tape cartridges in the library . V olume/cell control functions desc ribed in this section incl ude: • Moving volumes within the library • Scratch subpool management[...]

44 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 Scratch Subpool Mana gement Management of scratch su bpoo ls within the library is an import ant function affecting library performance and your ab ility to have greater control over scratch volume activity . Y ou can effectively manage your scratch su bpools by several availab[...]

Chapter 2. Host Software Component Functio ns 45 1st ed., 6/30/04 - 312579601 Refer to Chapter 2, ‘‘Commands, Control Statemen ts, and Utilities’’ in the HSC Operator’s Guide for detailed informatio n about operator commands and to Chapter 4, ‘‘Utility Functions’’ for information about utilities. Scratch Threshold T ask Restar t T[...]

46 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 Cart ridg e Access P or t (CAP) Processing Func tions CAP processing functions control cartridge enter and eject functio ns. The HSC provides operator commands and utilities which permit you to: • enter cartridges into the library • eject cartridges from the library . The C[...]

Chapter 2. Host Software Component Functio ns 47 1st ed., 6/30/04 - 312579601 Ejecting Cartridg es from the Library Cartridges are ejected from the library by us ing either the EJect command or the EJE Ct utility . Either a single cartridge, a range of cartridges, or a list of cartridges can be identified for removal from the library . The robot lo[...]

48 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 Releasing an Allocated CAP The RELease cap-id operator command allows yo u to re lease a CAP that is allocated to a failed host. A CAP can be left allocated to a system if the HSC terminated with out recovery while the CAP is active. When you issue the command, appropriate me s[...]

Chapter 2. Host Software Component Functio ns 49 1st ed., 6/30/04 - 312579601 Near Continuous Operations A number of HSC facilities and techniques ar e provided that customers can employ to avoid outages and make changes less disr uptive to their library hardware and HSC environment. This section discusses the following topics: • using multiple C[...]

50 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 primary copy . If a standby CDS copy is active , the new primary CDS copy is copied over the standby CDS copy , and the standby becomes the new secondary copy . • If a standby CDS copy is active, and a fa ilure occurs in accessing the secondary CDS copy , the current primary [...]

Chapter 2. Host Software Component Functio ns 51 1st ed., 6/30/04 - 312579601 that are not directly affected. Then, these su bsystems can be recycled (brought down and then restarted) to pick up the changed inform ation. Cycling the affected HSCs can be done at a convenient time, with only one HSC down at a time. This permits an HSC server to remai[...]

52 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 Changing P anels The following procedures desc ribe methods to make c hanges to panels. These include changing panels ty pes in an LSM and removing cartridg es to facilitate ha rdware changes. • T o change panel types in an LSM: 1. Use the SET utility to freeze the pane l, pr[...]

Chapter 2. Host Software Component Functio ns 53 1st ed., 6/30/04 - 312579601 • T o remove cartridges from ro ws on panel(s) to facilit ate hardware (e.g., cabling) changes: 1. Use the SET utility to freeze the pane l, preventing any additional cart ridges from being moved t o it. This prohibits new cartridge home cell locations from being alloca[...]

54 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 Using CDS Rename/Relocate/Expand The HSC can rename, relocate, an d expand an existing CDS(s) without requiring tape activity to be suspended or the HSC to be taken down on all hosts. T o use these features, users must be a t HSC 5.0 or later, however , compatible down-level re[...]

Chapter 2. Host Software Component Functio ns 55 1st ed., 6/30/04 - 312579601 Note: TSO 3.2 may create a single extent data set even when no s econdary quantity is specified. It is not necessary to initialize the CDS copy , that is, you do no t have to execute SLICREA T or copy another CDS copy to the new data set. Assume that ACS.DBASECPY has been[...]

56 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 Warning: StorageT ek recommends backing up al l CDS copies prior to issuing the CDS EXpand command. Failures during th e expand operation usually cause the CDS to be unusable. It is important to back up the CDS be fore invoking the CDS EXpand command to insure that the latest c[...]

Chapter 2. Host Software Component Functio ns 57 1st ed., 6/30/04 - 312579601 Swapping Library T ranspor ts - New Model T ypes When you physically upgrade or change tape transports, a mismatch can occur between the model types stored in the CDS and the updated model types specified in the UNITDEF command. If this situation ari ses, you receive an e[...]

58 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 Common Reco very Functions Common recovery functions consist of in form ation gathering from the control data sets and journals, and processing to recove r from a database or hardware failure. The most vital recovery function is control da ta set recovery which is described in [...]

Chapter 2. Host Software Component Functio ns 59 1st ed., 6/30/04 - 312579601 Control data sets can be accessed by different hosts and are kept synchronized. In event of a failure, the BACKup and REST ore utilities can be used to perform extensive error checking and synchronization of the data. A back up contro l data set an d journals are used to [...]

60 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 Dynamic Enable/Disable of Contr ol Data Sets Operator commands are supplied to give yo u control over which data sets the HSC is utilizing. This functionality is particularly useful in a multiple-processor environment. Before attempting to enable or disable any data set, you ca[...]

Chapter 2. Host Software Component Functio ns 61 1st ed., 6/30/04 - 312579601 3. Make SLS.DBASE2 the new secondary control data se t by issuing the command: 4. Issue the command: to view the current control da ta set status and assign ments. • HSC BACKup and HSC REST ore procedure: 1. S top the host software on all hosts. 2. Backup the control da[...]

62 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 Command Functions Command functions consist of real-time contro l of automated cartridg e handling, dynamic selection of HSC processing options, and v arious query operations. Figure 6 illustrates the specific areas within a library where HSC comm ands enable you to control pro[...]

Chapter 2. Host Software Component Functio ns 63 1st ed., 6/30/04 - 312579601 Controlling LSM Operating Mode The operating mode for any LSM is controlle d by using the MODify command to pl ace the LSM online or of fline. An LSM operating mode is a relationship between an LSM and all attached hosts. The two LSM operating modes are: • automatic –[...]

64 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 Using the VIew command to Inspect an LSM Component When you issu e the VIew command, you d ire ct the vision sy stem to focus on an item inside of the LSM for a spec ified length of time. Upon ente ring the comman d, the following events occur: • A VIew request is sent to the[...]

Chapter 2. Host Software Component Functio ns 65 1st ed., 6/30/04 - 312579601 Utility Functions Utility functions provide control and recovery of library r esources. In addition, reporting of library and volume activity can be invoked using various HSC utilities. Figure 7 illustrates the control concept provided by the va rious HSC utilities. Refer[...]

66 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 LMU Server Functions LMU server functions control each of the Auto mated Cartridge Systems within a library . Many of the LMU server functions are comple tely transparent to users. This section contains information ab out LMU server t asks of which you should be aware. Dual LMU[...]

Chapter 2. Host Software Component Functio ns 67 1st ed., 6/30/04 - 312579601 LMU Switcho ver Messages The HSC Messages and Codes Guide contains all the messages appropriate to the LMU switchover process. After an LMU Switch Occur s After a switch of LMUs occurs and the LSMs have finished quick initialization procedures, all cartridge motion reques[...]

68 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 Adding Ne w Stations to an A CS The following is an example of JCL for the SET utility that can be used as a pattern for adding new stations to an ACS w ithout requiring a reconfiguration. Note: Update LIBGEN control statements to ma ke changes perma nent. Y ou do not have to e[...]

Chapter 2. Host Software Component Functio ns 69 1st ed., 6/30/04 - 312579601 Reconstructing a LIBGEN The Database Decompile (LIB GEN) utility can be used to reconstruct a LIBGEN, reflecting the true configuration of your HSC subsystem if for some reason your LIBGEN has been lost. Refer to “Database Decompile (LIBGEN) U tility” on page 184 for [...]

70 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 Dynamic LMU Connection LMU network connections can be defined dy namically to TCP/IP addresses using the LMUP A TH and LMUPDEF control statements. Note: For information on implementing TCP/IP connections, refe r to the LMUP A TH and LMUPDEF control statemen ts in Chapter 3, “[...]

Chapter 2. Host Software Component Functio ns 71 1st ed., 6/30/04 - 312579601 For example, if a user enters Displa y CDS and the following outpu t appears HOSTID---LEVEL ! FLAG---DESCRIPTION--- HSTA 4.0.0 (F0) ACTIVE PRIMARY SECONDARY STANDBY HSTB 4.0.0 (F0) ACTIVE PRIMARY SECONDARY STANDBY HSTC 4.0.0 (F0) ACTIVE PRIMARY SECONDARY STANDBY HSTD 4.0.[...]

72 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 T ransitioning Between 3270 and TCP/IP A number of methods are available to move between 3270 s tation connections and TCP/IP LMU network attachment. S torageT ek recommends cycling the HSC as the preferr ed process to transition between 3270 and TCP/IP . How ever , the followi[...]

Chapter 2. Host Software Component Functio ns 73 1st ed., 6/30/04 - 312579601 Recovering TCP/IP Comm unications S torageT e k suggests either performing a normal HSC shutdown or changing the HSC state to the base service level prior to recycling TCP/IP or taking TCP/IP down for any extended period of time. Note: Please refer to “Recovery Maintena[...]

74 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 Operator Intervention - Single LMU Configuration If the HSC network recovery times out, the AC S is automatically ch anged to an offline state and all outstanding LMU requests are purged. After troubleshooting the network connection, vary the ACS onlin e. Vary ACS acs-id ONline[...]

Chapter 2. Host Software Component Functio ns 75 1st ed., 6/30/04 - 312579601 Configuring VM fo r TCP/IP Support The following items must be upd ated to allow VM to suppor t TCP/IP station prot ocol. • System Definition File • System Profile File • HSC St artup Job File • LMUP A TH Definition Data Set. System Definition File (A CS SYSDEF) T[...]

76 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 Initializing the LMUP A TH Definition Data Set The next three tasks apply to the LMUP A TH definition data set. Minidisk S tatement for the LMUP A TH Data Set Add a minidisk statement to the director y entry for the STKAC S userid. Refer to “Define the ACS Service Machine” [...]

Chapter 2. Host Software Component Functio ns 77 1st ed., 6/30/04 - 312579601 LMUP A TH Definition Data Set Add the LMUPATH statements to the LM UPDEF data set using the ACS UTIL VOLCOPY command. Note: ACS UTIL VOLCOPY creates skeleton JCL that you modify to match your configuration. /JOB SLSXUTIL SLUGENER /PARM RECCOPY /FILE SYSPRINT DEV PRNT CLAS[...]

78 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 Communication Functions HSC communication functions ensure that pa ssing of pertinent in formation between HSC components and hosts is accomplished successfully . Host-to-Host Comm unications Services The HSC permits you to select the hierar chy of methods used for host-to-host[...]

Chapter 2. Host Software Component Functio ns 79 1st ed., 6/30/04 - 312579601 How Comm unications Services are Set or Changed Communications services are set or change d by the Communications Path (COMMPath) command and control st atement. This command specif ies host, communication method, LMU paths and VT A M path name for the associated host. Th[...]

80 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 COMMPath can be specified by an operator as an operator comman d, or by a systems programmer as a P ARMLIB contro l statement. Before COMMPath is issued, all methods of communications are set to CDS. Refe r to ‘ ‘Communications Path (COMMPath) Command and Contro l Statement[...]

Chapter 2. Host Software Component Functio ns 81 1st ed., 6/30/04 - 312579601 Software Requirements The following software requirements apply: • LMU 3.0 (or higher) or 9315/9330 1.0 (o r higher) µ-software is required for a multiple-level communications service. • ACF/VT AM 3.2 (or higher) must be available to use the VT AM method of communica[...]

82 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 Batch Application Pr ogram Interface (API) The Batch API allows you to re trieve 2.0- and 2.1-level CD S information in batch mode. The CDS specified as input to th e request does not have to be active nor d oes it have to be referenced by the HSC address space (the requ est ex[...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 83 1st ed., 6/30/04 - 312579601 Chapter 3. HSC Contr ol Statements and HSC Star t Pr ocedure Overview This chapter discusses two kinds of control statements, P ARMLIB (below) and definition data set (refer to “Definition Data Set Control S tatem ents” on page 103), and the HSC Start pro[...]

84 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 Processing P ARMLIB Contr ol Statements P ARMLIB control statements are processed at HSC initialization. “Sample ACS SLKJCL File” on page 161 contains /FILE statements defining data sets and members that contain P ARMLI B control statement definitions. Note: In the ACS SLKJ[...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 85 1st ed., 6/30/04 - 312579601 (CDSDEF) Control Statement” on page 87 for control statement syntax, parameter information, and example statements . Communications Path Definition This control statement and operator command prov ides you a way to set the communications path utilized in a [...]

86 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 Option Control The general purpose OPT ion control statement and o perator command provides you methods to contro l the following: • viewing time when us ing the VIew command • issuance of a message if an attempt is made to enter duplicate volumes into a library • display[...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 87 1st ed., 6/30/04 - 312579601 CDS Definition (CDSDEF) Control Statement The CDSDEF control statement is required an d provides static info rmation to the HSC. This information is us ed by the HSC at initialization an d remains for the life of the HSC execution. The primary , secondary , a[...]

88 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 Contr ol Statement Name CDSDEF initiates the control statement. Pa r a m e t e rs DSN x dataset.name is the name of an HSC control da ta set. At least one DSN parameter must be specified, as many as three can be specified. If two data sets are specified, then the volume invento[...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 89 1st ed., 6/30/04 - 312579601 Example The following is an example of us ing the CDSDEF control statement. Note: Control statements can only be contin ued if P ARMLIB begins with a /*... */ comment statement (see “Control Statem ent Syntax Convention s” on page 439). CDSDEF DSN1(SLS.DB[...]

90 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 EXECP arm Control Statement The EXECParm control statement is an alte rnative method for spec ifying the G TF event ID (Eid(gtfeid)) and G TF format ID (Fid(gtffid)). The EXECParm control statement also provides a parameter that enables you to cont rol display of the system com[...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 91 1st ed., 6/30/04 - 312579601 Fid optionally, gtffid specifies a GTF format ID. /PARM Fid(user-specified-format-id) parame ter is valid for use in the HSC startup SLKJCL file as an alternative method of specifying the GTF format ID. HOSTID optionally, host-id specifies the system ID assoc[...]

92 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 Journal Definition (JRNDE F) Control Statement The JRNDEF control statement provides static information to the HSC. This information is used by the HSC at initiali zation and remains for the life of the HSC execution. Control information provided to th e HSC by JRNDEF includes:[...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 93 1st ed., 6/30/04 - 312579601 UNIT x optionally, unitname is used to specify the unit parameter in the SVC99 dynamic allocation parameter list. The UNIT pa rameter must be specified in VM. FULL optionally, this parameter prov ides the following options: Abend the HSC internally abends if [...]

94 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 LKEYDEF Command and Control Statement The LKEYDEF command/contro l statement re trieves LKEYINFO control statements containing HSC license key inform ation, and loads th em into an address space where they are available for retrieval by the HSC license key valida tion service. [...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 95 1st ed., 6/30/04 - 312579601 UNIT Optionally, specifies the unit where the definition data set resides. unitname Indicates the unit name. If the definitio n data set is not cataloged or this parameter is omitted, a unit na me of SYSDA is the default. HOSTID Optionally, limits the execu t[...]

96 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 License Ke y Inf ormation (LKEYINFO) Contr ol Statement The LKEYINFO control statement is used to input license ke y information for the HSC. It is placed in a data set or Partitioned Data Set member identified by an LKEYDEF control statement in the HSC ST AR T procedure, and m[...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 97 1st ed., 6/30/04 - 312579601 KEY Specifies the license key string as received from StorageTe k. license-key-string Indicates the license key string. Examples In the following example, the LKEYINFO cont rol statement is used to input HSC license key information as received from S torageT [...]

98 VM/HSC 6.0 System Prog rammer’s Guide 1st ed., 6/30/04 - 312579601 Reconfiguration CDS Definiti on (RECDEF) Control Statement The RECDEF control statement, in combin ation with the CDSD EF control statement (refer to “CDS Definition (CDSDEF) Control S tatement” on page 87), defines which CDS copies are to be used when running the R econfig[...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 99 1st ed., 6/30/04 - 312579601 Example The following is an example of us ing the RECDEF control statement. Note: Control statements can only be contin ued if P ARMLIB begins with a /*... */ comment statement (see “Control Statem ent Syntax Convention s” on page 439). RECDEF DSN1(SLS.DB[...]

100 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Scratch Subpool Contr ol Statement The scratch subpool control st atement provides you with control of the scratch volume activity in a library . Refer to “Scratch Subpo ol Management” on page 44 for more information relating to this cont rol statement. Warning: If scratch [...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 101 1st ed., 6/30/04 - 312579601 RANGE range specifies the volume serial numbers which the subpool represents. Range start and end values are separated by a single da sh (-). Multiple ranges may be specified separating each ra nge by commas. Notes: 1. The range of volume serial numbers must[...]

102 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Example The following is an example of using the Scratch Subpool control statement. Other Methods of Contr olling Scratch Subpools There are other ways to control scratch volu mes and scratch subpools in the library . The following are additional me thods that may be used: • [...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 103 1st ed., 6/30/04 - 312579601 Definition Data Set Contr ol Statements Definition data sets contain the control statem ents used to define t ape data set storage policies to the HSC. A definition data set must be sequential (it may be a partitioned data set [PDS] member) with any va lid r[...]

104 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Options Offered b y Definition Data Set Contr ol Statements The following defini tion data set control st atements are included in this chapter: OP Tion TITLE This control statement allows you to specify a string that identifies a definiti on data set. Refer to “OPTion TITLE [...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 105 1st ed., 6/30/04 - 312579601 (UNITDEF) Command and Control Statement” o n page 140 for control statemen t syntax, parameter informatio n, and example statements. V olume Attribute The VOLATTR control statement specifies ta pe volume attributes. Refer to “Volume Attribute (VOLATTR) C[...]

106 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Defining Unit Attributes (UNIT A TTR) UNIT A TTR statements describe the recordin g technique attributes of library and nonlibrary transport s. T ransports are described by: • unit address • transport model number . T o allow the HSC to operate correctly , th e user must sp[...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 107 1st ed., 6/30/04 - 312579601 The VOLDEF command caus es the HSC to open the definition data set containing the VOLA TTR statements. See “V olume Attrib ute Definition (VOLDEF) Command and Control S tatement” on page 154 and “V olume Attribute (VOLA TTR) Control Statemen t” on pa[...]

108 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 LMUP A TH Control Statement The LMUP A TH control statement allows user s to define network LMU attachments. LMUP A TH statements are read from the defi nition data set specified by the LMUPDEF command. The LMUP A TH statement must be place d in the definition data set; it cann[...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 109 1st ed., 6/30/04 - 312579601 LMUADDR identifies an LMU by IP address or host na me for each ACS. To designate a single LMU environment, specify one IP address or host name. To sp ecify a dual LMU environment, users can enter an additional IP address and/or host name. Note: A maximum of [...]

110 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 LMUPDEF Command an d Control Statement The LMUPDEF command and control statement is used to specify the definition data set that contains network LMU attachment (LMU P A TH) statements. The data set must be a sequential or a partitioned data set (PDS) with any valid record form[...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 111 1st ed., 6/30/04 - 312579601 Syntax Contr ol Statement Name LMUPDEF Initiates the LMUPDEF comman d and control statement. Pa r am e t e rs DA T ASET or DSN specifies the name of the data set cont aining the LMU PATH statements to be processed and, optionally, an OPTion TITLE statement. [...]

112 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 UNIT specifies the unit where the de finition data set is located. unitname specifies the unit name. If the definitio n data set is not cataloged and this parameter is omitted, a unit name of SYSALLDA is the default. HOSTID (This parameter is valid only for use in PARMLIB, so t[...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 113 1st ed., 6/30/04 - 312579601 OPTion TITLE Control Statement The OP T ion TITLE statement is used to specif y an identifying string for a definition data set. The identifying string can be any informat ion that helps the user describe the contents of the definition data set. The OP T ion[...]

114 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Example The following example illustrates the use of the OP Tion TITLE control statement. Specify an Identifying String For a Definition Data Set OPTION TITLE(‘SAMPLE IDENTIFYING STR ING’) OPTion TITLE[...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 115 1st ed., 6/30/04 - 312579601 Scratch Subpool Definition (SCRPDE F) Command and Contr ol Statement The SCRPDEF command and control statement is used to specify th e definition data set that contains scratch subpool (SCRPOol) para meter statements. (Refer to “Scratch Subpool Control S t[...]

116 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 4. For additional informa tion about syntax, refer to “Control Statement Syntax Conventions” on page 439. Syntax Contr ol Statement Name SCRPDEF initiates the SCRPDEF command and control statement. Pa r a m e t e rs DA T ASET or DSN specifies the name of the data set contai[...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 117 1st ed., 6/30/04 - 312579601 UNIT specifies the unit where the de finition data set is located. unitname specifies the unit name. If the definitio n data set is not cataloged and this parameter is omitted, a unit name of SYSALLDA is the default. HOSTID (This parameter is valid only for [...]

118 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 T ape Request (T APEREQ) Control Statement The T APEREQ control statement is used to specify tape request attributes. T APEREQ statements are read from the definition data set specified by the TR EQDEF command. (Refer to “T ape Request Definition (TREQD EF) Command and Cont r[...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 119 1st ed., 6/30/04 - 312579601 After searching the T APEREQ statements, the HSC • selects the appropriate devices • mounts cartridges that are the right media type. The T APEREQ parameters are divided into selec tion criteria (i.e., input) parameters, and media and recording technique[...]

120 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 W ith the modified definition data set in effect , the HSC searches the remaining T APEREQ statements to determine the media type and re cording technique (or model) to assign to a request. T o disable all T APEREQ definitions, load a definition data set that contains only one [...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 121 1st ed., 6/30/04 - 312579601 Syntax TAPEREQ JOBname( jobname ) * STEPname( stepname ) * PROGram( PGMname( program-name ) * program-name ) DATASET( DSN( dataset-name ) ** dataset-name ) EXPDT( RETPD( , retention-period NE GT LT LE EQ GE , expiration-date EQ NE GT LT GE LE ) ) VOLType( * [...]

122 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Syntax (continued) MEDia( LONGItud ) R Standard CST MEDIA1 STD 1 3480 ECART E ECCST ETAPE Long MEDIA2 3490E ZCART Z HELical DD3 DD3A DD3B DD3C STK1 STK1R STK2 STK2P RECtech( LONGItud ) 18track 36track 36Atrack 36Btrack 36Ctrack HELical DD3 STK1R STK1R34 STK1R35 STK1RA STK1RA34 [...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 123 1st ed., 6/30/04 - 312579601 Contr ol Statement Name TA P E R E Q initiates the T APEREQ control sta temen t. If any of the following apply: • there is no T APEREQ statement specifie d in the definition data set to match a request, or • no matching T APEREQ statement specifies MEDia[...]

124 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 PROGram or PGMname optionally, specifies the program name. If PROGram is not specified, the default value is *. The program name used is the job step program name. program-name specifies the program name.The TAPEREQ statement is used only when the specified program-name matches[...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 125 1st ed., 6/30/04 - 312579601 retention-period specifies the retention period in days fo r the data set. Specify the number of days as a 1- to 4-digit decimal nu mber. EXPDT optionally, specifies the expi ration date and the relat ionship that must exist. expiration-date specifies the ex[...]

126 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 This parameter is ignored fo r an existing data set if the media characteristics are determined by the volume. If this parameter is not spec ified, a default is chosen based on the value of the RECtech parameter. Table 5 shows defau lt values used if MEDia is omitted. T o avoid[...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 127 1st ed., 6/30/04 - 312579601 •E • ECCST • ET APE •L o n g •M E D I A 2 • 3490E. ZCAR T indicates a 3490E, extended capacity cartridge that provides greater stora ge capacity than an ECART. It can be used only on a 9490EE drive. ZCART can be abbreviated as Z. DD3 indicates an[...]

128 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 RECtech optionally, specifies the method used to record data tracks on the ta pe surface for the desired data set. You can enter a list of recording techniques, but they must be separated by commas. Notes: 1. A list specifies a generic pool from wh ich a selection is made. Ther[...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 129 1st ed., 6/30/04 - 312579601 36Atrack indicates a 4490 transport. 36Btrack indicates a 9490 transport. 36Ctrack indicates a 9490EE transport. HELical indicates a device using helical recording. DD3 indicates a device using helical recording. STK1R indicates any 9840 or T9 840B transport[...]

130 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 STK1RC indicates a 3490E or 3590-imag e T9840C transport. STK1RC34 indicates a 3490-image T9 840C transport. STK1RC35 indicates a 3590-image T9 840C transport. STK2P indicates any T9940A transport. STK2P34 indicates a 3490E-imag e T9940A transport. STK2P35 indicates a 3590-ima [...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 131 1st ed., 6/30/04 - 312579601 4490 indicates a 4490 (36-track Silverton) transport. 9490 indicates a 9490 (36-track Timberline) transport. 9490EE indicates a 9490EE (36-track Timberline EE) transport. SD3 indicates an SD-3 (RedWood) transport. 9840 indicates a 3490E-image 9840 transport.[...]

132 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Example The following example illustra tes how to use T APEREQ statements to specify tape request attributes. Set T ape Request Attributes Note: In the example above, the last T APEREQ st atement specifies a user-defined de fault for all data sets that do not match one of the f[...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 133 1st ed., 6/30/04 - 312579601 T ape Request Definiti on (TREQDEF) Command and Control Statement The TREQDEF command and control statement is used to specify the definition data set that contains tape request (T APEREQ) parameter statements. (Refer to “T ape Request (T APEREQ) Control S[...]

134 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Syntax Contr ol Statement Name TREQDEF initiates the TREQDEF comman d and control statement Pa r a m e t e rs DA T ASET or DSN specifies the name of the data set cont aining the TAPER EQ statements to be processed and, optionally, an OPTion TITLE statement. (Refer to “Tape Re[...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 135 1st ed., 6/30/04 - 312579601 UNIT specifies the unit where the de finition data set is located. unitname specifies the unit name. If the definitio n data set is not cataloged and this parameter is omitted, a unit name of SYSALLDA is the default. HOSTID (This parameter is valid only for [...]

136 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Unit Attrib ute (UNIT A TTR) Contro l Statement The UNIT A TTR statement specifies unit attributes and allows the user to define the model number of transports. A series of UNIT A T TR statements can be specified and are contained in the definition data set named in the UNITDEF[...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 137 1st ed., 6/30/04 - 312579601 Syntax Contr ol Statement Name UNIT A TTR initiates the UNITATTR control statement. Pa r am e t e rs ADDRess specifies the unit address to wh ich this definition applies. unit-address indicates a single unit address, multiple addresses, a range of addresses,[...]

138 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 MODel optionally, specifies the model number of a tape transport. Notes: 1. If the model specified does not match that reported by the LM U, an error results which causes all UNIT A TTRs to be rejected. 2. The SL8500 library supports only the T9 x 40 (9840/T9840B/T9840 C and T9[...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 139 1st ed., 6/30/04 - 312579601 T9940B35 indicates a 3590-image T9 940B transport. IGNORE indicates a nonexistent physical transport. Note: IGNORE cannot be specified for a device that actually exists inside the library . HSC validates that UNIT A TTR models, if specified, match those repo[...]

140 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Unit Attrib ute Defini tion (UNITDEF) Command and Control Statement The UNITDEF command and control statement allows the user to specify the data set that contains the unit attribute (UN IT A TTR) statements. The UNITDEF statement can be specified in P A RMLIB, or it can be iss[...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 141 1st ed., 6/30/04 - 312579601 Syntax Contr ol Statement Name UNITDEF initiates the UNITDEF control statement. Pa r am e t e rs DA T ASET or DSN specifies the name of the data set cont aining the UNITATTR statements to be processed and, optionally, an OPTion TITLE statement. (Refer to “[...]

142 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 HOSTID (This parameter is valid only for use in PARMLIB, so that multipl e systems can share a PARMLIB member containing TAPEREQ , VOLATTR, o r UNITATTR statements for different re leases of HSC. If entered from the console, message SLS0018I is issued.) Optionally, limits the e[...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 143 1st ed., 6/30/04 - 312579601 V olume Attribute (V OLA TTR) Control Statement The VOLA TTR control statement is used to specify tape volume attributes. VOLA TTR statements are read from the definition da ta set specified by the VOLDEF comman d. (Refer to “V olume Attribute Definition ([...]

144 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 If you enter any VOLA TTR statement that globally defaults to all volumes (i.e., VOLA TTR SER(*) REC(1 8)), you must precede this statement with VOLA TTRs specifying the cleaning cartridge s for each type of transport defined in the ACS. Cleaning cartridges for longitudinal dri[...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 145 1st ed., 6/30/04 - 312579601 Syntax This syntax diagram is continu ed on the next page. VOLATTR SERial( volser vol-range vol-list , ) MEDia( Standard CST MEDIA1 STD 1 3480 ECART E ECCST ETAPE Long MEDIA2 3490E ZCART Z DD3A DD3B DD3C DD3D STK1R STK1U R U ) STK2 STK2P STK2W VOLATTR[...]

146 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Syntax (continued) Contr ol Statement Name VOLA TTR initiates the VOLATTR control statement. Th is statement appli es to all cartridges including all types of cleaning cartridges. Note: Standard cleaning cartridges that do not match t he cleaning prefix established in the LIBGE[...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 147 1st ed., 6/30/04 - 312579601 Pa r am e t e rs SERial specifies one or more volume serial num bers (VOLSERs) to which this definition applies. volser or vol-range or vol-list identifies a single VOLSER, a VOLSER range, or a list of VOLSERs and/or VOLSER ranges in any combination. This pa[...]

148 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 If this parameter is not spec ified, a default is chosen based on the value of the RECtech parameter. Table 7 shows defa ult values used if MEDia is omitted. If both media type and recording tech nique are omitted, all media types and recording techniques are assume d to be e l[...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 149 1st ed., 6/30/04 - 312579601 •M E D I A 2 • 3490E ZCAR T indicates a 3490E, extended capacity cartridge that provides greater stora ge capacity than an ECART. It can be used only on a 9490EE drive. ZCART can be abbreviated as Z. DD3A, DD3B, DD3C, DD3D indicates a helical cartridge. [...]

150 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 STK2P , STK2W indicates a T9940 cartridge. The media in dicator in the external label is encoded with the cartridge type (P or W). Note: STK2P or STK2W can be abbreviated to P or W , respectively . Types of T9940 cartridges, alon g with their associated media capacities are: ?[...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 151 1st ed., 6/30/04 - 312579601 36Btrack indicates a 9490 (Timberline) transport. 36Ctrack indicates a 9490EE transport. HELical indicates a device using helical recording. DD3 indicates a device using helical recording. STK1R indicates any 9840 or T9 840B transport. STK1R34 indicates a 34[...]

152 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 STK1RC34 indicates a 3490-image T9 840C transport. STK1RC35 indicates a 3590-image T9 840C transport. STK2P indicates any T9940A transport. STK2P34 indicates a 3490E-imag e T9940A transport. STK2P35 indicates a 3590-ima ge T9940A transport. STK2P A indicates a T9940A transport.[...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 153 1st ed., 6/30/04 - 312579601 Notes: 1. If MAXclean is not specified in the VOLA TTR statement, t he value or default of the MAXclean parameter in the MNTD operator command is used for all cleaning cartridge counts. 2. If MAXclean is specified, the MEDi a setting must be S tandard, DD3D,[...]

154 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 V olume Attrib ute Definition (V OLDEF ) Command and C ontr ol Statement The VOLDEF command and control statement is used to specify the definition data set that contains volume attribute (VOLA TTR) statements. (Refer to “V olume Attribute (VOLA TTR) Control Statement” on p[...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 155 1st ed., 6/30/04 - 312579601 Syntax Contr ol Statement Name VOLDEF initiates the VOLDEF comman d and control statement. Pa r am e t e rs DA T ASET or DSN specifies the name of the data set cont aining the VOLATTR statements to be processed and, optionally, an OPTion TITLE statement. (Re[...]

156 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 UNIT specifies the unit where the de finition data set is located. unitname specifies the unit name. If the definitio n data set is not cataloged and this parameter is omitted, a unit na me of SYSALLDA is the default. HOSTID (This parameter is valid only for use in PARMLIB, so [...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 157 1st ed., 6/30/04 - 312579601 Creating an SLKJCL File f or Starting the HSC An SLKJCL file must be created on the AC S191-disk. The ACS INIT command submits the SLKJCL file. This loads the nucleus of the HSC into main storage, instructs the SCP to allocate data sets, and invokes the libr[...]

158 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SSYS specifies that HSC initializatio n search for the subsystem name specified. If SSYS is specified, the name must match the LIBS UBSYS parameter value in the system profile (SYSPROF). If the name is not foun d or is not a valid name, the subsystem terminates. subsystem must [...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 159 1st ed., 6/30/04 - 312579601 This parameter should only be used in extreme situatio ns an d may not correct all error conditions. Contact StorageTek Software Support before usin g this parameter. Eid xxxx is 1 to 4 hex characters specifying the G TF event ID used for the duration of thi[...]

160 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 HSC Star tup Job (ACS SLKJCL) Perform the steps in the following procedure to create the job file to be used to start the library subsystem. It is later invoked in an AUT OJOB statement in the ACS SYSPROF file. 1. Log on to MAINTSTK. 2. Issue the command: ACS UTIL HSCINIT (NOSE[...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 161 1st ed., 6/30/04 - 312579601 Example The following listing is an example job for the ACS INIT command. Sample A CS SLKJCL File /JOB jobname SLSBINIT /PARM E(E086) F(17) MEMBER(xx) /FILE SLSSYSXX DEV <vaddr> DSN <dsn ame><(member)> /COMM If using a library with multi pl[...]

162 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Notes: 1. The job name i n the startup SLKJCL file mu st match the subs yste m name specified with the LIBSUBSYS parameter in the SYSPROF or it must be specified with the SSYS parameter in the /P ARM statement. Refer to “SSYS” on page 158 for more information. 2. Control da[...]

163 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Starting HSC Execution Initialize the HSC. Refer to “Starting the HSC” on page 165 for i nfo rmation about how to start execution of the HSC. Note: The subsystem name specified with th e LIBSUBSYS parameter in the SYSPROF must match the jobname in the startup SLKJCL file or[...]

164 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 In these cases, the affected ACS(s) is forced offline. The HSC continues to support the unaf fected ACS(s). While the unaffected ACS(s) remains online, the mismatched c onfiguration can be corrected. If the hardware configuration is in correct, the affected ACS(s) can then be b[...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 165 1st ed., 6/30/04 - 312579601 Star ting the HSC The HSC software can be in itialized in three ways: • Start the ACS service machine via the CP AUT OLOG command. • Issue the ACS INIT command from the service machine virtual cons ole. • Submit the HSC st artup SLKJCL to the ACS servi[...]

166 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Initializing the HSC to the Full Service Level Normally , HSC software is initialized to th e full service level when it is started. The syntax for the commands used to initialize the HSC to the full service level is shown below . Syntax for Initializing HSC to Full Service Lev[...]

Chapter 3. HSC Control Statemen ts and HSC Start Procedure 167 1st ed., 6/30/04 - 312579601 Initializing the HSC to the Base Service Level HSC software can be started to the base servi ce level by adding the BASE parameter on the /P ARM statement of the startup SLKJCL, this includes specifying it on the ACS INIT or ACS SUBMIT commands. When usi ng [...]

168 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601[...]

Chapter 4. Util ity Functions 169 1st ed., 6/30/04 - 312579601 Chapter 4. Utility Functions Overview of Library Utilities The HSC contains utility functions that pr ovide you with ways to manage library resources. Primary u tility functions include: • library CDS maintenance • control of library cartridges • control of scratch volumes • pre[...]

170 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 • The ACS UTIL exec ca n be used to genera te a template for all required SLKJCL and control statements for any utilities requeste d, and is recommended for beginners. Selecting a Utility There are many utilities described within this chapter . If you know wh at function you [...]

Chapter 4. Util ity Functions 171 1st ed., 6/30/04 - 312579601 Note: If you are running a mixed multi-host comple x of HSC 5.0, 5.1, and 6.0 systems, refer to Appendix D, ‘ ‘Mi gration Process’ ’ in the HSC Installation Guide for the proper utility release level. Restore or recreate the library CDS REST ore Set or change library configurati[...]

172 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 T ypical Use of Utilities A typical use of utility functions might be, fo r example, to enter some cartridges into the library through the CAP using the Enter Cartri dges utility , add scratch volumes to the CDS by invoking the Scratch Update utility , and run the V olume Repor[...]

Chapter 4. Util ity Functions 173 1st ed., 6/30/04 - 312579601 The V olume Report utility executes in the SCP batch job environm ent in CMS, or in stand-alone mode in the POST/SAE enviro nment. Stand-alo ne mode allows the administrator to locate backup tapes when the ACS service m achine cannot be started due to the loss of a critical DASD data se[...]

174 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 A CS UTIL Exec The most convenient wa y for a beginner to run the utiliti es is to use the ACS UTIL exec. When provided with the names of the utilities to be executed, the ACS UTIL exec builds a file containing the control statements requir ed to execute these u tilities in the[...]

Chapter 4. Util ity Functions 175 1st ed., 6/30/04 - 312579601 CMS En vir onment For utilities that run in the CM S environment, an edit session of an EXEC 2 file is presented for you to modify . The f ile identifier is ACSCMS EXEC. Note: For systems running VM ESA V ersion 2 or higher , utilities that are run in CMS can run in XA or XC mode with S[...]

176 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 5. Enter the XEDIT command FIL E. The file ACSCMS EXEC A is then executed to run the utility , and the ACSCMS ex ec remains on the caller ’ s A-disk. SCP En vir onment For utilities that run in the SCP environment, job statements for the requested utilities are constructed fr[...]

Chapter 4. Util ity Functions 177 1st ed., 6/30/04 - 312579601 JCL and Control Statements Although the ACS exec ca n generate a template job file, th e uti lity control statements (and possibly the SCP JCL) must be modified by the user . T o do this the user should have some understanding of the format and function of these statements. SCP Batch Jo[...]

178 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 /P ARM Statement The /P ARM statement supplies pa rameters for the program (p gmname). These parameters and their format are progra m dependent. There may be only one /P ARM statement per jo b. If supplied, it must immediately follow the /JOB statement. parms the parameters to [...]

Chapter 4. Util ity Functions 179 1st ed., 6/30/04 - 312579601 Submitting Jobs Jobs may be submitted to the AC S service machine in several ways. 1. One method is to use ACS EXEC. This method does not requi re that the sender knows the protocol or the name/node of the ACS service machine. It is the recommended technique. EXEC ACS SUBMIT fname ftype[...]

180 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Utility Control Statements Contr ol Statements vs. JCL In contrast to the SCP Job Control Language , the utility control stat ements are processed only by the executed utility , not by the SCP . They supply all the specific parameters required to execute a utility program (that[...]

Chapter 4. Util ity Functions 181 1st ed., 6/30/04 - 312579601 Utility Administrator (SLU ADMIN) The SLUADMIN program operates as a batch jo b and controls initialization processing for most utility functions. The utility administrator (SLUADMIN) can accept multiple control statements which are handled as serial requests for multiple utilities. If [...]

182 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 How to In v oke Utility Pr ograms For convenience, most utility pr ograms are packaged to app ear as a single, user-invoked program. The Performance Log Reblocker utility is an exception. All other utility functions are invoked as a normal ba tch job using the SLUADMIN program [...]

Chapter 4. Util ity Functions 183 1st ed., 6/30/04 - 312579601 Repor ts Created b y Utili ties Several utilities produce reports when executed. The reports are in addition to the utility function. Utilities that produce reports include: • Activities Report • AUDit •B A C K u p •M O V e • V olume Report. A description of each utility and r[...]

184 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Note: The DA TE parameter does not control report header date formats, which are displayed as yyyy-mm-dd . See Figure 9 on page 197 for an example of this format. Example Several JCL examples using the optio ns for report he adings follow: Example of JCL Using Report Headin g O[...]

Chapter 4. Util ity Functions 185 1st ed., 6/30/04 - 312579601 Stand-Alone Utilities Most of the utility functions require the Host Software Component (HSC) to be up and functional. Some utilities run stan d-alone, in the sense that th ey perform no dialogues with other HSC components, but they do require th e VM Operating System to be available an[...]

186 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Activities Repor t Utility The Activities Report utility provi des you with inform ation to analyze library resource loading by volume grou ps (for example, scratch comp ared to nonscratch, mo unted, dismounted, entered, and ejected). This repo rt provides the information neces[...]

Chapter 4. Util ity Functions 187 1st ed., 6/30/04 - 312579601 PA R M parameters to the SLUADMIN pr ogram that drive the utility. MIXED specifies that output is to be mi xed case. The default is uppercase. NOHD specifies that page headers are not to be printed. The default is to print page headers. SLSCNTL vaddr DSN dsname specifies the name of the[...]

188 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Syntax Utility Name ACTIvities specifies that an activities re port is to be produced. P arameters BEGIN optionally specifies the beginning of th e period for the activities analysis. begin-date begin-date specifies the starting da te of the analysis, expressed in mm/dd/yy or y[...]

Chapter 4. Util ity Functions 189 1st ed., 6/30/04 - 312579601 Examples: In each of the following ex amples, activity re porting begins on October 27 , 1997 at midnight. BEGIN(10/27/97,00:00:00 BEGIN(19971027,00:00:00) BEGIN(TODAY,00:00:00) BEGIN(,00:00:00) END optionally specifies the end of the period for the activities analysis. end-date end-dat[...]

190 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 In v oking the Activiti es Repor t Utility T o invoke the Activities Report utility i n VM, enter: EXEC ACS UTIL ACTIVities Execution of the statement results in the following ACSCMS EXEC file: A CSCMS EXEC T o execute the ACTIvities utility: 1. Remove th e comment indicator (*[...]

Chapter 4. Util ity Functions 191 1st ed., 6/30/04 - 312579601 Cartridg e Movem ent Statistics - Move Section of the Report In the first section of the report, the Move section, the HSC provid es two summary lines: • The first summary line lists from 1 to 16 SMF system IDs found in the SMF records input to the utility . • The second summary lin[...]

192 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 All ‘‘-same LSM’’ subcategories report moves which have the source and destination of the mo ve in the same LSM. All ‘‘-diff LSM’’ subcategories report moves which have the source and destin ation of the move in different LSMs. % of all is the percent of mo ve o[...]

Chapter 4. Util ity Functions 193 1st ed., 6/30/04 - 312579601 Earliest is the date ( mm/dd/ yy or yyyymmdd ) and time ( hh:mm:ss ) of the earliest SMF record found matching the category being reported for the duratio n requested. Latest is the date ( mm/dd/ yy or yyyymmdd ) and time ( hh:mm:ss ) of the last SMF record found matching the category b[...]

194 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 7. As the HSC attempts to float dismounts to a nearby LSM, there should be less pass-thru activity on dismounts than on mounts. However , to float cartridges, free cells must be available. Ejects also may incur more pass-thru activity than enters because the HSC attempts to pla[...]

Chapter 4. Util ity Functions 195 1st ed., 6/30/04 - 312579601 Overall A CS Statistics - A CS Section of the Report For the ACS section of the Activities repo rt, ACS statistics are reported under the following report headings: ACS ID is the ACS number of the ACS being reported, the numb er of SMF records, and the earliest and latest SMF record dat[...]

196 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Usage Notes 1. Mer ging multi-host HSC SMF records impacts the LSM ARM USE st atistic as described above. However , not mer ging multi-host HSC SMF records affects the number of pass-thrus reported, as this is on ly the number of pass-thru operations occurring during the hosts [...]

Chapter 4. Util ity Functions 197 1st ed., 6/30/04 - 312579601 SLUADMIN (n.n.n) Storage Tek Automated Cartridge System Utility PAGE 0001 TIME hh:mm:ss Control Card Image Listing DATE yyyy-mm-dd ACTIVITIES BEGIN(20040301) SLUADMIN (n.n.n) Storage Tek Automated Cartridge System Utility PAGE 0002 TIME hh:mm:ss Activities Begin 2004-03-01 DATE yyyy-mm-[...]

198 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 A udit Utility The Audit utility provides the user the ability to perform a physical inventory of library volumes and to optionally update the library control data set to reflect all observed changes in cell storage for the specified co mponent(s). Identification of the library[...]

Chapter 4. Util ity Functions 199 1st ed., 6/30/04 - 312579601 Y ou can specify whether or not the library control data set is updated as a result of audit, or if only the discrepancy listing is produced by the parameters chosen. • If the APPly(YES) is specified, the library control data set is updated to reflect all observed contents in cell sto[...]

200 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 • If the media value is unreadable by the LMU (recorded in the CDS), the HSC issues a warning message. • If the media value is unreadable by the LMU (not recorded in the CDS), the HSC issues a warning message. In both of these cases (APPL Y(NO) or APPL Y(YES)), the audit co[...]

Chapter 4. Util ity Functions 201 1st ed., 6/30/04 - 312579601 After the Audit ejects volumes from the curre nt panel, a write-to-operator with reply (WTOR) is issued allowing the operator to keep or release the CAP . If the operator responds with a ‘ ‘K’ ’, the CAP remains allo cated for the du ration of the Audit. If the operator responds[...]

202 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Syntax Utility Name AUDIt specifies that an audit ope ration is to be performed. P arameters ALL specifies that the total lib rary is to be audited. APPly (YES) specifies that the Audit operation ej ects cartridges with duplicate VOLSERs, unreadable or illegal external media la[...]

Chapter 4. Util ity Functions 203 1st ed., 6/30/04 - 312579601 LSM optionally specifies that only certain LS Ms within the specif ied ACS are to be audited. (lsm-list) An lsm-list can be a single LSMid or a list of LSMid s. An LSMid ( lsm-id ) is made up of the ACSid (hexadecimal 00 -FF) and the LSM number (hexadecimal 00-17) separated by a colon ([...]

204 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 ROW optionally specifies that only certain rows within the specified LSM panel are to be audited. (row-list) row-list may be a single row or a list of rows. Ranges are not allowed. If a list is specified, the elements must be separate d by blanks or commas, and the entire list [...]

Chapter 4. Util ity Functions 205 1st ed., 6/30/04 - 312579601 • For 4410 and 9310 LSMs, valid column entries are 0 though 23, left to right, for outside wall panel columns. Inn er wall panels are numbered 0 through 19, right to left. • For 9360 (W olfCreek) LSMs, columns 0 throu gh 5 can be specified. • For 9740 LSMs, valid column entries ar[...]

206 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Note: If a CAP is not specified, a CAP in the identified ACS is selected based on the CAPPref operator command (refe r to the ‘ ‘CAP Preference (CAPPref) Command and Contro l Statement’ ’ in the HSC Operator ’ s Guide ). Multi-ACS audits cannot specify the CAP para me[...]

Chapter 4. Util ity Functions 207 1st ed., 6/30/04 - 312579601 INTRANs optionally specifies that in-transit c artridg es in an LSM are to be processed. All in-transit cartridges, ex cept those identified in the note below, are read and ejected as part of an AUDIt utility operation. Notes: 1. INTRANs is mutually exclusive with the APPL Y(NO) paramet[...]

208 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 3. Specify values for the desired param eters. 4. Delete the parameters that are not desired. 5. Enter the command ‘ ‘FILE.’ ’ The job file is then submitted to the ACS service machine for execution. JCL Examples The following example shows JCL for auditing an entire li[...]

Chapter 4. Util ity Functions 209 1st ed., 6/30/04 - 312579601 JCL for Selec tive A udit of Empty Cells JCL for Selec tive A udit of Diagnostic Cells Onl y JCL for Selec tive A udit that Inclu des Diagnostic Cells Output Description Output resulting from the executio n of the Audit utility includes: • a listing of input commands with approp riate[...]

210 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SLUADMIN (n.n.n) Storage Tek Automated Cartridge System Utility PAGE 0001 TIME hh:mm:ss Control Card Image Listing DATE yyyy-mm-dd AUDIT ACS(00) LSM(11) SLUADMIN (n.n.n) Storage Tek Automated Cartridge System Utility PAGE 0002 TIME hh:mm:ss Audit Utility DATE yyyy-mm-dd -SLS023[...]

Chapter 4. Util ity Functions 211 1st ed., 6/30/04 - 312579601 Bac kup Utility The BACKup utility allows you to back up the library control da ta set. The control data set is the single most important resource requir ed in the operatio n of the HSC. V arious controls and services are availabl e to keep the control data set intact and to enable you [...]

212 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 How the B A CK up Utility Functions The BACKup utility performs ex tensive error checking on CDS records, as well as comparison checking betw een primary and secondary copies of the CDS. Note: In order to run a back up correctly , all data sets currently defined to the HSC shou[...]

Chapter 4. Util ity Functions 213 1st ed., 6/30/04 - 312579601 Backup Pr ocedure Backup of the control data set may be perfo rmed using conventions for specifying the secondary control data set and with copy data sets to enable block analysis, if desired. The following procedure describes st eps for performing backups (see “JCL Examples” on pag[...]

214 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 • A void running the SET util ity . • A void running the Scratch Update and Scra tch Redi stribution functions durin g this time. • T ake all HSCs down prior to the link being restored. Special considerations after the link is restored include: • A void restoring CDS co[...]

Chapter 4. Util ity Functions 215 1st ed., 6/30/04 - 312579601 For regularly scheduled backups of HSC co ntrol data sets, do not specify the CDS keyword when each CDS co py is not being backed up individually in the same time frame. The reason for not specifying the CD S keyword is that a CDS switch(es) may have taken place. (Primary) specifies tha[...]

216 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 summary report and to the SLSBKUP data set. Refer to Figure 11 on page 222 to see a sample discrepancy report. An e rrant and in-transit destination report, followed by a block processing report, also is produced in this case. Figure 11 shows these reports. Note: The VOLSERs an[...]

Chapter 4. Util ity Functions 217 1st ed., 6/30/04 - 312579601 JCL Requirements The following definitions apply to the BACKup utility JCL: SLSPRINT the message output data se t. SLSCNTL the primary control data set. Th is statement must be provided. SLSCNTL2 the secondary control data set. If a secondary CDS exists, it should be specified so that i[...]

218 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 In v oking the B A CKup Utility The easiest way to run utilities is to execute the ACS UTIL exec by entering the following command: EXEC ACS UTIL BACKUP Execution of the statement results in the ACSUTIL SLKJCL file: A CSUTIL SLKJCL File T o execute the utility: 1. Delete the li[...]

Chapter 4. Util ity Functions 219 1st ed., 6/30/04 - 312579601 JCL Examples V arious examples showing JCL for running th e BACKup utility are presented. Select an appropriate example match ing the control statement con ventions that you have used for specifying data sets. JCL for Running Back up The first example shows JCL for backup with the prima[...]

220 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 This example specifies BACKup with the SLSCNTL statement to identify the primary control data set. Backup is processed withou t a secondary control data set and journals. JCL for Bac kup of the Primary CDS without Secondary and Journals Output Description Output resulting from [...]

Chapter 4. Util ity Functions 221 1st ed., 6/30/04 - 312579601 • a condition code from backup processing: 0 no errors and no SLUADMIN control cards generated 4 warning MESSAGES – Backup successful 8 a system failure occurred. Restart or rerun backup. Backup[...]

222 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SLUADMIN (n.n.n) STORAGETEK AUTOMATED CARTRIDGE SYSTEM UTILITY PAGE 0001 TIME hh:mm:ss CON TROL CARD IMAGE LISTING DATE yyyy-mm-dd BACKUP OPTION(ANALYZE) SLUADMIN (n.n.n) STORAGETEK AUTOMATED CARTRIDGE SYSTEM UTILITY PAGE 0002 TIME hh:mm:ss BACKUP UTILITY DATE yyyy-mm-dd SLS131[...]

Chapter 4. Util ity Functions 223 1st ed., 6/30/04 - 312579601 SLUADMIN (n.n.n) STORAGE TEK AUTOMATED CARTRIDGE SYSTEM UTILITY PAGE 0004 TIME hh:mm:ss BACKUP UTILITY DATE yyyy-mm-dd SLS1210I PROCESSING HAS STARTED FOR THE DITA BLOCK SLS1211I PROCESSING COMPLETE FOR THE DIT A BLOCK SLS1210I PROCESSING HAS STARTED FOR THE DITR BLOCK SLS1211I PROCESSI[...]

224 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 How to Restart Backup After executing the BACKup utility , if a system failure or any other circumstance occurs that causes a return code of eight (RC=8), the BACKup utility can be restarted as long as criteria described in “Parameters” on page 214 for OP T ion(Restart) is [...]

Chapter 4. Util ity Functions 225 1st ed., 6/30/04 - 312579601 Database Decompile (LIBGEN) Utility The Database Decompile utility provides a way to generate LIBGEN macro statements from an existing library control data set. Prerequisites The utility runs under the cont rol of the SLUADMIN program and does not require the HSC to be running. Reasons [...]

226 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Syntax Utility Name LIBGEN specifies that database processing is to be performed and invokes the SLUDBM AP module. SLUDBMAP creates a complete HSC LIBGEN from an existing control data set. P arameters None. JCL Requirements The following definitions appl y to the LIBGEN utility[...]

Chapter 4. Util ity Functions 227 1st ed., 6/30/04 - 312579601 In v oking the Database Decompile Utility The easiest way to run utilities is to execute the ACS UTIL exec by entering the following command: EXEC ACS UTIL LIBGEN Execution of the statement results in the ACSUTIL SLKJCL file: A CSUTIL SLKJCL File T o execute the utility: 1. Delete the l[...]

228 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Output Description Outputs resulting from the execution of the Database Decompile utility include: • a valid LIBGEN file matching the existing contro l data set. The output file has the following characteristics: - All station and drive addresse s are 4-character addresses. -[...]

Chapter 4. Util ity Functions 229 1st ed., 6/30/04 - 312579601 *********************************************************************** * THIS IS A LIBGEN OF A SINGLE ACS WITH 24 POWDERHORN LSMS ATTACHED * * TO 16 HOSTS. EACH LSM HAS A SINGLE DRIVE PANEL WITH 4 DRIVES * *********************************************************************** * LIBGEN[...]

230 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 * LSM0002 SLILSM PASTHRU=((2,S),(4,S),(6,M),(8,M)), X ADJACNT=(LSM0000,LSM0001,LSM0003,LSM0004), X DRIVE=(10), X DRVELST=(P00002), X TYPE=9310, X DOOR=ECAP * P000002 SLIDLIST HOSTDRV=(D0000002,D0000002,D0000002,D0000002, X D0000002,D0000002,D0000002,D0000002,D0000002, X D000000[...]

Chapter 4. Util ity Functions 231 1st ed., 6/30/04 - 312579601 * LSM0006 SLILSM PASTHRU=((2,S),(4,S),(6,M),(8,M)), X ADJACNT=(LSM0004,LSM0005,LSM0007,LSM0008), X DRIVE=(10), X DRVELST=(P000006), X TYPE=9310, X DOOR=ECAP * P000006 SLIDLIST HOSTDRV=(D0000006,D0000006,D0000006,D0000006, X D0000006,D0000006,D0000006,D0000006,D0000006, X D0000006,D00000[...]

232 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 * LSM000A SLILSM PASTHRU=((2,S),(4,S),(6,M),(8,M)), X ADJACNT=(LSM0008,LSM0009,LSM000B,LSM000C), X DRIVE=(10), X DRVELST=(P00000A), X TYPE=9310, X DOOR=ECAP * P00000A SLIDLIST HOSTDRV=(D000000A,D000000A,D000000A,D000000A, X D000000A,D000000A,D000000A,D000000A,D000000A, X D00000[...]

Chapter 4. Util ity Functions 233 1st ed., 6/30/04 - 312579601 * LSM000E SLILSM PASTHRU=((2,S),(4,S),(6,M),(8,M)), X ADJACNT=(LSM000C,LSM000D,LSM000F,LSM0010), X DRIVE=(10), X DRVELST=(P00000E), X TYPE=9310, X DOOR=ECAP * P00000E SLIDLIST HOSTDRV=(D000000E,D000000E,D000000E,D000000E, X D000000E,D000000E,D000000E,D000000E,D000000E, X D000000E,D00000[...]

234 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 * LSM0012 SLILSM PASTHRU=((2,S),(4,S),(6,M),(8,M)), X ADJACNT=(LSM0010,LSM0011,LSM0013,LSM0014), X DRIVE=(10), X DRVELST=(P000012), X TYPE=9310, X DOOR=ECAP * P000012 SLIDLIST HOSTDRV=(D0000012,D0000012,D0000012,D0000012, X D0000012,D0000012,D0000012,D0000012,D0000012, X D00000[...]

Chapter 4. Util ity Functions 235 1st ed., 6/30/04 - 312579601 * LSM0016 SLILSM PASTHRU=((8,S),(6,S),(4,M)), X ADJACNT=(LSM0014,LSM0015,LSM0016), X DRIVE=(10), X DRVELST=(P000016), X TYPE=9310, X DOOR=ECAP * P000016 SLIDLIST HOSTDRV=(D0000016,D0000016,D0000016,D0000016, X D0000016,D0000016,D0000016,D0000016,D0000016, X D0000016,D0000016,D0000016,D0[...]

236 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Directory Rebuild Utility The Directory Rebuild utility pr ovides a means to rebuild the database directory for all defined CDS copies. Prerequisites The stand-alone Dire ctory Rebuild utility: • runs under the control of the SLUADMIN utilities program • may be run while th[...]

Chapter 4. Util ity Functions 237 1st ed., 6/30/04 - 312579601 SLSCNTL, SLSCNTL2, SLSSTBY SLSCNTL is the primary CDS, SLSCNTL2 is the secondary CDS, and SLSSTBY is the standby CDS from which the directory is rebuilt. This statement is required for each CDS that has been defined. SLSIN input to the utility in the form of control cards. In v oking th[...]

238 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 JCL Example The following example show s JCL for Directo ry Rebuild execu tion. JCL for Directory Reb uild Output Description Output resulting from the execution of the Directory Rebuild ut ility includes: • a listing of input commands with approp riate messages when syntax e[...]

Chapter 4. Util ity Functions 239 1st ed., 6/30/04 - 312579601 Eject Car tridge Utility The EJECt Cartridge utility perm its you to remove one or mo re cartridges from an ACS in a batch mode. For the automate d ejection of cartridges, the EJECt Cartridge utility takes advantage of the Cartridge Ac cess Port (CAP) in an LSM. The control statement al[...]

240 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Utility Name EJECt specifies that ejection processing is to be performed. Eject Method 2 (continued): MEDia( Standard ) CST MEDIA1 STD 1 3480 ECART E ECCST ETAPE Long MEDIA2 3490E ZCART Z DD3A DD3B DD3C STK1R R STK2 RECtech( 18track 36Atrack 36Btrack 36Ctrack DD3 ) STK1R STK1R3[...]

Chapter 4. Util ity Functions 241 1st ed., 6/30/04 - 312579601 P arameters VO L se r specifies that a VOLSER(s) is to be ejected. (vol-list) vol-list specifies the list of volumes to be ejected. A vol-list can be a single VOLSER, a range of VOLSERs or a list of VOLSERs and/or VOLSER ranges in any combination. If a list is specified, the el ements m[...]

242 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 •C S T •M E D I A 1 • STD •1 • 3480 ECAR T indicates a 3490E, extended capacity cartridge. It can be used only on a 36-track drive (4490, 9490 , or 9490EE). Synonyms inclu de: •E • ECCST •E T A P E • Long •M E D I A 2 • 3490E ZCAR T indicates a 3490E, exte[...]

Chapter 4. Util ity Functions 243 1st ed., 6/30/04 - 312579601 STK2 indicates any T9940 cartridge. This para meter is the default for all T9940A and T9940B data cartridge types. STK2P indicates a T9940 data cartridge. The me dia indicator in the external label is encoded with the cartridge type (P). Note: STK2P can be abbreviated to P . RECtech opt[...]

244 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 STK1R34 indicates a 3490E-image 9840 transport. STK1R35 indicates a 3590-image 9840 transport. STK1RA indicates a 3490E or 359 0-image 9840 transport. STK1RA34 indicates a 3490E-image 9840 transport. STK1RA35 indicates a 3590-image 9840 transport. STK1RB indicates a 3490E or 35[...]

Chapter 4. Util ity Functions 245 1st ed., 6/30/04 - 312579601 STK2P A indicates a T9940A transport. STK2P A34 indicates a 3490E-imag e T9940A transport. STK2P A35 indicates a 3590-ima ge T9940A transport. STK2PB indicates a T9940B transport. STK2PB34 indicates a 3490E-imag e T9940B transport. STK2PB35 indicates a 3590-image T9 940B transport. CAP [...]

246 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 • For 9360 LSMs, the 20-cell W olfCreek CAP • For 9740 LSMs, fixed rack 14-cell or 10-cell remo vable magazine CAP • For SL8500 libraries, the CAP cons ists of 3, 13-cell remo vable magazines. 01 • For 4410 and 9310 LSMs, left-hand 40-cell enhanced CAP • For 9360 LSMs[...]

Chapter 4. Util ity Functions 247 1st ed., 6/30/04 - 312579601 4. Delete the parameters that are not desired. 5. Enter the command ‘ ‘FILE.’ ’ The job file is then submitted to the ACS service machine for execution. JCL Examples The following exa mple shows JCL for ejec ting a single volume from the library . JCL for Ejectin g a Single V ol[...]

248 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Output Description Output resulting from the execution of the EJECt Cartridge utility includes: • a listing of input commands, with appropri ate messages, when syntax errors occur • messages associated with e rror conditions resulting from an unsuccessful attempt to execute[...]

Chapter 4. Util ity Functions 249 1st ed., 6/30/04 - 312579601 Enter Car t ridg es Utility The Enter Cartridges utility permits you to ba tch enter cartridges into the library through the CAP . CAP Operating Instructions Operating instructions for the CAP are provided in the HSC Operator ’ s Guide . Note: When there are no more cartridges to be e[...]

250 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 00 • For 4410 and 9310 LSMs, standard 21-cell CAP or the right-hand 40-cell enhanced CAP • For 9360 LSMs, the 20-cell W olfCreek CAP • For 9740 LSMs, fixed rack 14-cell or 10-cell remo vable magazine CAP • For SL8500 libraries, the CAP cons ists of 3, 13-cell remo vable[...]

Chapter 4. Util ity Functions 251 1st ed., 6/30/04 - 312579601 T o execute the utility: 1. Delete the lines in the t emplate that ar e not required, or leave the comment indicator (*) in column one. 2. Remove th e comm ent indicator from the desired lines. 3. Specify values for the desired param eters. 4. the parameters that are not desired. 5. Ent[...]

252 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SLUADMIN (n.n.n) Stor ageTek Automated Cartridge System Utility PAGE 0001 TIME hh:mm:ss Control Card Image Listing DATE yyyy-mm-dd ENTER CAP(01) SLUADMIN (n.n.n) Stor ageTek Automated Cartridge System Utility PAGE 0002 TIME hh:mm:ss Enter Cartridges Utility DATE yyyy-mm-dd SLS0[...]

Chapter 4. Util ity Functions 253 1st ed., 6/30/04 - 312579601 Journal Offload Utility The Journal Of fload utility allows y ou to of fload one or both of the journals on a given host without backing up the control data set. It is e xtremely importa n t that you archive the offloaded journals, in the even t that these journals are requ ired for a r[...]

254 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SLSOFF02 the created offload data set fo r the second journal (SLSJRN02). Note: The of fload data sets created by SLSO FF01 and SLSOFF02 mu st be allocated on DASD. Y ou can then copy the offloaded DASD data sets to tape if you desire. SLSIN input to the utility in the form of [...]

Chapter 4. Util ity Functions 255 1st ed., 6/30/04 - 312579601 JCL Example The following example shows JCL for the of fload of both journals. JCL for Offload of J ournals Output Description Output resulting from the execution of the Journal Of fload utility (see Figure 15 on page 256) includes: • the journal(s) is copied to the offload data set(s[...]

256 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SLUADMIN (n.n.n) StorageT ek Automated Cartridge System Utility PAGE 0001 TIME hh:mm:ss Control Card Image Listing DATE yyyy-mm-dd OFFLOAD) SLUADMIN (n.n.n) StorageT ek Automated Cartridge System Utility PAGE 0002 TIME hh:mm:ss Journal Offload Utility DATE yyyy-mm-dd SLS0282I J[...]

Chapter 4. Util ity Functions 257 1st ed., 6/30/04 - 312579601 Mo ve Utility The MOV e utility permits you to request the HSC to move a single volume, a list of volumes, or a range of volu mes to other locations within an ACS. MO V e Considerations Y ou should be aware of the following consider ations before attempting to use the MOV e utility: •[...]

258 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Syntax Utility Name MOV e specifies a move request. P arameters Flsm The ‘‘From’’ LSMid in the format ‘‘ AA:LL ’’ that the cartridges are to be moved from. If you designate the Flsm parameter, you may no t designate the Volume parameter. (lsm-id) LSM identifier [...]

Chapter 4. Util ity Functions 259 1st ed., 6/30/04 - 312579601 (row-list) A one or two digit row numb er or list of row numbers. The maximum list allowed is four rows. However, this para meter cannot contain a list if a list was specified for the Column parameter. Ranges are not valid. Column list of Columns to be moved from. This parameter has a c[...]

260 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 JCL Requirements The following definitions apply to MOV e utility JCL: SLSPRINT output messages from the utility program. SLSIN input to the utility in the form of control cards. In v oking the Mo ve Utility The easiest way to run utilities is to execute the ACS UTIL exec by en[...]

Chapter 4. Util ity Functions 261 1st ed., 6/30/04 - 312579601 JCL Examples The following example sh ows JCL for moving a single volume from a panel to another panel within the same LSM. The example JCL moves a volume from LSM 00:01, Panel 08, Row 05, Column 02 to the same LSM (00:01) to Panel 09. JCL for Mo ving a Single V olume within the Same LS[...]

262 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SLUADMIN (n.n.n) StorageTek Automated Cartridge System Utility PAGE 0001 TIME hh:mm:ss Con trol Card Image Listing DATE yyyy-mm-dd MOVE FLSM(00:04) PANEL(00) TLSM(00:11) SLUADMIN (n.n.n) StorageTek Automated Cartridge System Utility PAGE 0002 TIME hh:mm:ss M ove Volume Utility [...]

Chapter 4. Util ity Functions 263 1st ed., 6/30/04 - 312579601 P erf ormance Log Rebloc ker Utility The Performance Log Reblocker u tility is used by sites sharing an ACS between MVS and VM hosts. The utility is used to reformat the VM performance lo g data to a common format similar to that of the MVS/SMF data. This data is then used as input for [...]

264 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 fmode the CMS filemode of the outp ut file. The default is A2. (APPend specifies that the records from the reader file are appended to the specified CMS file if it exists. In v oking the P erf ormance Log Rebloc ker Utility in CMS The easiest way to run this utility in CMS is t[...]

Chapter 4. Util ity Functions 265 1st ed., 6/30/04 - 312579601 SET PERFLOG ON (CLASS class TO JOB AT mvsnode where: ON enables performance log recording class specifies the virtual spool file class to be used while transferring the spool file JOB specifies to transmit the virtual sp ool file as a job to the MVS system mvsnode specifies the node of [...]

266 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Reconfiguration Utility The Reconfiguration utility is used as part of a four -stage process to create a new copy of the control data set when library hardware co nfigurations change, such as the additi on of drives or LSMs, but when information regardin g the location of cartr[...]

Chapter 4. Util ity Functions 267 1st ed., 6/30/04 - 312579601 Since the LIBGEN macros define the various physical aspects of a library , most changes or modifications af fecting the physical configu ration of the library require t hat corresponding LIBGEN macro(s ) be updated. Any update to the LIBGEN (exce pt changes made via the SET utility) req[...]

268 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 • The old and new contro l data sets must be on volumes that are config ured properly for real reserve/release to all hosts runnin g HSC. (Refer to the IBM documentation for your environment.) • If it is necessary to copy the control data set to another minidisk, use the BA[...]

Chapter 4. Util ity Functions 269 1st ed., 6/30/04 - 312579601 (including all commands used when auto mated mounts or dismounts ar e necessary) need to be issued after the LSMs are br ought online. Note: ALL new control data sets (primary , second ary , and standby) must conform to the library hardware. I/O Considerations Reconfiguration is I/O int[...]

270 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Minimizing I/O Time Any or all of the fol lowing approach es will reduce reconfiguration time: • Using a solid state di sk (SSD) device (such as S torageT ek’ s 4080) • Having no scratch tapes in the old CD S, rather than many scratch tapes Note: Reconfiguration to real D[...]

Chapter 4. Util ity Functions 271 1st ed., 6/30/04 - 312579601 2. Identify any proposed changes to the host system’ s Configuration Plan. It may be necessary to update the RIOGEN (i.e., DMKRIO, HCPRIO) to reflect changes to the hardware addresses. 3. Code the necessary modifications in the LIBGEN macros. Note: Changing or deletin g an ACSid or LS[...]

272 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 13. Perform the following tasks to prepare for reconfiguration: a. Issue the following commands: ACCESS 191 A ACCESS 254 B ACCESS 255 C The 191-disk is MAINTSTK 191, the 254-disk is the RUN-disk, and the 255-disk is STKACS 191. b. Make a backup copy of the ACS SYSPROF by issuin[...]

Chapter 4. Util ity Functions 273 1st ed., 6/30/04 - 312579601 Note: V irtual device addresses may need to be changed in ACS SYSPROF when adding new data set names. e. Copy the updated SYSP ROF to the RUN-disk. COPY ACS SYSPROF A ACS SYSPROF B (REP LACE f. Allocate the new data sets using SLIMDISK. Note: Review all the DASD considerations be fore a[...]

274 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 statements and deleting the DSNs created in step 13d on page 2 60. Do not alter DBPRMNEW or DBSHDNEW . Note: V irtual device addresses may need to be changed in ACS SYSPROF when adding new data set names. o. Issue the following comma nd to create a job to reconfigure the new li[...]

Chapter 4. Util ity Functions 275 1st ed., 6/30/04 - 312579601 16. XEDIT ACS SYSPROF B to remove th e comments from the AUTOJOB statements. Note: Make sure that the AUT OJOB file na me matches the new startup j ob file created earlier . Modify the SLSCNTL, SLSC NTL2, and SLSSTBY data set names to match the new names. 17. Save ACS SYSPROF o n the RU[...]

276 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Restore Utility The REST ore utility provides a way to re-c reate the library control data set from a previous backup copy of the data set. Y ou also have the option to apply all journals (maximum of 99 files per run) since the last backup, if jour naling is enabled. Caution: I[...]

Chapter 4. Util ity Functions 277 1st ed., 6/30/04 - 312579601 The REST ore utility does not reset the journa ls. It is recommended that a backup be performed following the completion of the rest ore to reset the journals and reflect the newly restored control data se t. Special Considerations for Contr ol Data Sets Pr ocessing Independently Specia[...]

278 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Note: If OP T ion(Analyze) was specified for backup, this para meter should be specified for the restore. (Only) specifies that all statements are sent to the SLSAUDIT data set. The CDS and Journal /FILE statements need not be pr esent. The control data sets are not restored. ([...]

Chapter 4. Util ity Functions 279 1st ed., 6/30/04 - 312579601 In v oking the Restore Utility The easiest way to run utilities is to execute the ACS UTIL exec by entering the following command: EXEC ACS UTIL RESTore Execution of the statement results in the ACSUTIL SLKJCL file: A CSUTIL SLKJCL File T o execute the utility: 1. Delete the lines in th[...]

280 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 JCL for REST ore (with Journals Applied) The second example shows JCL for the R EST ore utility using th e GENerate(Only) parameter . JCL for REST ore (with GENerate Only) The third example shows JCL for restoring the library control data set without journals applied and withou[...]

Chapter 4. Util ity Functions 281 1st ed., 6/30/04 - 312579601 JCL for REST ore (Journals and Output to SLSA UDIT) Output Description Output resulting from the execution of the REST ore utility includes: • a restored library control data set. A shadow or secondary data set is also output if specified in the JCL. • a listing of input commands wi[...]

282 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SLUADMIN (n.n.n) Storage Tek Automated Cartridge System Utility PAGE 0001 TIME hh:mm:ss Control Card Image Listing DATE yyyy-mm-dd RESTORE GENERATE(YES) SLUADMIN (n.n.n) Storage Tek Automated Cartridge System Utility PAGE 0002 TIME hh:mm:ss Restore Utility DATE yyyy-mm-dd SLS12[...]

Chapter 4. Util ity Functions 283 1st ed., 6/30/04 - 312579601 How to Handle B A CK up/REST ore Discrepancies Under abnormal circumstances (CDS mismat ch, link down, and so on), the backup operation must be perform ed periodically . Durin g this operation, discrepancy b locks are generated within the SLSBKUP data set. Then , during the restore proc[...]

284 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Scratch Redistrib ution Utility The Scratch Redistribution utility provides y ou with a way to balance the number of scratch volumes across the ACS. It permits th e redistribution of scratch volumes either: • among LSMs implied by the specification of an ACS, or • among the[...]

Chapter 4. Util ity Functions 285 1st ed., 6/30/04 - 312579601 Syntax Utility Name SCREdist specifies that a scratch redistribution is to be performed. SCREdist ACS( acs-id ) LSM( lsm-list , ) SUBpool( subpool-name ) BALtol( tolerance-value ) LONGItud Standard CST MEDIA1 STD 1 3480 ECART E ECCST ETAPE Long MEDIA2 3490E ZCART Z HELical DD3 DD3A DD3B[...]

286 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 P arameters ACS specifies one ACS in the library in which th e scratch volumes are to be redistributed. (acs-id) identifies the ACS. The one or two digit hexadecimal ACS identifier. LSM optionally, specifies that only certain LSM s within an ACS are to contain scratch cartridge[...]

Chapter 4. Util ity Functions 287 1st ed., 6/30/04 - 312579601 The expected number can be determined as follows: where: expnumlsm expected number of scratches for each LSM. totscracs total number of scratches in the ACS. totcellslsm total number of cells in the LSM. totcellsacs total number of cells in the ACS. In the previous example, the 44 10 sh[...]

288 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 LONGItud indicates any Standard, EC ART, or ZCART cartridge. S tandard indicates a standard length, 3480 cartridg e. It can be read on any longitudinal drives (4480, 4490, 9490, or 9490EE). Da ta can be written in 36-track mode on 4490, 9490, or 9 490EE transports but can not b[...]

Chapter 4. Util ity Functions 289 1st ed., 6/30/04 - 312579601 Data capacity differences between DD3A, DD3B, and DD3C cartridges are related to the length of the tape in the cartridge, not to the recording density of the data. STK1 indicates any T9840 cartridge. STK1R indicates a T9840 20GB data cartridge. The media indicator in the external label [...]

290 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 HELical indicates a device using helical recording. DD3 indicates a device using helical recording. STK1R indicates any 9840 or T9 840B transport. STK1R34 indicates any 3490E-image 98 40 or T9840B transport. STK1R35 indicates any 3590-image 98 40 or T9840B transport. STK1RA ind[...]

Chapter 4. Util ity Functions 291 1st ed., 6/30/04 - 312579601 STK2P indicates any T9940A transport. STK2P34 indicates a 3490E-imag e T9940A transport. STK2P35 indicates a 3590-ima ge T9940A transport. STK2P A indicates a T9940A transport. STK2P A34 indicates a 3490E-imag e T9940A transport. STK2P A35 indicates a 3590-ima ge T9940A transport. STK2P[...]

292 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 JCL Requirements The following definitions apply to Scratch Redistribution utility JCL: SLSPRINT output messages from the utility. SLSIN input to the utility in the form of control statement card images. In v oking the Scratch Redistrib ution Utility The easiest way to run util[...]

Chapter 4. Util ity Functions 293 1st ed., 6/30/04 - 312579601 JCL to P erform Scratc h Redistribution The following example shows JCL for redistribu ting 36-track scratch volumes within all LSMs in ACS 00. JCL to P erform Scratc h Redistribution The following example shows JCL for redi stributing helical DD3A (10GB) scratch volumes within LSM 01 i[...]

294 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Output Description Output occurring from execution of the Scratch Redistribution utility includes: • updated library control data set reflectin g the redistribution of scratch volumes • messages detailing actions or attempts to provide an even distribution of scratch volume[...]

Chapter 4. Util ity Functions 295 1st ed., 6/30/04 - 312579601 Scratch Update Utilities Scratch Update utilities prov ide three basic functions: • SCRAtch utility — allows you to scratch a vo lume, a list of volumes, or a range of volumes • UNSCratch utility — allows you to unscra tch a volume, a list of volumes, or a range of volumes. The [...]

296 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 P arameters VO L se r specifies the list of volume serial numbers to be added, deleted, or replac ed in the scratch list(s). (vol-list) vol-list specifies the volume serial numbers ; this can be a single volume, a list of volume serial numbers, ranges of vo lume serial numbers,[...]

Chapter 4. Util ity Functions 297 1st ed., 6/30/04 - 312579601 T o execute the utility: 1. Delete the lines in the t emplate that ar e not required, or leave the comment indicator (*) in column one. 2. Remove th e comm ent indicator from the desired lines. 3. Specify values for the desired param eters. 4. Delete the parameters that are not desired.[...]

298 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SLUADMIN (n.n.n) StorageTe k Automated Cartridge System Utility PAGE 0001 TIME hh:mm:ss Co ntrol Card Image Listing DATE yyyy-mm-dd SCRATCH VOL(102412,102414) SLUADMIN (n.n.n) StorageTe k Automated Cartridge System Utility PAGE 0002 TIME hh:mm:ss Scratch Update DATE yyyy-mm-dd [...]

Chapter 4. Util ity Functions 299 1st ed., 6/30/04 - 312579601 SET Utility The SET utility allows you to ch ange certain library config uration information without performing reconfiguration on the library . Th e utility performs operatio ns directly on the control data set, without requ iring the HSC to be active. In many cases, the SET functio n [...]

300 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 If a host has abended, the active flag is left on. If the host cannot be restarted and ended normally , use the SET HSCLEVEL u tility to reset the active flag. How the SET Utility Functions One of the facilities provided by the SET utility is to change the RESER VE QNAME that w[...]

Chapter 4. Util ity Functions 301 1st ed., 6/30/04 - 312579601 When the HSC is started on any host, it initially serializes on the CDS using the StorageT ek-defined QNAME. This prevents the HSC from being started while the customer-defined QNAME is potentially in the process of being changed. If this is successful (no SET utility in progress), the [...]

302 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 T able 15. SET Utility Options SET Option SET Utility Function and Location of Description ACSDR V “SET ACS Esoteric” on page 304 CLNPRFX “SET Cleaning Prefix” on page 305 COMPRFX “SET HSC Comman d Prefix” on page 305 DELDISP “SET Delete Disposition” on page 307[...]

Chapter 4. Util ity Functions 303 1st ed., 6/30/04 - 312579601 Syntax Note: This syntax is continued o n the next page. SET Options Options: ACSDRV( esoteric ) ,FORACS( acs-id ) ,FORHOST( host-id ) CLNPRFX( prefix ) COMPRFX( cmdhex ) DELDISP( SCRTCH NOSCRTCH ) HOSTID ( newhost ), FORHOST( oldhost ) HSCLEVEL(OFF),FORHOST( host-id ) MAJNAME( qname ) [...]

304 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Syntax (continued) Utility Name SET specifies that the SET func tion is to be invoked. P arameters SET A CS Esoteric ACSDR V specifies that the esoteric for the specified ACS is to be changed. The change does not take effect until the relevant HSC(s) are recycled. Note: The ACS[...]

Chapter 4. Util ity Functions 305 1st ed., 6/30/04 - 312579601 FORACS specifies that the operation is be ing restricted to a specific ACS. (acs-id) specifies the ACSid whose esoteric is being changed. FORHOST specifies that the operation is being restri cted to a specific host. Only the specified hosts’ esoteric is set. If omitted, th e esoterics[...]

306 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Note: Do not assign any characters which could conflict with those in use by CP line edit for any command- authorized virtual machines. T able 16. Mapping of C om m an d Pr efi x C od es to Ch ar a ct er s Hex Character Description 40 n ull blank 4A ¢ cent 4B . period 4C < [...]

Chapter 4. Util ity Functions 307 1st ed., 6/30/04 - 312579601 SET Delete Disposition DELDISP specifies that the delete disposition parame ter is to be set. The delete disposition parameter controls how the HSC interprets the delete disposition on a dismount message. HSCs that were brou ght up before using this fu nction still use the old delete di[...]

308 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 (oldpswd) specifies the 1-to 8-character old ejec t password. Note that oldpswd is not displayed on SLSPRINT. SET Freeze P anel FREEZE specifies to disallow (freeze) or allow (unfre eze) additional cartridges to be stored on| a panel. Notes: Frozen or unfrozen panels ar e recog[...]

Chapter 4. Util ity Functions 309 1st ed., 6/30/04 - 312579601 SET Host ID HOSTID specifies that the old host ID is being changed to a new name. (newhost) specifies a 1- to 4-character host ID which also serves and the SMF system ID. This host ID must also be specified by the LIBSUB SYS parameter in the ACS SYSPROF file. newhost cannot alre ady be [...]

310 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 • Restart the HSC on the host. • Enter the RECover host-id FORCE operator command. SET ENQ/DEQ/RESER VE QNAME MAJNAME specifies that the ENQ/DEQ/RESER VE Q NAME is to be set This parameter requires that the HSC on all systems be shut down before changing the QNAME. (qname) [...]

Chapter 4. Util ity Functions 311 1st ed., 6/30/04 - 312579601 Note: The NNLBDR V parameter has no effect in the operation of the VM/HSC. The utility may still be used to set t his para meter for MVS systems sharing this CDS. (esoteric) specifies a 1-to 8-character esoteric. If the value is omitted, this means that there are no nonlibrary drives in[...]

312 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 (addr0,...addr19) specifies the device numbers for the pane l. The numbers are from the top of the panel down. If a device number is omitte d, this means that the host cannot access a drive in that partic ular position in the panel, or the drive does not exist. Notes: 1. Blanks[...]

Chapter 4. Util ity Functions 313 1st ed., 6/30/04 - 312579601 An example show ing how to define a 9740 10-drive panel c ontaining five 9840 drives i SET SLIDRIVS(,,,,,BD4,BD3,BD2,BD1,BD0),FORLSM ID( lsm ! id ), FORPANEL( panel ) FORLSMID specifies that the operation is be ing restricted to a specific LSM. (lsm-id) specifies the LSMid cont aining t[...]

314 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SET SLIDRIVS Procedure The following procedure shows one method for changing unit addresses with th e HSC active. • For one host : 1. Modify the af fected LSM of fline (M ODify lsm-id OFFline). The LSM will be offline to all hosts. 2. Use SET SL IDRIVS to update the CD S driv[...]

Chapter 4. Util ity Functions 315 1st ed., 6/30/04 - 312579601 ACS and Host ID) not specified here will be deleted and no longer available for use. 2. T o remove stat ion addresses for an ACS or host, do not specify station addresses following the SLIST A TN parameter . For example SET SLISTATN(),FORACS(#1),FORHOST(HSCA) FORACS specifies the ACS fo[...]

316 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 The journals contain a record of all transac tions that update the control data set. There are two journals per host. It is recommended that they are placed on separate HDAs from the primary control data set DASD volume. SHADOW specifies that there is to be two distinct copies [...]

Chapter 4. Util ity Functions 317 1st ed., 6/30/04 - 312579601 SLSCNTL the primary control data set. A prim ary control data set is required. SLSCNTL2 the secondary control data set. This statemen t is used only if you h ave configured and initiated a secondary control data set fo r your installation. A secondary contr ol data set is optional, bu t[...]

318 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 JCL Examples The following example shows basic JCL that i s required for executing the SET utility . Stat ements that represent indivi dual utility functions are includ ed in the JCL, as you deem necessary , to comprise the HSC config uration that you want to invoke. JCL for Se[...]

Chapter 4. Util ity Functions 319 1st ed., 6/30/04 - 312579601 JCL for Mu ltiple SET Statements Note: The last two lines of the JCL example above (SET NNLBDR V ...) are not used by VM, but they are valid for setting an MVS host from a VM host. Output Description Output resulting from the executio n of the SET command includes: • a listing of inpu[...]

320 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Unselect Utility The UNSElect utility allows you to ‘ ‘unselect’ ’ a volume that the HSC leaves in a selected state. Usually , this is an error . The ‘ ‘unselec t’ ’ operation is perform ed without cycling the HSC. Note: Use this utility only if you are certain [...]

Chapter 4. Util ity Functions 321 1st ed., 6/30/04 - 312579601 Utility Name UNSElect specifies that the UNSElect function is to be performed. P arameters VO L se r indicates that a VOLSER is be ing specified for unselection. (volser) volser specifies the VOLSER to be unselected. FORCE optionally indicates that the volume is to be unselected even if[...]

322 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 4. Delete the parameters that are not desired. 5. Enter the command ‘ ‘FILE.’ ’ The job f ile is then submitted to the ACS service machine for execution. JCL Example The following examp le shows JCL for unselecting vo lume BWX1 19. JCL to Unselect a V olume Output Descr[...]

Chapter 4. Util ity Functions 323 1st ed., 6/30/04 - 312579601 SLUADMIN (n.n.n) Stora geTek Automated Cartridge System Utility PAGE 0001 TIME hh:mm:ss Control Card Image Listing DATE yyyy-mm-dd UNSELECT VOL(BWX119) SLS0376I Volume BWX119 is now unsele cted; owning host was HSC1 SLS0155I Condition code for utility function is 0 Figure 20. Unsele ct [...]

324 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 V olume Repor t Utility The function of the V olume Repo rt utility is to produce a lis ting of the physical location for volumes residing in an LSM . This utility is used primar ily for informational purposes and provides history an d usage statistics on specific library volum[...]

Chapter 4. Util ity Functions 325 1st ed., 6/30/04 - 312579601 The volume location information in this report is accurate only up to the time that the volume information is read from the database. For recovery purposes, a listing from a V olume Report run, while the HSC is down on all hosts, must be used to assist locating the required volumes. Not[...]

326 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 If the V AR is not synchronized with the VOLA TTR statements, one of the following actions will resolve the mismatch. • change the VOLA TTR statement(s) • add an external media label to cartridges that are not Standard • mount the cartridges • enter the cartridges throu[...]

Chapter 4. Util ity Functions 327 1st ed., 6/30/04 - 312579601 Syntax Note: This utility can be run ei ther under CMS or SCP . If the utility is running under SCP , architectural limitations restrict the pa rameters that can be specified to ACS , LSM , VO L se r , and VOL u me . Parameters relating to sorting and data filtering are not available. I[...]

328 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Utility Name VO L Rp t specifies that a volume report is to be produced. P arameters ACS optionally specifies that a re port is to be prod uced for only a particular ACS. (acs-id) The one or two digit hexadecimal ACS identifier. LSM optionally specifies that a repo rt is to be [...]

Chapter 4. Util ity Functions 329 1st ed., 6/30/04 - 312579601 SOR T optionally specifies a specified sort sequ ence. The following options are available: VO L indicates that the report is to be sort ed by volume serial number (VOL is the default) LOC indicates that the report is to be sorted by location. USE indicates that the report is to be sort[...]

330 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 INCLude optionally specifies the criteria for including volume information in the report. If this keyword is specified, all volumes that matc h at least one of the specified criteria are tentatively selected for the report. Information abou t vo lumes may be removed from the li[...]

Chapter 4. Util ity Functions 331 1st ed., 6/30/04 - 312579601 MEDEQUAL specifies that volumes for which the media types of the VOLATTR and the VAR are equal match the criteria. NONMEDEQ specifies that volumes for which the media types of the VOLATTR and the VAR are not equal match the criteria. NOEXT ernal NOEXTernal specifies that volumes wi thou[...]

332 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 VO L IS T optionally specifies that the utility produce a volume report. This parameter is used in combination with VOLDATA so that both a flat file and a volume report can be created. Normally, you wou ld not spec ify VOLIST without also designating VOLDATA . If VOLIST , VOLDA[...]

Chapter 4. Util ity Functions 333 1st ed., 6/30/04 - 312579601 The totals are listed on a separate list ing, on a new page from the V olume Report Listing, the Control Card Listing, and t he V olume Report T otals Listing. An example displa ying subpool in formation is show n in Figure 22 o n page 344. If subpools overlap (i.e., a volume belo ngs t[...]

334 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 JCL/P arameter File Syntax Syntax for JCL (SCP) and parameter file (CMS) definitions differs as follows: SLSCNTL For SCP: /FILE SLSCNTL DEV vaddr DSN control. set.name For CMS: SLSCNTL vaddr DSN control.set.name where: vaddr virtual address of the disk containing the CDS. For S[...]

Chapter 4. Util ity Functions 335 1st ed., 6/30/04 - 312579601 Note: The ‘ ‘|’ ’ symbol indicates that the user must choose either PRINTER or DISK. where: C SYSOUT class for the printed report. PRINTER report is sent to the virtual printe r of t he userid executing the utility. DISK report is sent to disk. fn, ft, fm file name, file type, a[...]

336 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SLSV A (CMS only) SLSVA fn ft fm where: fn, ft, fm file name, file type, and file mode containing the VOLATTR statements. P ARM Parameters to pass to the SLUADMIN program. For SCP: /PARM parameters For CMS: PARM parameters where: parameters any parameters acceptable to the SLUA[...]

Chapter 4. Util ity Functions 337 1st ed., 6/30/04 - 312579601 In v oking the V olume Repor t Utility Depending upon the environment in which it is being run, the V olume Report utility can be invoked in one of two ways: • SLUVOLR EXEC (CMS) • ACSUTIL SLKJCL file (SCP). SLUV OLR EXEC (CMS) The user can invoke the utility unde r CMS by running t[...]

338 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 T o execute the utility: 1. Delete the lines in the t e mplate that are not required, or leave the comment indicator (*) in column one. 2. Remove the comment indi cator from the desired lines. 3. Specify values for the desired param eters. 4. Delete the parameters that are not [...]

Chapter 4. Util ity Functions 339 1st ed., 6/30/04 - 312579601 JCL to Pr oduce a V olume Report for an MVS PDS The following example sh ows JCL to pr oduce a V olume Re port for ACS 01. Output Description A report in the specified sort order provid es details about the l ibrary volumes in the ACSs/LSMs for which the report is produc ed. Other outpu[...]

340 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Media T ype Prefix Characters If discrepancies exist between the media type reported by the LMU (in the V AR) and the VOLA TTR information, the medi a type is prefixed by on e of the following characters: * displayed if the VAR media type and VOLA TTR information do not match. [...]

Chapter 4. Util ity Functions 341 1st ed., 6/30/04 - 312579601 Subpool ID Field Scratch subpools for volumes are listed if: • SUMMary(SUBpool) is specified and • scratch subpool definitions have been provided by SCRPOol control statements. If the VOLSER is not within any scratch subpool range, ** DEF AUL T * * appears in this field. Times Selec[...]

342 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 V olume Report Flat Files Specifying the VO L DA T A parameter produces a volume flat file. The layout of the volume records is defined by the SMP/E- distributed SLUVVDA T macro. Refer to Appendix C, “Record Formats” on page 49 7 to see the SLUVVDA T record format. When VOL[...]

Chapter 4. Util ity Functions 343 1st ed., 6/30/04 - 312579601 SLUADMIN (n.n.n) StorageTek Automated Cartridge System Utility PAGE 0001 TIME hh:mm:ss Cont rol Card Image Listing DATE yyyy-mm-dd VOLRPT SUMMARY(TOTAL) VOLUME(CLN400-CLN418) SLUADMIN (n.n.n) StorageTek Automated Cartridge System Utility PAGE 0002 TIME hh:mm:ss Vol ume Report Utility DA[...]

344 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SLUADMIN (n.n.n) StorageT ek Automated Cartridge System Utility PAGE 0001 TIME hh:mm:ss C ontrol Card Image Listing DATE yyyy-mm-dd VOLRPT SUMMARY(SUB) VOLUME(EE0000-EE9999) SLUADMIN (n.n.n) StorageT ek Automated Cartridge System Utility PAGE 0002 TIME hh:mm:ss Volume Report Ut[...]

Chapter 4. Util ity Functions 345 1st ed., 6/30/04 - 312579601 SLUADMIN (n.n.n) StorageT ek Automated Cartridge System Utility PAGE 0003 TIME hh:mm:ss Subpool Totals, All Ranges ATE yyyy-mm-dd SUBPOO L ID LABEL TYPE RANGE LIMITS SUB 1 SL N/A - N/A NON ACS LSM SCRATCH SCRATCH Media Rectech 00 00:00 0 0 _______ _______ ACS Tot al 0 0 01 00:10 5 1 ZCA[...]

346 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601[...]

Chapter 5. Problem Determination, Diagnost ics, and Re covery 347 1st ed., 6/30/04 - 312579601 Chapter 5. Pr ob lem Determination, Diagnostics, and Reco very Overview The following indicators and faci lities may be used in the dete rmination of the source of a perceived problem. • Messages • ABEND codes • Software trace facilities • Diagnos[...]

348 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Software T race Fa cilities There is a hierarchy of facilities that ma y be used to trace the activity of the ACS servi ce machine. They range from stan dard VM services, to S CP a nd HSC services. Utilities are also provided. The SCP and the HSC have separa te trace facilities[...]

Chapter 5. Problem Determination, Diagnost ics, and Re covery 349 1st ed., 6/30/04 - 312579601 VM (CP) Debug Commands The following CP commands are us eful in diagnosing problems in the system. See appropriate VM do cumentation for details on syntax and use. SCP SET TRA CE Command The SET TRACE command allows the operator to enable and disable the [...]

350 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Master T race T able Header A data area, called the Master Trace T able Header (MTTH) is a 32-byte header which describes the actual trace table . The address of the MTTH is in the 4-byte area at absolute address x’54’ (label TRCT AB in structure NUCON). The MTTH actually r[...]

Chapter 5. Problem Determination, Diagnost ics, and Re covery 351 1st ed., 6/30/04 - 312579601 DSP T race Entry event-type = ‘D’ event-code TTEWORD1 TTEWORD2 TTEWORD3 = dispatch priority = R15 = R12 = R13 Return from SVC T race Entry event-type event-code TTEWORD1 TTEWORD2 TTEWORD3 = ‘W’ = dispatch priority = R15 = R0 = R1 SIO T race Entry [...]

352 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 RST T race Entry event-type event-code TTEWORD1 TTEWORD2 TTEWORD3 = ‘R’ = (unused) = (unused) = (unused) = (unused) EXT T race Entry event-type event-code x’0040’ x’1004’ x’1005’ x’2402’ x’4000’ = ‘E’ = external interrupt code: = ‘CP EXT’ (generi[...]

Chapter 5. Problem Determination, Diagnost ics, and Re covery 353 1st ed., 6/30/04 - 312579601 TTEWORD1 = IRT address TTEWORD2 = IPARML (bytes 0-3) TTEWORD3 = IPARML (bytes 4-7) IP ARML (IUCV P arameter List) The IP ARML (IUCV Parameter List) is a VM data structure that contains IUCV information passed to and from the user of IUCV services. At the [...]

354 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 The IP ARML fields are defined by VM. Ex amples of some comm on op erations are: IUCV CONNECT to *BLOCKIO IUCV SEND to *BLOCKIO IUCV RECEIVE IUCV REPLY IUCV SEVER IP ARML for IUCV CONNECT to *BLOCKIO *----------------------------- -----------------------------* x’00’ | Path[...]

Chapter 5. Problem Determination, Diagnost ics, and Re covery 355 1st ed., 6/30/04 - 312579601 IP ARML for IUCV SEND to *BLOCKIO *----------------------------- -----------------------------* x’00’ | Path ID |flags 1|IPRCODE | IPMSGID = message id | *------+------+-------+------- +--------+-----+------+------+ x’08’ | IPTRGCLS = target class[...]

356 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 IP ARML for IUCV RECEIVE *----------------------------- -----------------------------* x’00’ | Path ID |flags 1|IPRCODE | IPMSGID = message id | *------+------+-------+------- +--------+-----+------+------+ x’08’ | IPTRGCLS = target class | IPBFADR1 = buffer address | *[...]

Chapter 5. Problem Determination, Diagnost ics, and Re covery 357 1st ed., 6/30/04 - 312579601 IP ARML for IUCV REPL Y *----------------------------- -----------------------------* x’00’ | Path ID |flags 1|IPRCODE | IPMSGID= message id | *------+------+-------+------- +--------+-----+------+------+ x’08’ | IPTRGCLS = target class | xx | xx [...]

358 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 IP ARML for IUCV SEVER *----------------------------- -----------------------------* x’00’ | Path ID | xx |IPRCODE | xx | xx | xx | xx | *------+------+-------+------- +--------+-----+-----+--- ---+ x’08’ | IPVMID= userid connected to | *------+------+-------+------- +-[...]

Chapter 5. Problem Determination, Diagnost ics, and Re covery 359 1st ed., 6/30/04 - 312579601 IPRCODE The following is a list of IPRCODE va lues and meanings from DMKSP MACLIB member IUCVBLOK for VM/SP , VM/SP HPO and VM/ESA 370. For VM/XA and VM/ESA, the codes are defined in CPLIB MACLIB member IP ARML. The codes are also documented in the IBM VM[...]

360 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 IUCV Interrupt Buffer As an IUCV-type external interrupt occurs, CP places data in the IU CV external interrupt buffer . The data describes the type of IUCV ev ent, and data specific to each event subtype. For a full description, see the appropriate VM documentat ion. The exter[...]

Chapter 5. Problem Determination, Diagnost ics, and Re covery 361 1st ed., 6/30/04 - 312579601 IP ARML fo r P ending Connection Interrupt *----------------------------- -----------------------------* x’00’ | IPPATHID | Flag 1| 01 | IPMSGLIM | xx | xx | *------+------+-------+------- +--------+-----+-----+--- ---+ x’08’ | IPVMID= userid wish[...]

362 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 IP ARML for Conn ection Complete Interrupt *----------------------------- -----------------------------* x’00’ | IPPATHID | Flag 1| 02 | IPMSGLIM | xx | xx | *------+------+-------+------- +------+-------+-----+--- ---+ x’08’ | xx + xx + xx + xx + xx + xx + xx + xx | *-[...]

Chapter 5. Problem Determination, Diagnost ics, and Re covery 363 1st ed., 6/30/04 - 312579601 IP ARML fo r P ath Severed/REsumed/Quiesce d Interrupt *----------------------------- -----------------------------* x’00’ | IPPATHID | xx | IPTYPE | xx | xx | xx | xx | *------+------+-------+------- +------+------+--- --+--- ---+ x’08’ | xx | xx[...]

364 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 IP ARML for In coming Message Interrupt *----------------------------- -----------------------------* x’00’ | IPPATHID | Flag 1| 08/09 | IPMSGID= message id | *------+------+-------+------- +------+------+--- --+--- ---+ x’08’ | IPTRBCLS= target class | xx | xx | xx | x[...]

Chapter 5. Problem Determination, Diagnost ics, and Re covery 365 1st ed., 6/30/04 - 312579601 IP ARML fo r Message Complete Interrupt *----------------------------- -----------------------------* x’00’ | IPPATHID | Flag 1| 06/07 | IPMSGID= message id | *------+------+-------+------- +------+------+--- --+--- ---+ x’08’ | IPAUDIT | | xx | x[...]

366 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Diagnostic Capabilities This section describes the overa ll diagnostic capabilities supported by all components of the HSC. Diagnostic capabilities include: • SCP T race Facility . This facility provides a hist ory of the processing before a failure. • Supervisor Call (SVC)[...]

Chapter 5. Problem Determination, Diagnost ics, and Re covery 367 1st ed., 6/30/04 - 312579601 SCP External T race Facility The SCP can trace interrupt, IUCV , I/O, disp atch, and G TRACE events as they occur and send the trace records to a designated virtual machine for later analysis. The target may be any virtual machine in an RSCS network. The [...]

368 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SCP T race Form atter Utility EXEC optionally specified to invoke the EXEC. SLUETRAC initiates the SLUETRAC EXEC. EXEC spoolid events ( IN= OUT= infile outfile ALL DSP EXT I/O IUC MCK PGM RST SIO SVC USR ACS infn TRACE inft A infm ACSTRACE outfn LISTING outft A1 outfm * outfile[...]

Chapter 5. Problem Determination, Diagnost ics, and Re covery 369 1st ed., 6/30/04 - 312579601 spoolid indicates the VM spool id of the reader spoo l file containing the trace data. If neither spoolid nor IN= is specified, the first non- held reader spool file of type P UN is processed. Note: IN= overrides specification of a reader spool file. even[...]

370 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Supervisor Call (SVC) Functions The SCP partially supports the following SVC functions. They are included here for use when reading trace output. Documentation of the actual subfunctions supported is for StorageT ek internal purposes only .[...]

Chapter 5. Problem Determination, Diagnost ics, and Re covery 371 1st ed., 6/30/04 - 312579601 T able 20. SVC Func tio ns Refer to T able Note Hex Decimal Function (1) (2) (2) (2) (2) (1) (1) (2) 00 01 02 03 04 06 08 09 0A 0B 0C 0D 0F 10 13 14 18 1B 21 22 23 24 28 29 2A 2B 2C 2E 2F 30 33 37 38 3C 3E 40 4C 53 57 63 6B 77 78 7A 7F 0 1 2 3 4 6 8 9 10 [...]

372 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SCP GTRA CE Em ulation The SCP emulates the following MVS G TRACE features: 1. The MVS G TRACE macro is supported, without alteration. 2. A Monitor Call (MC) program interrupt occurs when the G TRACE function is invoked. The SCP program check handler recognizes and handles the [...]

Chapter 5. Problem Determination, Diagnost ics, and Re covery 373 1st ed., 6/30/04 - 312579601 The valid EID ranges are : 0 <= user EID <= x’3FF’ x’400’ <= system EID <= x’FFF’ The actual EID used by the SCP is x’400’, for all FIDs. The actual EID used by the HSC is passed to the HSC initialization routine (SLSBINIT), an[...]

374 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 HSC Internal T race T able The HSC itself has an internal trace table. It is pointed to by the co ntents of the 4-byte field at offset x’40’ from the start of the L VT (L VTTBLK). It is a wrap-around table, recording the last 256 events that occurred in the HSC subsystem. T[...]

Chapter 5. Problem Determination, Diagnost ics, and Re covery 375 1st ed., 6/30/04 - 312579601 00B613F0. C2E3D9C3 00006C10 F130 0000 00000000 | BTRC..%.1....... | 00B61400. 6550D3D9 E2D740BC 00DA 0000 009DB6B8 | .&LRSP ......... | 00B61410. 00000000 4DF1F8F6 F0F1 F1F5 F7F2D2F1 | ....(186011572K1 | 00B61420. F1F1F8F1 F1F0F0F3 4040 4040 4040F340 [...]

376 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 HSC TRA CE Command The HSC TRace command enables or disables tracing of events in selected HSC components. It uses G TRACE to perform the actual traci ng. The SCP TRACE command must have the “USR” event e nabled for any t race output to resu lt. For a detailed description o[...]

Chapter 5. Problem Determination, Diagnost ics, and Re covery 377 1st ed., 6/30/04 - 312579601 Diagnostic Commands VM (CP) Commands The CP commands liste d in “VM (CP) Deb ug Commands” on page 349 are very useful in diagnosing a problem. For maximum effectiven ess, they should be used in conjunction with the SCP’ s diagnostic subsystem comman[...]

378 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 If the name is known, it will be located in storage. It will be brought into storage if it was not there before. If epname is not specified, the cu rrent traces are displayed. offset the optional offset from the address of epname at which to set a breakpoint usin g CP PER. The [...]

Chapter 5. Problem Determination, Diagnost ics, and Re covery 379 1st ed., 6/30/04 - 312579601 SCP Diagnostic Subsystem Commands These commands are provided for use when di agnosing a problem with a ‘ ‘live’ ’ system. Any other use may result in indeterminate conditions. Note: It is recommended that S torageT ek suppo rt personnel be contac[...]

380 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 =NODEBUG This diagnostic command terminates the special ‘ ‘debug’ ’ mode. ‘CP SET RUN ON’ is also executed. = the command character for the DIAG subsystem. The default is ‘‘=’’, but may be set to any character by the SUBSYS command that started the subsystem[...]

Chapter 5. Problem Determination, Diagnost ics, and Re covery 381 1st ed., 6/30/04 - 312579601 =HPER This diagnostic command sets one or more break-poi nts for a list of named modu les and offsets. The CP QUER Y PER command is then issued to display the current program traps in effect. Note: In the VM/XA environment, CP P ER and QUER Y PER are syno[...]

382 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Results in CP QUERY PER output. The following output is for VM/SP, VM/SP HPO, and VM/ESA 370. 1 INSTRUCT RANGE addr TERMINAL NORUN CMD * FUNC=SLSBINIT OFFSET=000000 2 INSTRUCT RANGE addr ! addr TERMINAL NORUN CMD * FUNC=SLKODE OF FSET=000054 The following output is for VM/XA an[...]

Chapter 5. Problem Determination, Diagnost ics, and Re covery 383 1st ed., 6/30/04 - 312579601 Examples: Issuing the command: =WHERE SLSBINIT 23FDF0 Results in the messages: SLKOWH671I Module SLSBINIT at addres s 23FD50 compiled 09/20/88 14.20 SLKOWH674I Address 23FDF0 = EP : S LSBINIT +0000A0 SLKOWH674I Address 23FDF0 = CSECT: S LSBINIT +0000A0 HS[...]

384 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 address specifies a hexadecimal address of memory. size specifies the amount of memo ry (in decimal) to display. The default size is 16. DISPLA Y Command The HSC Display command of fers several options that are useful for diagno stic purposes. For more information on the Displa[...]

Chapter 5. Problem Determination, Diagnost ics, and Re covery 385 1st ed., 6/30/04 - 312579601 CDS Reco very Capabilities Capabilities to recover the CDS from certain ha rdware and software failures are inherent in the HSC. CDS recovery capabilities include: • dynamic recovery of th e control data set • control data set error diagnostics • in[...]

386 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 When access to a failing data set is restor ed, you must run the BACKup and REST ore utilities to restore the integrity of the failed data set. An alternative method is to use the CDs command, specifying the En able parameter to ap pend th e data set again to the end of the Act[...]

Chapter 5. Problem Determination, Diagnost ics, and Re covery 387 1st ed., 6/30/04 - 312579601 Figure 24 illustrates the built-in reco very scheme for the control data sets. CONTROL DA T A SET 1 CONTROL DA T A SET 2 PRIMARY CONTROL DA T A SET SECONDARY CONTROL DA T A SET ST ANDBY CONTROL DA T A SET CONTROL DA T A SET 3 DA T A SET 1 DA T A SET 2 CON[...]

388 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 All HSCs in operation must be stopped to perform the restore operation . If the three control data sets fail, the journal(s) can be used to restore a valid control data set. Refer to “Backup Utility” on page 211 for detailed information about running the BACKup utility . Re[...]

Chapter 5. Problem Determination, Diagnost ics, and Re covery 389 1st ed., 6/30/04 - 312579601 Switching to a Bac kup Copy of th e Control Da ta Set If you have initialized your HSC subsystem with the additio nal backup copies of the control data set, you can dynamically switch operation to any one of the copies without affecting the HSC and librar[...]

390 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Recommended Reco very Actions Once you are aware that a switch of the control data set has occurred, it is recommended that the following actions be taken: 1. Run the BACKup utility . 2. Retain a backup copy of each cont rol data set for diagnostic purposes. 3. Run the REST ore[...]

Chapter 5. Problem Determination, Diagnost ics, and Re covery 391 1st ed., 6/30/04 - 312579601 Dump Pr ocessing The following dump processing topics are discussed below: • T ype of dumps supported • How to request a dump • What to do when a dump occurs • Dump analysis usin g SLUIPCS • Major SCP data relationships • Diagnostic techniques[...]

392 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 What to do When a Dump Occurs When a VM HSC dump occurs, it is sent as a CLASS V spool file to the virtual machine defined by the current DUMPOP TS setting. Du mp files are large and can have a negative impact on system spool space; they should be processed as soon as possible [...]

Chapter 5. Problem Determination, Diagnost ics, and Re covery 393 1st ed., 6/30/04 - 312579601 Load Dump and CONSLOG Onto Disk Load the dump spool file onto MAINTSTK’ s IPCS disk. Ensure that MAINT’ s 193 disk is ACCESSed. MAINTSTK normally has a LINK to this disk in its directory entry . T o access the disk, issue th e following command from M[...]

394 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Below is an example of the VMFPLC2 comman ds normally used to copy the problem materials onto a tape mounted at virtu al address 181: VMFPLC2 DUMP PRBnnnnn * * VMFPLC2 DUMP SMS2000 VMFSVLOG * VMFPLC2 WTM 2 Dump Analysis Using SLUIPCS Normally , dump analysis is performed by a S[...]

Chapter 5. Problem Determination, Diagnost ics, and Re covery 395 1st ed., 6/30/04 - 312579601 T o terminate the SCAN environm ent, use the END subcommand. T o format and print data areas and contro l blocks, issue the SLUIPCS PRINT command. The user is prompted for StorageT ek-defined print options. SLUIPCS SCAN Subcommands These S torageT ek-supp[...]

396 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 T able 25. VIEW -able SCP Data Structures Data S tructur es A TTP ARM *CCVT CDE CHANCELL CIB CMDPLIST CPIB CSWORD CUCELL *CVT DAB DECB DEVBLOK ECB ERREC EXDA T EXTDESC FREANC GRF A IEZCOM IHADCB IOBLOK IQE IR T IUB JBLOK JFCB JW A MCBLOK MSGEL *MTT NEWTQE *NUCON ORIGID PSWORD Q[...]

Chapter 5. Problem Determination, Diagnost ics, and Re covery 397 1st ed., 6/30/04 - 312579601 IHAASCB IHAPSA IKJTCB ILL T ITCA JCVT JPIAL JPIB JPMESG LASP LBM LBR LCB LCCD LCCW LCF LCS LCT LCVT LDBK LDW LEPL LHB LHQ LHRQ LIQE LITC LLG1 LLG2 LLG3 LLG4 LLSB LMDT LME LPVL LPVS LQC LRPL LRSE LRSP LR T LSB LSL LSLM LSR LSSE LST LSTB LSWT L T AB LT C B [...]

398 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 FIND FIND is identical to the VIEW command, exce pt that only the address of the found structure is displayed. It is useful when fo llowing pointer chains to a structure. It is especially useful when analyz ing a dum p over a slow communications l ine. EX (EXECUTE CMS COMMAND) [...]

Chapter 5. Problem Determination, Diagnost ics, and Re covery 399 1st ed., 6/30/04 - 312579601 ST A T (ST A TUS) The ST A T su bcommand d isplays s tatus of th e system at the time of the problem that caused the dump: • general and control registers • the PSW • TOD clock • TOD clock comparator • dump id STAT TA S K ( F I N D TA S K ) This[...]

400 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SLUIPCS PRINT Options The options listed in the following tabl e are supported for SLK-type dumps. Major SCP Data Relationships The following data structures are referenced below: NUCON Nucleus constants = PSA = low storage CVT Communications V ector T able CCVT Communications [...]

Chapter 5. Problem Determination, Diagnost ics, and Re covery 401 1st ed., 6/30/04 - 312579601 Command, Message, T race Processing NUCON CVT CCVT MSGEL CMDPLIST INTERNAL TRACE T ABLE CURRENT TTE CCVWTOQ CCVCMDQ COMANC MTT MTTCURR MTTFIRST MTTLAST X’10’: VECTPTR TRCT AB X’A60’: INTERRUPT DA T A SA VE AREA C29330 Figure 25. Command, Message a[...]

402 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SCP T ask/Job Data Relationships Refer to Figure 26 on page 403 for a descrip tion of these relationships. Subsystem Data Relationships Refer to Figure 27 on page 404 for a descrip tion of these relationships. Diagnostic T e chniques The user must be logg ed on the ACS virtu al[...]

Chapter 5. Problem Determination, Diagnost ics, and Re covery 403 1st ed., 6/30/04 - 312579601 NUCON PSAAOLD PSA TO LD JBLOK JBL T ASK TBLOK TKRBLIST RQBLOK C29331 Figure 26. SCP T ask/Job Data Relationship[...]

404 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 NUCON VECTPTR CVT CVTJESCT JESCT JESSSCT SSCT SSCTSCT A SSCTSSVT SSCT SSCTSCT A SSCTSSVT SSCTSUSE SSVT SSVT LV T C29332 Figure 27. Subsystem Data Re lationships[...]

Chapter 5. Problem Determination, Diagnost ics, and Re covery 405 1st ed., 6/30/04 - 312579601 2. Enter: D PSW 3. PSW is BC mode if Bit 12 is 0 (high bit in the fo urth nibble). If PSW is BC mode, then enter: VMDUMP 0.END FORMAT CMS * comments else enter: VMDUMP 0.END FORMAT SLK 0 comments b. Enabled W aits: These are difficult at best. Whatever fa[...]

406 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 (or) VIEW NUCON • If ABEND was the result of an ‘ABEND’ SVC: - NUCICODE = x’000D’ - NUCIGR1 = ABEN D code (system and user) - NUCIGRF = optional ABEND reason code • If ABEND was the result of a ‘CALLR TM’: - NUCICODE = (not) x’000D’ - R TM1FLG1 = has bit x?[...]

Chapter 5. Problem Determination, Diagnost ics, and Re covery 407 1st ed., 6/30/04 - 312579601 Save Area T race Bac k Find an R13 value (f or example, R QGPR13, NUCIGRD, etc.) TRB address Find the L VT VIEW L VT (or) Find L VT (or) Register 1 1 usually contains the L VT addr ess for HSC modules (for example, SLS* or SLU*). Find the LCT , LST , HST [...]

408 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Examine an SD W A Find the failing TBLOK (see instructions above) VIEW RTM2WA TKRTM2WA Display xx (xx = address in RT2RSDWA) Find IUCV P ath Descriptor s VIEW CVT VIEW IR T IR T ANC repeat VIEW IR T IR TLNK until end-of-queue Find IUCV Interrupt Bl ocks Find an IR T VIEW XINT I[...]

Chapter 5. Problem Determination, Diagnost ics, and Re covery 409 1st ed., 6/30/04 - 312579601 - details of problem circ umstances • STKACS abend - VMDUMP (process with SLUIPCS), CONSLOG , VMFSVLOG (refer to ‘ ‘Dump Processing’ ’ on page 5-35) • problems relating to HSC utilities - utility SLKJCL - utility output (SLSPRINT) - dump data [...]

410 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 T ape Format Software Support prefers that diagnost ic data be sent in machine-readable format on tape in the following format: • VMFPLC2 format • for VM dump processing, refer to “Dump Processing” on page 391 • if possible, DO NOT use SP T A PE format. Ta p e R e t u[...]

Chapter 6. Performan ce Considerations 411 1st ed., 6/30/04 - 312579601 Chapter 6. P erformance Considerations Overview After installing your Automated Cartridge System you wil l no tice an improvement in your site system performance, especially for jobs and programs wh ere tape cartridge handling is involved. W ithout any tuning, the ACS s hould s[...]

412 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 How Systems Pr ogrammers C ontr ol Library P erf ormance Systems programmers command extensive cont rol of overall library performance. This control of performance is inherent with how a systems programmer: • initially configures the library (during the LIBGEN process) • us[...]

Chapter 6. Performan ce Considerations 413 1st ed., 6/30/04 - 312579601 This utility provides the library administrato r with the information necessary to balance mount/dismount activity across ACSs and LSMs within a library . The information is based on statistics contained in SMF records that are tallied for each cartridge movement. T otal Mount [...]

414 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Redistrib ute Scratch V olumes in the Library The Scratch Redistribution utility allows you to redistribute scratch volumes across the LSMs within a particular ACS. Y ou ca n choose to have the scratch volumes go to only specified LSMs or all LSMs within an ACS. Redistribution [...]

Chapter 6. Performan ce Considerations 415 1st ed., 6/30/04 - 312579601 If ejects and/or enters of lar ge numbers of cartridges are frequent, you may want to set higher CAP preferences for enhanced CAPs. Refer to the HSC Operator ’ s Guide for information about the CAPPref command. Use SMF Recor ds to Coll ect P erf ormance Data Library performan[...]

416 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Refer to “P ARMLIB Control Statements” on pa ge 83 for detailed in formation ab out using P ARMLIB control statements. Journal Definition JRNDEF Journal (specify FULL=Abend or FULL=Continue) Journals JRNDEF Jo urnal (specify FULL=Abend or FULL=Continue) Mount Processing MNT[...]

Chapter 6. Performan ce Considerations 417 1st ed., 6/30/04 - 312579601 Define High Dispatc hin g Priority f or the HSC The VM dispatch priority and SHARE settings of the ACS service machine may be altered to improve overall HSC performance for a VM host system. Set High-P erf ormance Host -to-Host Comm unications In a multi-host ACS configuration,[...]

418 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Functioning of Host-to-Host Communications The method hierarchy that is established is, from highest to lowest, VT AM, LMU, CDS. Initially , all methods are set to CDS. Appropr iate entries can be placed in the P ARMLIB statement to set the communications meth od at HSC initial[...]

Chapter 6. Performan ce Considerations 419 1st ed., 6/30/04 - 312579601 Define Secondar y and Standby Contr ol Data Sets V arious controls and services are in place in th e HSC subsystem to ensure that the primary control data set maintains its integrity . Includ ed among the controls are the capability to: • designate secondary and standb y cont[...]

420 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Excessive Use of VIew Co mmand Aff ects P erf ormance Each time the VIew command is invoked, the automatic functioning occurring within an LSM is interrupted. During th e interruption, the robot hand s and associated cameras are stopped from performing HSC dire cted library fun[...]

Chapter 6. Performan ce Considerations 421 1st ed., 6/30/04 - 312579601 • W ith the use of SMF logging, accurate records can be accumulated for system analysis or to monitor system status.[...]

422 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Loading Car t ridg es Into the Librar y There are different methods that can be used to load an LSM with c artridges at installation time. There are advantages and disadvantage s involved for each me thod. The following brief discussions may help you determine wh ich loading me[...]

Chapter 6. Performan ce Considerations 423 1st ed., 6/30/04 - 312579601 Unav oidab le P ass-Thrus The HSC attempts to minimize the number of pass-thrus required; however , depend ing upon available tape tra nsports and location s of cartridges, pass-thrus ofte n cannot be avoided. By running Activities Reports on a regular basis and examining the r[...]

424 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Ensure adequate fr ee cells Setting MNTD Float to ON can be defeated if there are no free cells in the dismounting LSM. Dismounted cartridges are passed to o ther LSMs to find a new home cell. Use the Display Lsm command to determine the number of free cells in each LSM. Use MO[...]

Chapter 6. Performan ce Considerations 425 1st ed., 6/30/04 - 312579601 Prefetch Enters Nonlibrary cartridges that are mounted on library transports are delayed while t he operator fetches and enters them. This is a common occurrence for HSC sites with all transports attached to the library. If you or your scheduling system can pred ict which nonli[...]

426 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 DET AC Hed from a virtual machine. This enab les the volume to be available (that is, unselected) earlier than woul d otherwise be possible. ACSPROP EXEC can also be used with VMOPERA TOR to trap MOUNT messages for VMT APE. LOG T ABLE SAMPLE contains sample VMOPERA TOR LOG T AB[...]

Chapter 6. Performan ce Considerations 427 1st ed., 6/30/04 - 312579601 Scheduling Nonpr oductive Activities During Low-Demand T imes There are several library utilities, which, t hough very essential, severely impact the library’s ability to mount and dismount cartridges. The following utilities should not be run when high -priority production j[...]

428 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Use LSMs as Scratch Lo ader s in a Mix ed A CS In an environment wh ere massive cartridge input is required or a lot of cartridge movement occurs, 9360 (W olfCreek) or 9310 (PowderHorn) LSMs can be used to simulate scratch loaders intermixed with 4410 LSMs to improve library pe[...]

Appendix A. Macros, Control Statements, Ut ilities, and Commands Syntax Reference 429 1st ed., 6/30/04 - 312579601 Appendix A. Macr os, Contr o l Statements, Utilities, and Commands Syntax Reference Syntax Flo w Diagrams Syntax is illustrated using flow diagrams. These can include the following elements: • syntax – the diagram itself. • items[...]

430 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Flow Lines Syntax diagrams consist o f horizontal and vertical l ines and the text of a command, control statement, macro, or utility . or Diagrams are read left to ri ght and top to bottom. Arrows indicate flow and direction. • a statement begins with • a statement ends wi[...]

Appendix A. Macros, Control Statements, Ut ilities, and Commands Syntax Reference 431 1st ed., 6/30/04 - 312579601 Single Optional Choice If the first item is on the line below the base lin e, a single choice of items in the stack is optional. Defaults Default value s and parameters a ppear above the syntax diagram lin e. In the following example, [...]

432 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Syntax Continuation (Fragments) Fragment references direct you to parts (fragm ents) of the syntax that contain more detail than can be shown in th e main syntax diagram. COMMAND/UTILITY NAME Fragment Reference Item1( Fragm ent: variable2 , variable1 variable4 variable3 ) Item2[...]

Appendix A. Macros, Control Statements, Ut ilities, and Commands Syntax Reference 433 1st ed., 6/30/04 - 312579601 Library Identification Each ACS, LSM, and CAP is assigned a unique identification number during LIBGEN. Use this number in HSC commands and u tilities when identifying a specific ACSid, LSMid, or CAPid. •A C S i d ( acs-id ) is a hex[...]

434 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 How to Specify a CAPid A CAPid specifies a particular CAP in the libra ry . Each CAP is identified by the LSMid of the LSM that the CAP is attached to and a CA P number to distinguish it from other CAPs in that LSM. CAP configurations differ based on the LSM type. The following[...]

Appendix A. Macros, Control Statements, Ut ilities, and Commands Syntax Reference 435 1st ed., 6/30/04 - 312579601 •T h e AA:LL : CC format can be specified for any CAP hardware in any command that accepts a CAPid. This is the preferred format. V alid CAP numbers are: 00 indicates one of the following: - a 21-cell standard CAP - the right-hand 40[...]

436 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Ranges And Lists HSC commands and utilities often allow the user to specify ranges a nd lists of elements. 1. An inclusive range is indicated by a pair of elements of the same length and data type, joined by a dash. The first element must be strictly less than the second elemen[...]

Appendix A. Macros, Control Statements, Ut ilities, and Commands Syntax Reference 437 1st ed., 6/30/04 - 312579601 - Y ou cannot increment two portions of a range element. If 11 1 AAA is the first element, you cannot specify 1 12 AAB for the second element. - The alphabetic portion of the VOLSER range is defined as b eing from character A to Z. T o[...]

438 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 2. A list consists of one or more elements. If more than one element is specified, the elements must be separated by a comma or a blan k, and the entire list enclosed in parentheses. • For some HSC operator commands, an element may consist of a single item or a range. Refer t[...]

Appendix A. Macros, Control Statements, Ut ilities, and Commands Syntax Reference 439 1st ed., 6/30/04 - 312579601 Contro l Statement Syntax Co n ventions The control statement for each utility program consists of a command (indicating the utility function) followed by parameters, as applicable, in 80-character card-image records. The standard synt[...]

440 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 The following examples illustrate continuations u sed correctly: SCRPOOL NAME=STD36,RANGE+ (AAA000 ! AAA999,ZZZ000 ! ZZZ999) SCRPOOL NAME=STD36,RANGE(AAA000 ! AAA999, - ZZZ000 ! ZZZ999) The following example illustra tes a continuation used incorr ectly : SCRPOOL NAME=STD36,RAN[...]

Appendix A. Macros, Control Statements, Ut ilities, and Commands Syntax Reference 441 1st ed., 6/30/04 - 312579601 MEDia, RECtech, and MODel P arameter s T able 29 describes the HSC commands and control stateme nts that accept MEDia, MODel, and RECtech parameters. T able 29. MEDia, RECtech, and MODel Cross-ref erence Name T ype Related Parameters M[...]

442 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Mount Command SUBpool, SCR TCH, PRIV A T Y es No No Mounts scratches that match the MEDia. If a SUBpool is supplied, a cartridge that matches MEDia within the subpool is mounted. T APEREQ Control Statement V arious Job Criteria Ye s * Ye s * Ye s * Processes which use this cont[...]

Appendix A. Macros, Control Statements, Ut ilities, and Commands Syntax Reference 443 1st ed., 6/30/04 - 312579601 VOLA TTR Control Statement N/A Y es Y es No The MEDia of a given volume must be defined here and the desired RECtech to be used on t his volume may also be expressed. Lists are used to define a pool of volumes from which to select. If [...]

444 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 LIBGEN Macr os The LIBGEN macros are shown below in alph abetical order . Refer to ‘ ‘Syntax Flow Diagrams’ ’ in the HSC Installation Guide for complete explanations of macro syntax an d parameters, and the order in which they must be specified.[...]

Appendix A. Macros, Control Statements, Ut ilities, and Commands Syntax Reference 445 1st ed., 6/30/04 - 312579601 SLIA CS macr o SLIALIST macro SLIDLIST macro SLIDRIVS macros SLIENDGN macro acs0 SLIACS Additional Parameters Additional Parameters: ACSDRV=( esoteric0, ...,esoteric15 ) ,LSM=( lsm0,lsm1, ...,lsm23 ) ,STATION=( station0, ...,station15 [...]

446 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SLILIBR Y macro SLILIBRY HOSTID=( host-id0,host-id 1,...,host-id15 ) ,ACSLIST= acslist Optional Parameters Optional Param eters : ,CLNPRFX= prefix CLN ,SMF= libtype 255 ,NNLBDRV=( esoteric0,...,esoter ic1 5) ,DELDISP= SCRTCH NOSCRTCH ,MAJNAME= qname STKALSQN ,COMPRFX= commandch[...]

Appendix A. Macros, Control Statements, Ut ilities, and Commands Syntax Reference 447 1st ed., 6/30/04 - 312579601 SLILSM macro SLIRCVR Y macro SLIST A TN macro S ( ptppane18, S M )) ,ADJACNT=( lsm1,...,lsm4 ) ,DOOR= ECAP ,WINDOW=( wndpanel0,...,wndpanel3 ) 100 TYPE= 4410 9310 9360 075 050 , - 9740 SLILSM lsm0 ,PASTHRU=(( ptppane10 , M ) , ... , WC[...]

448 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 HSC Contr ol Statements Refer to Chapter 3, “HSC Cont rol S tatements and HSC Start Procedure” on page 83 for more information on control statement syntax and parameters. Control Data Set Definition (CDSDEF) contr ol statement EXECP arm contr ol statement Journal Definition[...]

Appendix A. Macros, Control Statements, Ut ilities, and Commands Syntax Reference 449 1st ed., 6/30/04 - 312579601 LKEYDEF command and control statement LKEYINFO control statement LMUP A TH control statement LMU P ath Definition (LMUPD EF) command and control statement DATASET( dataset.name ) DSN( dataset.name ) VOLume( volser ) LKEYDEF UNIT( unitn[...]

450 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 OPTion contr ol statement Reconfiguration Definition (RECDEF) contr ol statement Scratch Subpool (SCRPOo l) contr ol statement OPTion TITLE( identifying-string ) TRACE TRACEF RECDEF DSN1( dataset.name ) ,VOL1( volser ),UNIT1( unitname ) ,DSN2( dataset.name ) ,VOL2( volser ),UNI[...]

Appendix A. Macros, Control Statements, Ut ilities, and Commands Syntax Reference 451 1st ed., 6/30/04 - 312579601 Scratch Subpool Definition (SCR PDEF) command and contr ol statement T ape Request (T APEREQ) control statement SCRPDEF DSN( dataset.name ) DATASET( dataset.name ) VOLume( volser ) UNIT( unitname ) HOSTID( host-id , ) TAPEREQ JOBname( [...]

452 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 T ape Request (T APEREQ) contr ol statement (continued) MEDia( LONGItud ) R Standard CST MEDIA1 STD 1 3480 ECART E ECCST ETAPE Long MEDIA2 3490E ZCART Z HELical DD3 DD3A DD3B DD3C STK1 STK1R STK2 STK2P RECtech( LONGItud ) 18track 36track 36Atrack 36Btrack 36Ctrack HELical DD3 S[...]

Appendix A. Macros, Control Statements, Ut ilities, and Commands Syntax Reference 453 1st ed., 6/30/04 - 312579601 T ape Request Defini tion (TREQDEF) comm and/control statement Unit Attrib ute (UNIT A TTR) control statement TREQDEF DATASET( dataset.name ) DSN( dataset.name ) VOLume( volser ) UNIT( unitname ) HOSTID( host-id , ) UNITATTR ADDRess( )[...]

454 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Unit Attrib ute Definition (UNIT DEF) command/control statement V olume Attrib ute (V OLA TTR) control statement UNITDEF DATASET( dataset.name ) DSN( dataset.name ) VOLume( volser ) UNIT( unitname ) HOSTID( host-id , ) VOLATTR SERial( volser vol-range vol-list , ) MEDia( Standa[...]

Appendix A. Macros, Control Statements, Ut ilities, and Commands Syntax Reference 455 1st ed., 6/30/04 - 312579601 V olume Attribute (V OLA TTR) control statement (contin ued) RECtech( ) MAXclean( use-limit ) LONGItud 18track 36track 36Atrack 36Btrack 36Ctrack HELical DD3 STK1R STK1R34 STK1R35 STK1RA STK1RA34 STK1RA35 STK2PA STK1RAB STK1RAB4 STK1RA[...]

456 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 V olume Attrib ute Definition (V OLDEF) command/contr ol statement VOLDEF DSN( dataset.name ) DATASET( dataset.name ) VOLume( volser ) UNIT( unitname ) HOSTID( host-id , )[...]

Appendix A. Macros, Control Statements, Ut ilities, and Commands Syntax Reference 457 1st ed., 6/30/04 - 312579601 Utilities Refer to Chapter 4, “Utility Functions” on pa ge 169 for more information on utility syntax and parameters. A CTIvities Report utility A UDIt utility ACTIvities Optional Parameters Optional Parameters : BEGIN( begin-date [...]

458 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 B A CKup utility Database Decompile (LIBGEN) utility Directory Rebuild (DIRBLD) utility EJECt utility BACKup CDS( Primary Secondary STandby ) OPTion( Restart Analyze Copy ) LIBGEN DIRBLD EJECt Eject Method 1 Eject Method 2 CAP( cap-list ) , Eject Method 1: Eject Method 2: VOLse[...]

Appendix A. Macros, Control Statements, Ut ilities, and Commands Syntax Reference 459 1st ed., 6/30/04 - 312579601 EJECt utility (continued) Enter Cartridg es utility Eject Method 2 (continued): MEDia( Standard ) CST MEDIA1 STD 1 3480 ECART E ECCST ETAPE Long MEDIA2 3490E ZCART Z DD3A DD3B DD3C STK1R R STK2 RECtech( 18track 36Atrack 36Btrack 36Ctra[...]

460 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Journal OFFLoad utility MO V e utility Reconfiguration utility REPLace utility OFFLoad MOVe Parameters Param eters: Flsm( lsm-id ) Panel( panel-list ) Volume( vol-list ) Row( row-list ) Column( column-list ) TLsm( lsm-list ) TPanel( panel ) START S reconfig-procname REPLaceall [...]

Appendix A. Macros, Control Statements, Ut ilities, and Commands Syntax Reference 461 1st ed., 6/30/04 - 312579601 REST ore utility SCRAtch utility RESTore APPly( NO YES ) GENerate( Only Short YES NO ) SCRAtch VOLser( vol-list , )[...]

462 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Scratch Redistrib ution (SCREdist) utility SCREdist ACS( acs-id ) LSM( lsm-list , ) SUBpool( subpool-name ) BALtol( tolerance-value ) LONGItud Standard CST MEDIA1 STD 1 3480 ECART E ECCST ETAPE Long MEDIA2 3490E ZCART Z HELical DD3 DD3A DD3B DD3C STK1 STK1R R LONGItud 18track 3[...]

Appendix A. Macros, Control Statements, Ut ilities, and Commands Syntax Reference 463 1st ed., 6/30/04 - 312579601 SET utility SET Options Options: ACSDRV( esoteric ) ,FORACS( acs-id ) ,FORHOST( host-id ) CLNPRFX( prefix ) COMPRFX( cmdhex ) DELDISP( SCRTCH NOSCRTCH ) HOSTID ( newhost ), FORHOST( oldhost ) HSCLEVEL(OFF),FORHOST( host-id ) MAJNAME( q[...]

464 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SET utility (continued) UNSCratch utility Unselect utility SET Options Opti ons: SMF( libtype ) TCHNIQE( JOURNAL SHADOW BOTH STANDBY ALL NONE ) SLIDRIVS( addr0 ,...addr19 ) ,FORLSMID( lsm-id ) ,FORPANEL( panel ) ,FORHOST( host-id ) SLISTATN( stat1 ,..., stat16 ) ,FORACS( acs-id[...]

Appendix A. Macros, Control Statements, Ut ilities, and Commands Syntax Reference 465 1st ed., 6/30/04 - 312579601 V olume Report (V OLRpt) utility VOLRpt ACS( acs-id ) LSM( lsm-list , ) VOLser ( volser vol-range vol-list , ) VOLume ( volser vol-range vol-list , ) SORT( LOC INS VOL SEL USE ) DEScend ASCend NOSORT INCLude( , * SCR NONSCR ERR NONERR [...]

466 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Operator Commands Refer to ‘ ‘Operator comma nds’ ’ in the HSC Ope rator ’ s Guide for complete explanations of command syntax and parameters. CAP Preference (CAP Pref) command and contr o l statement CDs Enable/Di sable command CLean command CAPPref prefvlue lsm-id c[...]

Appendix A. Macros, Control Statements, Ut ilities, and Commands Syntax Reference 467 1st ed., 6/30/04 - 312579601 Communications P ath (COMMPath) command and contr ol statement DISMount command COMMPath HOSTid( host-id ) METHod( LMU CDS LMU, acs-id VTAM ) LMUpath( acs-id acs-range acs-list , ) VTAMpath( name ) LMUpath( acs-id acs-range acs-list , [...]

468 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Display command Display Acs Display ALl Display ALLOC Display Cap Display CDS Display acs-id Acs ( acs-list , ) acs-range Display ALl Display ALLOC Display (all CAPs) Cap acs-id lsm-id cap-id Display CDS[...]

Appendix A. Macros, Control Statements, Ut ilities, and Commands Syntax Reference 469 1st ed., 6/30/04 - 312579601 Display Cmd Display COMMP ath Display DRives Display command-name COmmand CMd Display COMMPath HOSTid( ALL host-id * , host-list ) Display DRives Library ACS( acs-id ) LSM( lsm-id ) ACtive ALl Idle DETail[...]

470 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Display Drives (contin ued) MEDia( LONGItud Standard CST MEDIA1 STD 1 3480 ECART E ECCST ETAPE Long MEDIA2 3490E ZCART Z HELical DD3 DD3A DD3B DD3C DD3D STK1 STK1R R STK1U U RECtech( LON GItud ) ) STK2 STK2P STK2W 18track 36track 36Atrack 36Btrack 36Ctrack HELical DD3 STK1R STK[...]

Appendix A. Macros, Control Statements, Ut ilities, and Commands Syntax Reference 471 1st ed., 6/30/04 - 312579601 Display Exceptions Display LKEYDEF Display LMUPDEF Display LSM Display Message Display MNTD Display EXceptns X Display LKEYDEF Display LMUPDEF Display Lsm lsm-id lsm-range ( , lsm-list ) Display Message Msg msgnum Display MNTD[...]

472 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Display MONitor Display OPTion Display Requests Display MONitor ,PGMI ,L( name cc ) Display OPTion Display Requests[...]

Appendix A. Macros, Control Statements, Ut ilities, and Commands Syntax Reference 473 1st ed., 6/30/04 - 312579601 Display SCRatc h Display SCRatch acs-id lsm-id SUBpool( subpool-name ) DETail MEDia( Standard LONGItud ) CST MEDIA1 STD 1 3480 ECART E ECCST ETAPE Long MEDIA2 3490E ZCART Z HELical DD3 DD3A DD3B DD3C STK1 STK1R R RECtech( LONGItud 18tr[...]

474 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Display SCRPDEF Display SR Vlev Display Status Display SCRPDEF Display SRVlev Display Status[...]

Appendix A. Macros, Control Statements, Ut ilities, and Commands Syntax Reference 475 1st ed., 6/30/04 - 312579601 Display THReshld Display TREQDEF Display THReshld acs-id lsm-id SUBpool( subpool-name ) DETail MEDia( Standard LONGItud ) CST MEDIA1 STD 1 3480 ECART E ECCST ETAPE Long MEDIA2 3490E ZCART Z HELical DD3 DD3A DD3B DD3C STK1 STK1R R RECte[...]

476 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Display UNITDEF Display V OLDEF Display V olume DRAin CAP command EJect command Display UNITDEF Display VOLDEF Display Volume Volser vol-range volser ( vol-list , ) DETail DRAin cap-id EJect ENter ( ) cap-list , EJect Option 2 Option 1 Option 1: vol-range volser ( vol-list , ) [...]

Appendix A. Macros, Control Statements, Ut ilities, and Commands Syntax Reference 477 1st ed., 6/30/04 - 312579601 Eject Command (contin ued) ) Option 2: SCRTCH acs-id lsm-id cap-id ( cap-list ) , SUBpool( subpool-name ) MEDia( LONGItud ) Standard CST MEDIA1 STD 1 3480 ECART E ECCST ETAPE Long MEDIA2 3490E ZCART Z HELical DD3 DD3A DD3B DD3C STK1 ST[...]

478 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 ENter command Journal command MODify command MONIT OR command ENter acs-id cap-id lsm-id 00 SCRatch Journal Full( Continue ABEND ) F MODify CAP cap-id lsm-id ONline OFFline LSM lsm-id lsm-range ( lsm-list , ) ONline OFFline FORCE MN MONITOR PGMI ,L( cc name )[...]

Appendix A. Macros, Control Statements, Ut ilities, and Commands Syntax Reference 479 1st ed., 6/30/04 - 312579601 Mount command Mount volser devaddr host-id , Readonly SCRTCH devaddr host-id SUBpool( subpool-name ) MEDia( ) LONGItud Standard CST MEDIA1 STD 1 3480 ECART E ECCST ETAPE Long MEDIA2 3490E ZCART Z HELical DD3 DD3A DD3B DD3C STK1 STK1R R[...]

480 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Mount/Dismount Options (MNTD) command and contr ol statement MNTD AUtocln( ON OFf ) , Dismount( Auto Manual ) EJctauto( ON MSg OFf ) ACS( acs-id ) Float( ON OFf ) ACS( acsid ) MAXclean( count ) MMount( Delete Reply ) MOuntmsg( Roll Noroll ) PASSTHRU( count ) Scratch( Manual Aut[...]

Appendix A. Macros, Control Statements, Ut ilities, and Commands Syntax Reference 481 1st ed., 6/30/04 - 312579601 MO V e command MOVe Flsm( lsm-id ) Panel( pp ) Row( row-list ) Column( cc ) Row( rr ) Column( column-list ) Volume( vol-range volser vol-list , ) TLsm( lsm-id lsm-list , ) TPanel( pp )[...]

482 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 OPTion command and control statement RECover Host command RELease CAP command OPTion Dialog( Both Log Console Off ) , HOSTID( host-id ) DISCmsg( SHow SUppress ) ACS( acs-id ) EJLimit( count ) ENTdup( Auto Manual ) LOGging( Standard Extended ) Output( Upper Mixed ) Repath( Yes N[...]

Appendix A. Macros, Control Statements, Ut ilities, and Commands Syntax Reference 483 1st ed., 6/30/04 - 312579601 SENter command SR Vlev (Service Level) command Stop Monitoring (S T OPMN) command SWitch command SENter cap-id SRVlev BASE FULL STOPMN PM PGMI ,L( cc name ) SWitch Acs acs-id (1) Note: (1) ACS acs-id is optional in a single-ACS environ[...]

484 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 TRace command TRA CELKP command V ary Station command TRace comp-name comp-list , OFF comp-name comp-list , TRACELKP table-name table-list , OFF table-name Vary acs-range acs-id ( acs-list , ) OFFline ONline FORCE ACS dev-id dev-range ( dev-list , STation )[...]

Appendix A. Macros, Control Statements, Ut ilities, and Commands Syntax Reference 485 1st ed., 6/30/04 - 312579601 VIew command VIew CAp CAPID( cap-id ) Lsm( l sm-id) CAPID(00:00:00) CEll Row( rr ) Row(00) Lsm(00:00) Lsm( lsm-id ) Panel( pp ) Panel(00) Column( cc ) Column(00) Column( cc ) Column(00) DRive Address( xxx ) Host( host-id ) PLaygrnd Lsm[...]

486 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 W arn command Warn SCRatch lsm-id acs-id SUBpool( subpool-name ) THReshld( threshold-value ) MEDia( LONGItud Standard ) RECtech( LONGItud , ) CST MEDIA1 STD 1 3480 ECART E ECCST ETAPE Long MEDIA2 3490E ZCART Z DD3 DD3A DD3B DD3C STK1 STK1R R STK2 STK2P 18track 36Atrack 36Btrack[...]

Appendix A. Macros, Control Statements, Ut ilities, and Commands Syntax Reference 487 1st ed., 6/30/04 - 312579601 HSC Diagnostic Commands LIst command TRace command LIst data-structure address size 16 TRace comp-name comp-list , OFF comp-name comp-list ,[...]

488 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SCP Operator Commands * (comment) Statement A UTHoriz e Command CANCEL command CP Command DEFine Command DUMP Command * comments AUTHorize user-list userid ( , CMDS MSGS route-codes NETVM NONE CANCEL taskid DUMP CP cmdparm DEFine CU DEV CHAN chnum chtype chcu cutype cuu devtype[...]

Appendix A. Macros, Control Statements, Ut ilities, and Commands Syntax Reference 489 1st ed., 6/30/04 - 312579601 FILE Command HELP Command Modify Command (SCP) Query Command FILE ddname BLOCKIO DISK CLEAR DEV vaddr CARD PNCH PRNT CLass class DSN dsn IUCV userid * vaddr DSN dsn HELP HELP scp-command diag-command msgnum topic taskname hsc-command Q[...]

490 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Reply Command SET Command Reply nn text 'text' CONSlog SET ON OFF CLOSE destination DUMPOpts REset maxcount ( userid ( userid MSGtype MSGNOH MSG PERFlog ON OFF CLOSE SMF subsystem interval SUBTYPE( subtype-list , ) dest. TRACE ON OFF CLOSE SELect SET events dest.[...]

Appendix A. Macros, Control Statements, Ut ilities, and Commands Syntax Reference 491 1st ed., 6/30/04 - 312579601 ( Class class TO FOR userid AT node , ALL DSP EXT IO I/O IUC MCK destinat ion: events: NONE PGM RST SIO SVC USR[...]

492 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SLK Command ST Art Command ST OP Command ST OPSCP Command SUBSYS Command SLK scp-command STArt progname progname taskid 50 prio ( parms JOBRDR AUTHRDR JOBRDR taskid AUTHRDR taskid 50 prio (CLass class STOP taskid STOPSCP (REIPL (LOGOFF SUBSYS sysname initpgm ( parms[...]

Appendix A. Macros, Control Statements, Ut ilities, and Commands Syntax Reference 493 1st ed., 6/30/04 - 312579601 GCS Component Server Commands SLKGCS Command SLKGCS START DISPLAY STOP CANCEL[...]

494 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 CMS Operator Commands A CS EXEC CMS HELP EXEC ACS command INIT ( NOJOBs BREAK bre akstr PARM= parmstr SUBMIT jobfname SLKJCL ftype * fmode U class (PARM= parmstr UTILity util-list utility ( NOSEND JOBName jobname NOE DIT HELP ACS MENU scp-command =diag-command .hsc-command topi[...]

Appendix B. CP Commands and DIAGNOSE Codes 495 1st ed., 6/30/04 - 312579601 Appendix B. CP Commands and DIA GNOSE Codes Overview This appendix lists all of the CP commands and programming services codes that may be issued by the VM HSC. The VM HSC uses only privilege class G DIAGNOSE codes, and with the exception of MSGNOH, uses only privile ge cla[...]

496 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 IUCV Communication vehicle for API and communication with Host to Host component .[...]

Appendix C. Reco rd Formats 497 1st ed., 6/30/04 - 312579601 Appendix C. Recor d Formats Overview This appendix provides the record formats for the HSC SM F , LOGREC, V olume Report, and Batch API records. These records ar e mapped by SMP/E-distribut ed macros. Each record format contains the following information: • decimal repres entation • h[...]

498 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 T able 30 provides a key to the SMF record format tables. Mapping Macros f or SMF Recor ds Mapping macros for SMF records are listed in T able 31 on page 499 . Mapping Macros f or LOGREC Recor ds Mapping macros for LOGREC records are listed in T able 42 on page 525 . Mapping Ma[...]

Appendix C. Reco rd Formats 499 1st ed., 6/30/04 - 312579601 SMF Recor ds SMF Mapping Macr os T able 31. Mappin g Ma cros f or SMF Recor ds Macro Description SLSDV AR V olum e Attribute Record Data Length (withi n other SMF records) SLSSFHDR SMF Record Header Information SLSSBLOS SMF LSM Operations Statistics SLSSCAPJ SMF CAP Eject Record SLSSCAPN [...]

500 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SMF Recor d Formats SLSD V AR Cross Ref erence T able 32. SLSDV AR Record Format Dec Hex T ype Length Label Description SLSDV AR - Distributed V olume Attribute Record Length FUNCTION: Pass the HSC V olume Attribute Record Length(V ARL) for other Distributed HSC Macros to use a[...]

Appendix C. Reco rd Formats 501 1st ed., 6/30/04 - 312579601 SLSSFHDR T able 33. SLSSFHDR Record Format Dec Hex T ype Length Label Description SLSSFHDR - SMF RECORD HEADER MAP FUNCTION: MAPS THE ST ANDARD SMF RECORD HE ADER AS DEFINED IN THE IBM SMF MANUAL (GC28-1 153). IBM PROVIDES NO MAPPING MACRO. MAPS THE ACHS EXTENSIONS TO THE HEADER. SYMBOLIC[...]

502 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 18 (12) CHARACTER 4 OSHDSSID SUBSYSTEM ID 22 (16) SIGNED-HWORD 2 OSHDRSTY RECOR D SUBTYPE. If adding new record subtype(s), change fi eld OSHDMAXS and add an entry in the HSSUBS table of SLUPE RF . Then reassemble modules SLSOOSMF , SLSOWSMF , and SLUPERF . 1 (01) CONST OSHDBLO[...]

Appendix C. Reco rd Formats 503 1st ed., 6/30/04 - 312579601 27 (1B) CONST O SHDVT27 (VTCS) VTV SCRA TCH Event 28 (1C) CONST OSHDVT28 (VTCS) REPLICA TE VTV ->CLUSTERED VTSS Rqst 28 (1C) CONS T OSHDMAXS M AXIMUM RECORD SUBTYPE V ALUE 24 (18) LENG TH OSHDL LENG TH OF FIXED POR TION OF OSHD R 24 (18) OFFSET SLSSTYP E DEFINE EACH SMF SUBTYPE T able [...]

504 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Cro ss Reference Name Len Offset Va l u e OSHDBLOS - 01 OSHDDA TE 000004 0A OSHDDESC 000002 02 OSHDEJCT - 05 OSHDENTR - 06 OSHDFLAG 000001 04 OSHDL - 18 OSHDLRST - 04 OSHDMAXS - 1C OSHDMLSM - 03 OSHDRCTY 000001 05 OSHDRC07 - 07 OSHDRECL 000002 00 OSHDRSTY 000002 16 OSHDSID 0000[...]

Appendix C. Reco rd Formats 505 1st ed., 6/30/04 - 312579601 OSHDVT20 - 1 4 OSHDVT21 - 1 5 OSHDVT22 - 1 6 OSHDVT23 - 1 7 OSHDVT24 - 1 8 OSHDVT25 - 1 9 OSHDVT26 - 1 A OSHDVT27 - 1 B OSHDVT28 - 1 C SLSSTYPE - 18 Name Len Offset Va l u e[...]

506 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SLSSBLOS T able 34. SLSSBLOS Recor d Format Dec Hex T ype Length Label Description SLSSBLOS - LSM OPERA TIONS ST A TIS TICS FUNCTION: CONT AINS PERFORMA NCE ST A TISTICS FOR THE LSM. THE SAME STRUCTURE IS USED TO CREA TE THE SMF PERFORMANCE RECORD, HOWEVER THE CONTROL BLOCK HEA[...]

Appendix C. Reco rd Formats 507 1st ed., 6/30/04 - 312579601 Cro ss Reference 16 (10) SIGNED-FWORD 4 BLOSDTIM DIFFERENT LSM ELAPSED TIME 20 (14) SIGNED-FWOR D 4 BLOSP TRU P ASSTHRU COUNT 22 (16) LENG TH BLOSVL LENG TH OF DA T A SECTION 20 (14) LENG TH BLOSVL1 LENG TH OF COUNTER SECTION 24 (18) LENG TH BLOSL BLOS LENG TH Name Len Offset Va l u e BLO[...]

508 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SLSSCAPJ Cro ss Reference T able 35 . SLSSCAPJ Rec ord F ormat Dec Hex T ype Len Label Des cription SLSSCAPJ - CAP EJ ECT SMF RECORD FUNCTION: USED TO HOLD INFORMA TION P ASSED TO TH E ALS SMF WRITER SER VICE ROUTINE FOR THE CAR TRIDGE EJECT EVENT . SYMBOLICS: &DSECT - DSEC[...]

Appendix C. Reco rd Formats 509 1st ed., 6/30/04 - 312579601 SLSSCAPN Cro ss Reference T able 36. SLSSCAPN Record Format Dec Hex T ype Length Label Description SLSSCAPN - CAP ENTER SMF RECORD FUNCTION: USED TO HOLD INFORMA TION P ASSED TO THE ALS SMF WRITER SER VICE ROUTINE FOR THE CAR T RIDGE ENTER EVENT . SYMBOLICS: &DSECT - DSECT OR CONTINUA[...]

510 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SLSSVST A T able 37. SLSSVST A Record Format Dec Hex T ype Length Label Description SLSSVST A - V AR Y ST A TION SMF RECORD S UBTYPE MAP FUNCTION: CONT AINS A RECORD OF S UCCESSFUL SUBSYSTEM V AR Y COMMANDS. SYMBOLICS: &DSECT - DSECT OR CONTINUA TION OF DA T A AREA. YES - P[...]

Appendix C. Reco rd Formats 511 1st ed., 6/30/04 - 312579601 Cro ss Reference Name Len Offset Va l u e SLSSVST A 000002 00 SVST ACID 000001 04 SVST ACS - 10 SVST A TID 000002 04 SVSTFLAG 000004 00 SVSTFLG0 000001 00 SVSTFOR - 20 SVSTL - 08 SVSTSTBY - 08 SVSTUNID 000002 06 SVSTV ACS - 04 SVSTVOF - 40 SVSTVON - 80[...]

512 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SLSSMLSM Cro ss Reference T able 38. SLSSMLSM Recor d Format Dec Hex T ype Length Label Description SLSSMLSM - MODIFY LSM SMF RECORD SUBTYP E MAP FUNCTION: CONT AINS A RECORD OF S UCCESSFUL SUBSYSTEM MODIF Y COMMANDS. SYMBOLICS: &DSECT - DSECT OR CONTINUA TION OF DA T A ARE[...]

Appendix C. Reco rd Formats 513 1st ed., 6/30/04 - 312579601 SLSSLSB T able 39. SLSSLSB Record Format Dec Hex T ype Length Label Description SLSSLSB - LMU ST A TISTICS BUFFER DA T A BLOCK FUNCTION: THE CALLER OF THE SLSLRST A FUNCTION SUPPLIES THE ADDRES S OF A DA T A BU FFER TO BE FILLED IN WITH THE RESPONSE DA T A FROM AN LMU READ ST A TISTICS RE[...]

514 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Cro ss Reference LSBECON1 AND LSBECON2 HA VE THE FOLLOWING MAPPING: BYTE 0 - RESER VED BYTE 1 - ACSID BYTE 2 - SLA VE LSMID BYTE 3 - RESER VED BYTE 4 - RESER VED BYTE 5 - RESER VED 12 (C) SIGNED-FWORD 4 -RESER VED-(2) *** RESER VED 20 (14) LENG TH LSBEL SIZE OF LSBE. Name Len O[...]

Appendix C. Reco rd Formats 515 1st ed., 6/30/04 - 312579601 SLSSMF07 T able 40. SLSSMF07 Record Format Dec Hex T ype Length Label Description DSECT : SLSSMF07 - HSC RECO RD TYPE 7 MAPPIN G MACRO FUNCTION: MAPS THE SUBTYPE 7 SMF RECORD PRODUCED BY THE HSC. THIS IS PRODUCED FOR EACH SUCCESSFUL MOVE INITIA TED BY THE HSC. THESE RECORDS WERE ORIGINALL[...]

516 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 .. .. .1.1 X’05’ SMF07OPR HSC OPERA TOR COMMAND INITIA TED .... .1 1. X’06’ SMF07TMI VM TMI INTERF ACE 2 (2) BITSTRING 1 SMF07FLG FLAG BYTE 1... .... X’80’ SMF07DSV SMF07DRS CONT AINS A DRIVE DEVICE NUM .1.. .... X’40’ SMF07DTV SMF07DR T CONT AINS A DRIVE DEVICE[...]

Appendix C. Reco rd Formats 517 1st ed., 6/30/04 - 312579601 27 (1B) CHARACTER 8 SMF07US1 THIS SHOULD AL W A YS ONL Y CONT AIN DISPLA Y ABLE EBCDIC (INC BLANKS). JOBNAME IF REQ FROM JOB PROCESSING , HSC UTILITY , OR HSC PROGRAMA TIC INTERF ACE, OR HSC INITIA TED. ‘CONSOLE’ IF IN ITIA TED BY THE OPERA TOR VIR TUAL MACHINE NAME THE IUCV RECEIVED [...]

518 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 ‘1’ (F1) CHAR CONST SMF07SCE CELL ‘2’ (F2) CHAR CONST SMF07SCP CAP ‘3’ (F3) CHAR CONST SMF07SDR DRIVE 56 (38) HEXSTRIN G 1 SM F07SAC SOURCE ACS 57 (39) HEXSTRIN G 1 SMF07SLS SOURCE LSM 58 (3A) HEXSTRIN G 1 SMF07SPN SOURCE P ANEL 59 (3B) HEXSTRIN G 1 SMF07SRO SOURCE [...]

Appendix C. Reco rd Formats 519 1st ed., 6/30/04 - 312579601 88 (58) LENG TH SMF07SL LENG T H OF NON-LMU POR TION OF SUBRECORD THIS MAPS THE DA T A RETURNED BY THE LMU. IT IS ONL Y A V AILABLE IF SM F07LMD IS ON. NOTE THA T THE LMU TIMES ARE ONL Y V ALID TO A TENTH OF A SECOND . THE HSC CONVER TS THE TIMES TO HUNDREDTHS TO BE CONSISTENT WITH OTHER [...]

520 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Cro ss Reference Name Len Offset Va l u e SLSSMF07 000001 00 SMF07CNV - 20 SMF07CON 000004 2B SMF07CPO 000004 17 SMF07DEI 000001 3D SMF07DNS - 10 SMF07DRO 000004 60 SMF07DRQ 000004 64 SMF07DRS 000002 43 SMF07DR T 000002 45 SMF07DSS - 20 SMF07DSV - 80 SMF07DTV - 40 SMF07DWT 0000[...]

Appendix C. Reco rd Formats 521 1st ed., 6/30/04 - 312579601 SMF07MVU - ‘CV AL ’ SMF07MVV - ‘CV AL ’ SMF07NRD 000004 13 SMF07NTR - 02 SMF07OPR - 05 SMF07ORO 000004 68 SMF07ORQ 000004 6C SMF07PRF - 08 SMF07PRG - 04 SMF07PRO 000004 70 SMF07PRQ 000004 74 SMF07RQS 000001 01 SMF07SAC 000001 38 SMF07SCE - ‘CV AL ’ SMF07SCO 000001 3C SMF07SCP [...]

522 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SMF07TDR - ‘CV AL ’ SMF07TDT 000004 07 SMF07TDW - ‘CV AL ’ SMF07TLS 000001 3F SMF07TMI - 06 SMF07TNM 000001 57 SMF07TPN 000001 40 SMF07TRO 000001 41 SMF07TTM 000004 03 SMF07TYP 000001 00 SMF07UNK - 00 SMF07US1 000008 1B SMF07US2 000008 23 SMF07UTL - 03 SMF07VMT - ‘CV [...]

Appendix C. Reco rd Formats 523 1st ed., 6/30/04 - 312579601 SLSSMF08 T able 41. SLSSMF08 Record Format Dec Hex T ype Length Label Description SLSSMF08 - HSC RECORD TYPE 8 MAPP ING MACRO FUNCTION: MAPS THE SUBTYPE 8 SMF RECORD PRODUCED BY THE HSC. THIS IS PRODUCED FOR EACH SUCCESSFUL VIEW COMMAND INITIA TED BY THE HSC. SPECIAL CONSIDERA TIONS: This[...]

524 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Cro ss Reference Name Len Offset Va l u e SLSSMF08 000001 00 SMF08ACS 000001 00 SMF08CAP - 02 SMF08CEL - 01 SMF08CID 000001 02 SMF08COL 000001 07 SMF08CUA 000002 12 SMF08DR V - 03 SMF08HST 000008 0A SMF08L - 14 SMF08LSM 000001 01 SMF08LSM2 000001 05 SMF08MAG 000001 03 SMF08PNL [...]

Appendix C. Reco rd Formats 525 1st ed., 6/30/04 - 312579601 LOGREC Recor ds LOGREC Mapping Macr os T able 42. Mappin g Ma cros f or LOGREC Reco rds Macro Description SLSSLHDR LOGREC Header Layout SLSSVLG1 LOGREC V olume/Cell Force Unselect Record SLSSBLOG LOGREC Initializa tion/T ermin ation Record SLSSLLG1 LOGRE C LMU Driver Format 1 SLSSLLG2 LOG[...]

526 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 LOGREC Recor d Formats SLSSLHDR T able 43. SLSSLHDR Record Format Dec Hex T ype Leng th Label Description SLSSLHDR - LOGREC RECORD HEADER MAP FUNCTION: MAPS THE ST ANDARD LOGREC RECORD HEADER AS DEFINED IN THE EREP MANUAL (GC28-1378). IBM PROVID ES NO MAPPING MACRO. MAPS THE AC[...]

Appendix C. Reco rd Formats 527 1st ed., 6/30/04 - 312579601 32 (20) OFFSET OLHDERID ERROR ID 32 (20) HEXSTRING 400 OLHDRSDW SDW A 32 (20) CONST SLSSTYPE HSC software error subtype LOGREC data overlays SDW A area. 432 (1B0) HEXSTRING 3 OLH DRARA SDW ARA 435 (1B3) HEXSTRING 1 OLHDRRAL SDW AURAL (LENG TH OF VRA) 436 (1B4) HEXSTRING 6 OLHDR VRA VRA (A[...]

528 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 652 (28C) LENG TH OLHDL LENG TH OF FIXED POR TION OF OLHD T able 43. SLSSLHDR Record Format (Contin ued) Dec Hex T ype Leng th Label Description[...]

Appendix C. Reco rd Formats 529 1st ed., 6/30/04 - 312579601 Cro ss Reference Name Len Offset Va l u e L TYP AREA - 282 L TYP4001 - 4001 L TYP5000 - 5000 L TYP6501 - 6501 L TYP6502 - 6502 L TYP6503 - 6503 L TYP6504 - 6504 L TYP6505 - 6505 L TYP6506 - 6506 L TYP7000 - 7000 L TYP7001 - 7001 L TYP8500 - 8500 L TYP8501 - 8501 L TYP9201 - 9201 OLHDCDCT [...]

530 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 OLHDR VRA 000006 1B4 OLHDSMS 000001 02 OLHDSOFT - 40 OLHDSTC 000004 284 OLHDSW2 000001 03 OLHDTFLG - 08 OLHDTIME 000004 0C OLHDVS2 - 80 SLSSTYPE - 20 Name Len Offset Va l u e[...]

Appendix C. Reco rd Formats 531 1st ed., 6/30/04 - 312579601 SLSSVLG1 T able 44. SLSSVLG1 Recor d Format Dec Hex T ype Leng th Label Description SLSSVLG1 - VOL/CELL LOGREC RECORD FORM A T 1 FUNCTION: MAPS LOGREC RECORD CREA TED WH EN A VOLUME IS FORCE UNSELECTED SYMBOLICS: &DSECT - DSECT OR CONTINUA TION OF DA T A AREA. YES - PRODUCE A DSECT LI[...]

532 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Cro ss Reference Name Len Offset Va l u e SLSSVLG1 000002 00 VLG1HDR 000004 00 VLG1HOST 000008 0C VLG1JOBN 000008 14 VLG1KEY 000001 09 VLG1L - 36 VLG1LEN 000004 04 VLG1OWNR 000008 22 VLG1SP 000001 08 VLG1SUBT - 4001 VLG1VOLS 000006 1C[...]

Appendix C. Reco rd Formats 533 1st ed., 6/30/04 - 312579601 SLSSBLOG T able 45. SLSSBLOG Record Format Dec Hex T ype Leng th Label Description SLSSBLOG - INIT/TERM LOGREC RECORD FUNCTION: THIS MAPS THE LOGREC RECORD CREA TED BY SLSBINIT WHENEVER THE SUBSYSTEM IS INITIALIZED OR TERMINA TED, NORMALL Y OR ABNORMALL Y SYMBOLICS: &DSECT - DSECT OR [...]

534 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Cro ss Reference Name Len Offset Va l u e BLOGABND - 20 BLOGCNCL - 10 BLOGFLAG 000004 00 BLOGFLG0 000001 00 BLOGID - 5000 BLOGL - 08 BLOGRECO - 08 BLOGSHTD - 40 BLOGSTR T - 80 SLSSBLOG 000002 00[...]

Appendix C. Reco rd Formats 535 1st ed., 6/30/04 - 312579601 SLSSLLG1 T able 46. SLSSLLG1 Record Format Dec Hex T ype Leng th Label Description SLSSLLG1 - LMU DRIVER LOGREC RECORD FORMA T ONE FUNCTION: MAPS LOGREC RECORD CREA TED WHEN AN INV ALID RESPONSE IS RECEIVED FROM THE LMU 0 (0) AREA 2 SLSSLLG1 LMU DR IVER LOGREC FORMA T ONE 25857 (6501) CON[...]

536 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 1 (01) CONST LLG1NUNR UNRECOGNIZABLE TRANSMISSI ON 2 (02) CONST LLG1NSOB NO ST AR T OF BLOCK CHARACTER 3 (03) CONST LLG1NEO B NO END OF BLOCK CHARACTER 4 (04) CONST LLG1NSO T NO ST AR T OF TRANSACTION CHARACTER 5 (05) CONST LLG1NEO T N O END OF TRANSACTION CHARACTER 6 (06) CONS[...]

Appendix C. Reco rd Formats 537 1st ed., 6/30/04 - 312579601 .1.. .... X’40’ LLG1STTC ST A TION IS A NETWORK IP ADDRESS FOR TCP/IP HOSTNAME ADDRES S: 102 (66) CHARACTER 24 LLG1SHNM ST A TION NETWORK HOST NAME FOR TCP/IP NETWORK ADDRESS: 126 (7E) HEXSTRING 4 LLG1STCP ST A TION NETWORK IP ADD RESS 130 (82) HEXSTRING 22 -RESER VED- RESER VED FOR F[...]

538 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Cro ss Reference Name Len Offset Va l u e LLG1ACKE - 24 LLG1ACS 000001 0C LLG1BBLK - 64 LLG1DBKE - 1C LLG1ECD 000001 0F LLG1ERSP - 18 LLG1ER TP - 34 LLG1HDFL 000001 5D LLG1HDR 000004 00 LLG1ILGL - 33 LLG1INVB - 28 LLG1INVR - 10 LLG1ITYP - 84 LLG1KEY 000001 09 LLG1L - 98 LLG1LEN[...]

Appendix C. Reco rd Formats 539 1st ed., 6/30/04 - 312579601 LLG1NWSN - 32 LLG1RCDE 000001 10 LLG1RNTN - 14 LLG1RQST 000044 1 1 LLG1RSPN 000032 3D LLG1SHNM 000024 66 LLG1SNOB - 0C LLG1SP 000001 08 LLG1STCP 000004 7E LLG1STHN - 80 LLG1STN 000002 0D LLG1STTC - 40 LLG1STYP 000001 65 LLG1SUBT - 6501 LLG1SW A T - 0D LLG1UNKB - 20 SLSSLLG1 000002 00 Name[...]

540 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SLSSLLG2 T able 47. SLSSLLG2 Record Format Dec Hex T ype Leng th Label Description SLSSLLG2 - LMU DRIVER LOGREC RECORD FORMA T TWO FUNCTION: MAPS LOGREC RECORD CREA TED WHEN AN INV ALID BLOCK IS RECEIVED FROM THE LMU SYMBOLICS: &DSECT - DSECT OR CONTINUA TION OF DA T A AREA[...]

Appendix C. Reco rd Formats 541 1st ed., 6/30/04 - 312579601 Cro ss Reference FOR TCP/IP NETWORK ADDRESS: 160 (AA) HEXSTRING 4 LLG2STCP ST A TION NETW ORK IP ADDRESS 174 (AE) HEXSTRING 26 -RESER VED- RESER VED FOR FUTURE USE 200 (C8) LENG TH LLG2L Name Len Offset Va l u e LLG2ACS 000001 0C LLG2BLNN - 7C LLG2DBKE - 04 LLG2ECD 000001 0F LLG2HDR 00000[...]

542 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SLSSLLG3 Cro ss Reference T able 48. SLSSLLG3 Record Format Dec Hex T ype Length Label Description SLSSLLG3 - LMU DRIVER LOGREC RECORD FORMA T THREE FUNCTION: DEFINES FORMA T OF DOOR OP EN LOGREC RECORD SYMBOLICS: &DSECT - DSECT OR CONTINUA TION OF DA T A AREA. YES - PRODUC[...]

Appendix C. Reco rd Formats 543 1st ed., 6/30/04 - 312579601 SLSSLLG4 T able 49. SLSSLLG4 Record Format Dec Hex T ype Leng th Label Description SLSSLLG4 - LMU DRIVER LOGREC RECORD FORMA T FOUR FUNCTION: DEFINES FORMA T OF LMU DEGRADED RECORD SYMBOLICS: &DSECT - DSECT OR CONTINUA TION OF DA T A AREA. YES - PRODUCE A DSECT LISTING NO - NO DSECT 0[...]

544 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Cro ss Reference Name Len Offset Va l u e LLG4COND 000001 0E LLG4DEVC 000002 0C LLG4FSC 000004 10 LLG4HDR 000004 00 LLG4KEY 000001 09 LLG4L - 14 LLG4LEN 000004 04 LLG4SP 000001 08 LLG4SUBT - 6504 SLSSLLG4 000002 00[...]

Appendix C. Reco rd Formats 545 1st ed., 6/30/04 - 312579601 SLSSLLG5 T able 50. SLSSLLG5 Record Format Dec Hex T ype Leng th Label Description SLSSLLG5 - DUAL LMU ST A T US CHANGE LOGREC RECORD FUNCTION: DEFINES FORMA T OF DU AL LMU ST A TUS CHANGE LOGREC RECORD SYMBOLICS: &DSECT - DSECT OR CONTINUA TION OF DA T A AREA. YES - PRODUCE A DSECT L[...]

546 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 1... .... X’80’ LLG5STHN ST A TION IS A NETWORK HOSTNAME .1.. .... X’40’ LLG5STTC ST A TION IS A NETWORK IP ADDRESS FOR TCP/IP HOSTNAME ADDRES S: 20 (14) CHARACTER 24 LLG5SHNM ST A TION NETWORK HOSTNA ME FOR TCP/IP NETWORK ADDRESS: 44 (2C) HEXSTRING 4 LLG5STCP ST A TIO [...]

Appendix C. Reco rd Formats 547 1st ed., 6/30/04 - 312579601 Cro ss Reference Name Len Offset Va l u e LLG5ACS 000001 0C LLG5HDR 000004 00 LLG5KEY 000001 09 LLG5L - 48 LLG5LEN 000004 04 LLG5NMST 000001 11 LLG5NSL V 000001 12 LLG5OMST 000001 0F LLG5OSL V 000001 10 LLG5SHNM 000024 14 LLG5SP 000001 08 LLG5STCP 000004 2C LLG5STHN - 80 LLG5STN 000002 0D[...]

548 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SLSSLLG6 T able 51. SLSSLLG6 Record Format Dec Hex T ype Leng th Label Description SLSSLLG6 - Robotic Motion & Softfail Counts LOGREC Record FUNCTION: DEFINES FORMA T OF Robotic Mo tion & Softfail Counts Record SYMBOLICS: &DSECT - DSECT OR CONTINUA TION OF DA T A AR[...]

Appendix C. Reco rd Formats 549 1st ed., 6/30/04 - 312579601 .... 1... X’08’ LLG6L12A V LSM 12 Configured if flag is on. .... .1.. X’04’ LLG6L13A V LSM 13 Configured if flag is on. .... ..1. X’02’ LLG6L14A V LSM 14 Configured if flag is on. .... ...1 X’01’ LLG6L15A V LSM 15 Configured if flag is on. 16 (10) SIGNED-FWORD 4 LLG6L0RM L[...]

550 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 120 (78) SIGNED-FWORD 4 LLG6L13 RM LSM 13 Robotic Motions Started 124 (7C) SIGNED-FWORD 4 LLG6L13SF LSM 13 Softfails Recovered 128 (80) SIGNED-FWORD 4 LLG6L14 RM LSM 14 Robotic Motions Started 132 (84) SIGNED-FWORD 4 LLG6L14 SF LSM 14 Softfails Recovered 136 (88) SIGNED-FWORD 4[...]

Appendix C. Reco rd Formats 551 1st ed., 6/30/04 - 312579601 Cro ss Reference Name Len Offset Va l u e LLG6ACS 000001 0C LLG6FLG1 000001 0E LLG6FLG2 000001 0F LLG6HDR 000004 00 LLG6KEY 000001 09 LLG6L - 90 LLG6LEN 000004 04 LLG6L0A V - 80 LLG6L0RM 000004 10 LLG6L0SF 000004 14 LLG6L1A V - 40 LLG6L1RM 000004 18 LLG6L1SF 000004 1C LLG6L10A V - 20 LLG6[...]

552 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 LLG6L2A V - 20 LLG6L2RM 000004 20 LLG6L2SF 000004 24 LLG6L3A V - 10 LLG6L3RM 000004 28 LLG6L3SF 000004 2C LLG6L4A V - 08 LLG6L4RM 000004 30 LLG6L4SF 000004 34 LLG6L5A V - 04 LLG6L5RM 000004 38 LLG6L5SF 000004 3C LLG6L6A V - 02 LLG6L6RM 000004 40 LLG6L6SF 000004 44 LLG6L7A V - 0[...]

Appendix C. Reco rd Formats 553 1st ed., 6/30/04 - 312579601 SLSSDJLR T able 52 . SLSSDJLR Re cord F ormat Dec Hex T ype Leng th Label Description SLSSDJLR - DA T A BASE JOURNALING LOGREC MAP FUNCTION: TO MAP THE V ARIABLE LENG TH AREA OF THE JOURNALLING ERDS LOG RECORD WHICH BEGINS A T LA BEL OLHDRCRD OF OLHDR LOGREC MAPPING MACRO. SPECIFYING OLHD[...]

554 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Cro ss Reference 120 (78) CH ARACTER 4 DJLRUN42 AL TERNA TE JOURNAL ’S UN IT NAME 124 (7C) CHARACTER 4 DJLRUN41 INITIAL JOURNAL ’S UNIT NAME 128 (80) AREA 8 -RESER VED- FORCE THE LENG TH OF DJLR T O A 128 (80) LENG TH DJLRL DOUBLE-WORD MUL TIPLE FOR GETMAIN. Name Len Offset[...]

Appendix C. Reco rd Formats 555 1st ed., 6/30/04 - 312579601 SLSSPSWI T able 53. SLSSPSWI Record Format Dec Hex T ype Leng th Label Description SLSSPSWI - PRIMA R Y/SHADOW SWITCH LOGREC RECORD FUNCTION: THIS MAPS THE LOGREC RECORD CREA T ED BY SLSDRDSR WHENEVER THE SUBSYSTEM SWITCHES THE DA T ABASE FROM PRIMAR Y TO SHADOWING MODE SYMBOLICS: &DS[...]

556 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Cro ss Reference Name Len Offset Va l u e PSWITERR 000004 04 PSWITFLG 000004 00 PSWITID - 7001 PSWITL - 84 PSWPRDCB 000004 08 PSWPRFLG 000001 00 PSWPRQNM 000044 16 PSWPRUCB 000004 0C PSWPR VOL 000006 10 PSWSCDCB 000004 44 PSWSCFLG 000001 01 PSWSCQNM 000044 52 PSWSCUCB 000004 48[...]

Appendix C. Reco rd Formats 557 1st ed., 6/30/04 - 312579601 SLSSRL00 Cro ss Reference T able 54 . SLSSRL00 Reco rd For mat Dec Hex T ype Leng th Label Description SLSSRL00 - RECOVER Y ERDS RECORD 00 FUNCTION: THIS MAPS THE LOGREC RECORD CREA TED BY SLSRAURE. IT CONT AINS THE LSM ID OF AN LSM REQUIRING AUDIT SYMBOLICS: &DSECT - DSECT OR CONTINU[...]

558 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SLSSRL01 Cro ss Reference T able 55 . SLSSRL01 Reco rd For mat Dec Hex T ype Leng th Label Description SLSSRL01 - RECOVER Y ERDS RECORD 01 FUNCTION: THIS MAPS THE LOGREC RECORD CREA TED BY SLSRHR VC. IT CONT AINS THE HOST ID OF A HOST BEING RECOVERED. SYMBOLICS: &DSECT - DS[...]

Appendix C. Reco rd Formats 559 1st ed., 6/30/04 - 312579601 SLSSHLG1 T able 56. SLSSHLG 1 R ec o r d Format Dec Hex T ype Length Label Des cription SLSSHLG1 - Host Communica tions LOGREC format 1 FUNCTION: Defines the LOGREC record formatted for method switches. 0 (0) STRUCTURE SLSSHLG1 Communications LOGREC format 1 37377 (920 1) CONST HLG1SUBT S[...]

560 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 ..1. .... X’20’ HLG1I WR T Initiated by WRITE fu nction error ...1 .... X’10’ HLG1IICN In itiated b y internal condition (meaning internal to HSC processing, for example, operator switched method for local host so method is sw itched for all other possible hosts) 57 (39[...]

Appendix C. Reco rd Formats 561 1st ed., 6/30/04 - 312579601 Cro ss Reference Name Len Offset Va l u e HLG1FLG1 000001 38 HLG1FLG2 000001 39 HLG1HDR 000004 00 HLG1ICMD - 80 HLG1ID - ‘CV AL ’ HLG1IICN - 10 HLG1INTH 000008 20 HLG1IOTH - 40 HLG1IWR T - 20 HLG1KEY 000001 09 HLG1L - 80 HLG1LCLH 000008 10 HLG1LEN 000004 04 HLG1NLP 000004 28 HLG1NMTH [...]

562 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 V olume Report and Batch API Recor ds V olume Repor t and Batc h API Mapping Macros These SMP/E-distributed macr os map both V olume Report and Batch API records. Refer to “Batch API Records” on page 593 to see SLUVDDA T and SLUVPDA T , which are used only by the Batch API.[...]

Appendix C. Reco rd Formats 563 1st ed., 6/30/04 - 312579601 V olume Repor t and Batc h API Recor d Formats SLUV AD A T T able 58. SLUV ADA T R ecord Format Dec Hex T ype Length Label Description SLUV ADA T - FLA T F ILE ACS/LSM INFORMA TION DSECT FUNCTION: DESCRIBES THE ACS/LSM INFORM A TION WHICH MA Y BE GENERA TED TO THE FLA T FILE BY THE VOLUME[...]

564 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 .1.. .... X’40’ LSMOFFPN .1.. .... - OFFLINE PENDING .... 1. .. X’08’ LSMP TPRO .... 1... - P TPS REORDERED 1111 1111 X ’ F F ’ L S M N O N E X 1111 1111 - N O N - E X I S T E N T L S M 2 (2) BITSTRING 1 LSMVCAMF FLAG BYTE 1... .... X’80’ LSMAUDIP 1... .... - AU[...]

Appendix C. Reco rd Formats 565 1st ed., 6/30/04 - 312579601 29 (1D) HEX STRING 1 LSMNCIPN NU MBER OF COLUME S PER INSIDE P ANEL 30 (1E) HEXSTRING 1 LSMDPNUM NUMBER OF DRIVE P ANELS 31 (1F) HEXSTRING 1 LSMNAD LS NUMBER OF ADJACENT LSMS 32 (20) HEX STRING 4 LSMADLSM ADJACENT LSM NUMBERS (1 BYTE/LSM) 36 (24) SIGNED-HWORD 2 LSMFRECL NUMBER OF FREE CEL[...]

566 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 .. .1 ..1. X’12’ LSMCISDR ...1 ..1. - CIMARRON INSIDE DOOR ...1 ..1 1 X’13’ LSMCWIDN ...1 ..1 1 - CIMARRON 20-DRIVE P ANEL ...1 .1.. X’14’ LSMCWIDD ...1 .1.. CIMARRON 20-DRIVE P ANEL ADJACENT TO DOOR ..1. .... X’20’ LSMWPNL0 ..1. .... - WOLF P ANEL 0 ..1. ...1 X[...]

Appendix C. Reco rd Formats 567 1st ed., 6/30/04 - 312579601 Cro ss Reference 1... .... X’80’ LSMELDR V 1... .... - ELIB DRIVE 1... ...1 X’81’ LSMELCAP 1... ...1 - ELIB CAP 1... ..1. X’82’ LSMEL CEL 1... ..1. - ELIB ST ORAGE 1... ..1 1 X’83’ LSMELCE3 1... ..1 1 - ELIB STORAGE 1... .1.. X’84’ LSMELCE4 1... .1.. - ELIB ST ORAGE 1 [...]

568 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 LSMCDR VP - 06 LSMCDR10 - 07 LSMCIM - 01 LSMCINPN - 10 LSMCIN19 - 1 1 LSMCISDR - 12 LSMCLCUP - 08 LSMCLNNM 000002 26 LSMCNOCL - 09 LSMCP T MP - 04 LSMCSTMP - 05 LSMCWIDD - 14 LSMCWIDN - 13 LSMDPNUM 000001 1E LSMELCAP - 81 LSMELCEL - 82 LSMELCE3 - 83 LSMELCE4 - 84 LSMELDR V - 80[...]

Appendix C. Reco rd Formats 569 1st ed., 6/30/04 - 312579601 LSMNADLS 000001 1F LSMNCIPN 000001 1D LSMNCLSL 000002 28 LSMNCOPN 000001 1B LSMNDPPN 000001 15 LSMNONEX - FF LSMNPGCS 000001 12 LSMNRIPN 000001 1C LSMNROPN 000001 1A LSMNUMBR 000001 00 LSMNXPR T 000001 16 LSMODPNO 000001 18 LSMOFFPN - 40 LSMP ANLS 000006 3E LSMPCCNT 000002 01 LSMPFLG 0000[...]

570 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 LSMTWLF - 06 LSMVCAMF 000001 02 LSMVCAMR - 40 LSMWOLF - 03 LSMWPNL0 - 20 LSMWPNL2 - 25 LSMWPNL3 - 27 LSMWP0P T - 22 LSMWP1DR - 24 LSMWP2P T - 26 LSMWP3DR - 28 LSMWP41C - 29 LSMWP42C - 30 LSMW3NOC - 31 LSMW1NOD - 23 LSMW2PSL - 21 LSMW3DNC - 32 LSMW3WIN - 33 LSMW4CCN - 36 LSMW4CN[...]

Appendix C. Reco rd Formats 571 1st ed., 6/30/04 - 312579601 SLUVCD A T T able 59. SLUVCDA T Record Format Dec Hex T ype Length Label Description SLUVCDA T - FL A T FILE ST A TIC CONFIGURA TION DA T A DSECT FUNCTION: DESCRIBES THE ST A TIC CONFIGURA TION INFORMA T ION WHICH MA Y BE GENERA TED TO THE FLA T FILE BY THE VOLUME REPOR T UTILITY 0 (0) ST[...]

572 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 .... ...1 X’01’ CFGSCRAL .... ...1 - AL (ANSI) .... ..1. X’02’ CFGSCRNL .... ..1. - NL (NONLABELLED) .... ..1 1 X’03’ CFGSCRNS .... ..1 1 - NSL (NON-ST ANDARD) .... .1.. X’04’ CFGSCRBL .... .1.. - BLP (BYP ASS LBL PROC) .... .1.1 X’05’ CFGSCRNA .... .1 .1 - [...]

Appendix C. Reco rd Formats 573 1st ed., 6/30/04 - 312579601 Cro ss Reference Name Len Offset Va l u e CFGCCPFX 000003 01 CFGCHKEP - 20 CFGCMDPF 000001 15 CFGDDISP 000001 16 CFGDDNSC - 40 CFGDDSCR - 80 CFGDISVF - 40 CFGENGLS - 80 CFGFLAG1 000001 17 CFGFRNCH - 10 CFGGERMN - 20 CFGIT ALN - 40 CFGLANG 000001 18 CFGLIBFX - 80 CFGLNG TH - 1A CFGMXLSM - [...]

574 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SLUVHD A T Note: Field HSTLIBEN contains only the first 16 ACS esoteri cs. T able 60. SLUVHD A T Record Format Dec Hex T ype Length Label Description SLUVHDA T - FLA T FILE HOST INFORMA TION DSECT FUNCTION: DESCRIBES THE HOST INFORMA TION WHICH M A Y BE WRITTEN T O THE FLA T FI[...]

Appendix C. Reco rd Formats 575 1st ed., 6/30/04 - 312579601 .1.. .... X’40’ HSTR200 .1.. .... - HSC 2.0.0 ...1 .... X’10’ HSTR201 ...1 .... - HSC 2.0.1 .... 1... X’08’ HSTR210 .... 1... - HSC 2.1.0 .... .1.. X’04’ HSTR400 .... .1.. - HSC 4.0.0 .... ..1. X’02’ HSTR410 .... ..1. - HSC 4.1.0 12 (C) CH ARACTER 8 HSTNONEN NON-LIBRAR[...]

576 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Cro ss Reference Name Len Offset Va l u e HSTDEAD - 10 HSTDELA Y - 20 HSTFLAG1 000001 09 HSTFLAG2 000001 0A HSTFLAG3 000001 0B HSTFXLEN - 03 HSTHNAME 000008 00 HSTHOSLN - 94 HSTHOSTS - 03 HSTHST AC - 20 HSTINDEX 000001 08 HSTLIBEN 000008 14 HSTNHOST 000002 01 HSTNONEN 000008 0C[...]

Appendix C. Reco rd Formats 577 1st ed., 6/30/04 - 312579601 SLUVID A T T able 61. SL UVID A T Recor d Format Dec Hex T ype Length Label Description SLUVIDA T - FLA T FILE CDS INFORMA TION DSECT FUNCTION: DESCRIBES THE CDS INFORMA TION WH ICH MA Y BE GEN ERA TED TO THE FLA T FILE BY THE VOLUME RE POR T UTILITY . 0 (0) STRUCTURE SLUVIDA T 0 (0) CHAR[...]

578 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 0 (0) CH ARACTER 44 CDSDSN CDS DA T ASET NAME 44 (2C) CHARACTER 6 CD SVOL CDS VOLSER 50 (32) HEXSTRING 2 -RESER VED- *** RESER VED *** 52 (34) CH ARACTER 8 CDSUNIT CDS UNIT NAME 60 (3C) HEXSTRIN G 2 CDSSWC NT CDS SWITCH COUNT 62 (3E) HEXSTRIN G 2 -RESER VED- *** RESER VED *** 6[...]

Appendix C. Reco rd Formats 579 1st ed., 6/30/04 - 312579601 Cro ss Reference Name Len Offset Va l u e CDSALL - E0 CDSBDA TE 000008 30 CDSBOTH - A0 CDSBTIME 000008 28 CDSCDA TE 000008 18 CDSCTIME 000008 20 CDSDSN 000044 00 CDSENQNM 000008 08 CDSINFOL - 50 CDSJOURN - 20 CDSLEVEL 000008 10 CDSLNG TH - 138 CDSNAMES 000240 48 CDSNONE - 00 CDSRCVR Y 000[...]

580 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SLUVSD A T T able 62. SLUVSD A T Record Format Dec Hex T ype Length Label Description SLUVSDA T - FLA T FILE ACS ST A TION ADDRESS DSECT FUNCTION: MAP THE ST A TION ADDRESS INFORMA TION BY HOST WITHIN ACS WHICH MA Y BE WRITTEN TO THE FLA T FILE BY THE VOLUME REPOR T UTILITY . 0[...]

Appendix C. Reco rd Formats 581 1st ed., 6/30/04 - 312579601 Cro ss Reference Name Len Offset Va l u e STNACS 000001 01 STNADDRS 000003 01 STNADENL - 03 STNCUA 000002 01 STNENTLN - 31 STNFLAG 000001 00 STNFXLEN - 02 STNHINDX 000001 00 STNONLIN - 80 STNSTNS - 02[...]

582 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SLUVVD A T T o determine the HSC release that produced a volume report flat file, use the CDSDA T A parameter to create flat file records with non-volume information. Interrogate the CDSLEVEL field in the SLUVIDA T (CDS Information) record. A CDS at level 02.00.00 is reported b[...]

Appendix C. Reco rd Formats 583 1st ed., 6/30/04 - 312579601 ‘R’ (D9) CHAR CONST VOLMEDTR (X’D9’) STK1R M EDIA ‘U’ (E4) CHAR CONST VOLMEDTU (X’E4’) STK1U CLEANING CAR TRIDGE “U” ‘W’ (E7) CHAR CONST VOLMED TW (X’E7’) STK2W CLEANING CAR TRIDGE “W” ‘Z’ (E9) CHAR CONST V OLMEDTZ (X’E9’) ZCAR T MEDIA 2 (2) BITSTRI[...]

584 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 26 (1A) CHARACTER 2 VOLHMCEL DECIMAL NUMBER OF THE COLUMN WITHIN VO LHMROW WHERE THE VOLUME RESIDES. 28 (1C) CHARACTER 3 VOLSPLBL VOLUME SUBPOOL LABEL TYPE ‘SL ’ (E2D3) CHAR CONST V OLSPSL ST ANDARD LABEL ‘NL ’ (D5D3) CHAR CONST VOLSPNL NON-L ABELLED ‘AL ’ (C1D3) CH[...]

Appendix C. Reco rd Formats 585 1st ed., 6/30/04 - 312579601 68 (44) CHARACTER 8 VOLDTINS DA TE VOLUME INSER TED INTO THE LIBRAR Y FORMA T DETERMINED BY VOLD4YR 76 (4C) CHARACTER 8 VOL TMINS TIME VO LUME INSER TED INT O THE LIBRAR Y (HH:MM:SS) 84 (54) CHARACTER 8 VOLDTSEL DA TE VOLUME LAST SELECTED FORMA T DETERMINED BY VOLD4YR 92 (5C) CHARACTER 8 [...]

586 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 ..1. .... X’20’ VOLERSSC ..1. .... - SOURCE LOC . SCANNED ...1 .... X’10’ VOLERDSC ...1 ... . - DEST . LOC. SCANNED .... 1... X’08’ VOLERLSC .... 1... - L OST IN LSM SCANNED .... .1.. X’04’ VOLERHSC .... . 1.. - HOME LSM SCANNED .... ..1.X’02’ VOLERMNT .... [...]

Appendix C. Reco rd Formats 587 1st ed., 6/30/04 - 312579601 123 (7B) HEX STRING 3 -RESER VED- * RESER VED 126 (7E) HEXSTRING 6 VOLSRCE SOURCE LOCA TION 132 (84) HEXSTRING 6 VOLDEST DESTINA TION LOCA TION 138 (8A) CHARACTER 2 VOLLILSM “LOST IN” LSM 140 (8C) CHARACTER 8 VOLRECC RECTECH CHAR FORM 148 (94) CHARACTER 8 VOLMEDC MEDIA CHAR FORM 156 ([...]

588 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 5 (5) HEXSTRIN G 1 -RESE R VED- RESER V ED 3 (3) HEXSTRING 1 V OLSDIDX D RIVE INDEX NUMBER 4 (4) HEXSTRING 1 -RESER VED- RESER VED 5 (5) BITSTRING 1 VOLSDFLG DRIVE FORMA T FLAG 1111 1111 X ’ F F ’ V O L S D F I X D R IV E I S D R I V E IN D E X F O R M A T 6 (6) HEXSTRING 2[...]

Appendix C. Reco rd Formats 589 1st ed., 6/30/04 - 312579601 Cro ss Reference Name Len Offset Va l u e VOLDEST 000006 84 VOLDTINS 000008 44 VOLDTMNT 000008 64 VOLDTSEL 000008 54 VOLD4YR - 80 VOLERACT - 80 VOLERDSC - 10 VOLERHSC - 04 VOLERLIL - 40 VOLERLSC - 08 VOLERMNT - 02 VOLERSSC - 20 VOLEXLBL - 20 VOLEXRD - 10 VOLFLAG1 000001 02 VOLFLAG2 000001[...]

590 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 VOLITR TN 000001 7A VOLITT AG 000001 79 VOLITUSE - 80 VOLITVOL - 08 VOLLILSM 000002 8A VOLLNG T H - 78 VOLMEDC 000008 94 VOLMEDIA 000001 01 VOLMEDST - ‘CV AL ’ VOLMEDT A - ‘CV AL ’ VOLMEDTB - ‘CV AL ’ VOLMEDTC - ‘CV AL ’ VOLMEDTD - ‘CV AL ’ VOLMEDTE - ‘CV [...]

Appendix C. Reco rd Formats 591 1st ed., 6/30/04 - 312579601 VOLRRCNL - 34 VOLRRDEJ - 14 VOLRRERR - 2C VOLRRMCT - 44 VOLRRMNT - 10 VOLRRSCA - 20 VOLRRSCD - 24 VOLRRSL V - 3C VOLRRSRE - 40 VOLRRSUA - 38 VOLRR VDL - 28 VOLSACSN 000001 01 VOLSCAP - ‘CV AL ’ VOLSCELL - ‘CV AL ’ VOLSCLOC 000002 03 VOLSCOLN 000001 05 VOLSCR - 80 VOLSDFIX - FF VOL[...]

592 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 VOLSPNLN 000001 03 VOLSPNON - ‘CV AL ’ VOLSPNSL - ‘CV AL ’ VOLSPSL - ‘CV AL ’ VOLSRCE 000006 7E VOLSROWN 000001 04 VOLSTYPE 000001 00 VOL TDINS 000004 38 VOL TDMNT 000004 40 VOL TDSEL 000004 3C VOL TMINS 000008 4C VOL TMMNT 000008 6C VOL TMSEL 000008 5C Name Len Off[...]

Appendix C. Reco rd Formats 593 1st ed., 6/30/04 - 312579601 Batch API Recor ds Batch API Mapping Macr os These SMP/E-distributed macros map only Batch API records. Refer to “V olume Report and Batch API Record s” on page 562 to see th e records that map both V o lume Report and Batch API. T able 64. Mapping macr os for Batch API Recor ds Macro[...]

594 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Batch API Recor d Formats SLUVDD A T This record is produced only by the Batch AP I QCDS requ est. Refer to Appendix E, “Batch Application Program Interface (API)” on page 71 3 for more information. T able 65. SLUVDD A T Record Format Dec Hex T ype Leng th Label Description[...]

Appendix C. Reco rd Formats 595 1st ed., 6/30/04 - 312579601 Cro ss Reference ‘01’ (F0F1) CHAR CONST UVD984B4 T9840B ACTING AS A 3490E ‘07’ (F0F7) CHAR CONST UVD984B5 T9840B ACTING AS A 3590 ‘09’ (F0F9) CHAR CONST UVD994B4 T9940B ACTING AS A 3490E ‘10’ (F1F0) CHAR CONST UVD994B5 T9940B ACTING AS A 3590 ‘02’ (F0F2) CHAR CONST UVD[...]

596 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 UVDFLAG2 000001 02 UVDFLAG3 000001 03 UVDIDACS 000001 06 UVDIDLSM 000001 07 UVDIDNUM 000001 09 UVDIDPNL 000001 08 UVDLEN - 34 UVDLUNIT 000002 12 UVDNOLMU - FFFF UVDNSCR - 40 UVDNUNIT 000002 10 UVDOPRQ - 40 UVDRACF - 10 UVDREDW - ‘CV AL ’ UVDR T 000001 00 UVDSCR - 80 UVDSIL [...]

Appendix C. Reco rd Formats 597 1st ed., 6/30/04 - 312579601 UVD994B5 - ‘CV AL ’ Name Len Offset Va l u e[...]

598 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SLUVPD A T This record is produced only by the Batch AP I QCDS requ est. Refer to Appendix E, “Batch Application Program Interface (API)” on page 71 3 for more information. T able 66. SLUVPD A T Record Format Dec Hex T ype Length Label Description SLUVPDA T - QCDS CAP INF O[...]

Appendix C. Reco rd Formats 599 1st ed., 6/30/04 - 312579601 32 (20) SIGNED-HWORD 2 UVPLPRIO LENG TH OF CAP PRIORITY ELEMENTS 34 (22) HEXSTRING 1 UVPPRITY(1 6) CAP PRIORITY ELEMENTS, BY HOST INDEX 50 (32) HEXSTRING 1 UVPP ANEL P ANEL NUMBER OF CAP 51 (33) BITSTRING 1 UVP TYPE TYPE OF CAP: 1... .... X’80’ UVPPCAP PRIORITY CAP .... ...1 X’01’[...]

600 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Cro ss Reference Name Len Offset Va l u e UVPCIM - 01 UVPCLIP - 02 UVPFLAG1 000001 01 UVPFLAG2 000001 02 UVPF1ACT - 80 UVPF1AUT - 20 UVPF1LNK - 10 UVPF1ONL - 08 UVPF1REC - 40 UVPF2CLN - 10 UVPF2DRA - 40 UVPF2EJT - 20 UVPF2ENT - 80 UVPF2IDL - 08 UVPHOST 000008 0E UVPHOSTI 000001[...]

Appendix C. Reco rd Formats 601 1st ed., 6/30/04 - 312579601 UVP TWSTD - 03 UVP TYPE 000001 33 UVP9740 - 05 Name Len Offset Va l u e[...]

602 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601[...]

Appendix D. Lo gg ing ACS Robotics Motio n 603 1st ed., 6/30/04 - 312579601 Appendix D . Log ging A CS Robotics Motion Overview StorageT ek provides a way to monitor the reliability of ACS ro botics motion. This appendix describes what inform ation is logged and how th at information is logged. Inf ormation Being Logged StorageT ek logs robotic mot[...]

604 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 P ermanent Motion Err o r s Each time a permanent motion failure occurs, co mplete information c oncerning the failure is logged. A permanent error is counted against any motion which causes a Mount, DISMount, Swap, MOV e, Catalog, or VIew co mmand to fail in such a way that us[...]

Appendix D. Lo gg ing ACS Robotics Motio n 605 1st ed., 6/30/04 - 312579601 How Inf ormation is Log ged The HSC periodicall y retrieves the statistics for robo tics motions begun and tempo rary errors from the LMU. This information is lo gged to SYS1.LOGREC as software errors as shown in the T able 67. This record is a valid ‘ ‘Initiated and T [...]

606 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 46-46 LSM Configuration Fl ag 1st Byte X’80’ - LSM 0 exists if flag is on X’40’ - LSM 1 exists if flag is on X’20’ - LSM 2 exists if flag is on X’10’ - LSM 3 exists if flag is on X’08’ - LSM 4 exists if flag is on X’04’ - LSM 5 exists if flag is on X’0[...]

Appendix D. Lo gg ing ACS Robotics Motio n 607 1st ed., 6/30/04 - 312579601 The HSC also makes a log entry for each perman ent error, codes and indicates whether or not the errors are considered permanent errors. The record format used to lo g a hard fail to SYS1.LOGREC is shown in T able 68. This record is a valid ‘ ‘Motion Hard Fail Software [...]

608 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 These records, regardless of whether the hard fail indicator is turned on, are LLG1 records. T able 68 . Recor d Forma t for a Hard Failur e Motion Hard Fail Software Error Record BYTE # Description of Field 00-31 Standard HSC LOGREC header 00-00 X’40’ indicates so ftware d[...]

Appendix D. Lo gg ing ACS Robotics Motio n 609 1st ed., 6/30/04 - 312579601 Logging Interval When LMU 3.0 or 9315/9 330 1.0 µ-software is properly installed in the ACS, the HSC identifies hard fails in LLG1 records and records robotic motion and temporary error counts in LLG6 records written to SYS1.LOGREC. An LLG6 record is written to SYS1.LOGREC[...]

610 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 operations that do result in an error , only those that request ed robotic motions are logg ed as hard fails with the appropriate indicator set in the record. Errors that do not represent failed robotic motions ar e software errors. These should be analyzed and reported to Stor[...]

Appendix D. Lo gg ing ACS Robotics Motio n 611 1st ed., 6/30/04 - 312579601 LMU Response Codes The following tables contain a list of permanent error LMU resp on se codes wi th associated • descriptions • indications of whet her a console messag e is generated • indications of whether a LOGREC record is cut • indications of whether this res[...]

612 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 In v alid P arameter Er ror Codes: 0101 - 0127 T able 69. LMU Response Codes 0101 thru 0127 LMU Resp Response Description Con Msg LOG rec Mnt B Dmt C Swp D Mov E Cat J/K Vw X 0 1 0 1 B a d p r i m a r y L S M M L HHHHHH 0102 Bad secondary LSM M L H H H H H H 0105 Undefined op t[...]

Appendix D. Lo gg ing ACS Robotics Motio n 613 1st ed., 6/30/04 - 312579601 Configuration Erro r Codes: 0201 - 0203 CAP Pr ocedural Er ror Codes: 0301 - 0310 T able 70. LMU Response Codes 0201 thru 0203 LMU Resp Response Description Con Msg LOG rec Mnt B Dmt C Swp D Mov E Cat J/K Vw X 0201 LSM is not in static configura tion M L H H H H H H 0202 Dr[...]

614 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 General Procedural Err o r Codes: 0401 - 0427 T able 72. LMU Response Codes 0401 thru 0427 LMU Resp Response Description Con Msg LOG rec Mnt B Dmt C Swp D Mov E Cat J/K Vw X 0401 LSM not ready - - r r r r r r if unlabeled or bypass label M - r r r r r r if not V AR Y and LSM of[...]

Appendix D. Lo gg ing ACS Robotics Motio n 615 1st ed., 6/30/04 - 312579601 LMU LAN Interface Er r or Codes: 0501 - 0512 0426 Drive not rewound M L + r - - HHH 0427 Cartridge not mo unted M L H- - HHH T able 73. LMU Response Codes 0501 thru 0512 LMU Resp Response Description Con Msg LOG rec Mnt B Dmt C Swp D Mov E Cat J/K Vw X 0501 Transmissi on re[...]

616 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 LMU Logical Error Codes: 0601 - 0620 T able 74. LMU Response Codes 0601 thru 0620 LMU Resp Response Description Con Msg LOG rec Mnt B Dmt C Swp D Mov E Cat J/K Vw X 0601 Unknown allocation request M L H H H H H H 0602 Bad qualifier byte 0 M L H H H H H H 0603 Bad qualifier byte[...]

Appendix D. Lo gg ing ACS Robotics Motio n 617 1st ed., 6/30/04 - 312579601 LSM Robotics Erro r Codes: 0701 - 0718 T able 75. LMU Response Codes 0701 thru 0718 LMU Resp Response Description Con Msg LOG rec Mnt B Dmt C Swp D Mov E Cat J/K Vw X 0701 Arm not operational M L H H H H H H 0702 Hand not operational M L H H H H H H 0703 P TP not operationa[...]

618 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 LSM Hard ware Err or Codes: 0801 - 0809 LSM Logical Error Codes: 0901 - 0977 T able 76. LMU Response Codes 0801 thru 0809 LMU Resp Response Description Con Msg LOG rec Mnt B Dmt C Swp D Mov E Cat J/K Vw X 0801 LSM didn’t respond to request M L HHHHHH 0804 CAP unlock solenoid [...]

Appendix D. Lo gg ing ACS Robotics Motio n 619 1st ed., 6/30/04 - 312579601 0921 Bad panel, row , or column M L H H H H H H 0922 Arm currently reserved M L H H H H 0923 CAP currently reserved M L H H H H H H 0924 First Master Pass-Thru-Port reserved M L H H H H H H 0925 Second Master Pass-Thru-Port reserved M L H H H H H H 0926 Playground currently[...]

620 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Drive Error Codes: 1001 - 1011 Undefined Response Code 0976 Can’t rewind M L H - - H H H 0977 Can’t unload M L - - - H H H 0978 Drive cannot honor write protected M L H H H H H H 0979 Drive currently reserved M L H H H H H H T able 78. LMU Response Codes 1001 thru 1011 LMU [...]

Appendix E. Remote-linked Libraries 621 1st ed., 6/30/04 - 312579601 Appendix E. Remote-linked Libraries Overview This appendix contains illust rations of configurations fo r remote-linked libraries. In addition, programming and opera tional considerations for each of t he configurations are presented.[...]

622 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Configuration 1 This configuration consists of one ACS remote-linked to one CPU. The primary , secondary , and standby contro l data sets all run on the one CPU. HSC OPERATING SYSTEM CH EXT CH EXT CH EXT ACS 0 LEGEND: = CHANNEL EXTENDER = OPTIONAL C29323 MANUAL TRANSPORTS SECON[...]

Appendix E. Remote-linked Libraries 623 1st ed., 6/30/04 - 312579601 Configuration 2 This configuration co nsists of one ACS remote-linke d to one CPU. The primary , secondary , and standby control data sets all run on the one CPU. Multiple Clients on a Local Area Network C51 183 Primary Control Data Set Data Path ESCD TCP/IP Path for Robotic Contr[...]

624 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Configuration 3 This configuration consists of one ACS local to one CPU that is remote-linked to another CPU with one ACS local to it. The primary and secondary control data sets run on separate SSDs each attached to separate CPUs. The standby control data set can be attached t[...]

Appendix E. Remote-linked Libraries 625 1st ed., 6/30/04 - 312579601 Configuration 4 This configuration cons ists of one ACS local to one CPU that is remote-linked to another CPU with one ACS local to it. The primary and secondary control data sets run on separate SSDs each att ached to separate CPUs. LEGEND: = CHANNEL EXTENDER = OPTIONAL CH EXT LM[...]

626 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Configuration 5 This configuration consists of one ACS local to one CPU that is remote-linked to another CPU with one ACS local to it. In addition, a third ACS is remote-linked to both CPUs. The primary and secondary control data set s run on separate SSDs each attached to sepa[...]

Appendix E. Remote-linked Libraries 627 1st ed., 6/30/04 - 312579601 Programming and Operat ional Considerations The following are program ming and operationa l co nsiderations that shou ld be observed if you have libraries resemblin g any of the illustrated conf igurations. Th e HSC permits operation of these library configurations prov ided that [...]

628 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 The original primary control data set continue s to operate for ACS0 only . As the library operates, any updates occurring to either cont rol data set after the link was severed causes the data sets to be unsynchronized. It is a di fficult task to resynchr onize t he data for b[...]

Appendix F. Batch Ap plication Program I nterfa ce (API) 629 1st ed., 6/30/04 - 312579601 Appendix F . Batch Application Pr ogram Interface (API) Overview The Batch API allows you to retrieve CDS information in batch mode. The CDS specified as input to the request does not have to be active nor does it have to be currently referenced by the HSC add[...]

630 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 The SLSUREQM macro maps the SLSUREQ reply he ader , parameter list, and return code values. Refer to “SLSUREQM Macro” on page 64 5 to see the record layout. Reply header length is defined in S LSURE QM, and library element record lengths are defined in the SLUV x DA T macro[...]

Appendix F. Batch Ap plication Program I nterfa ce (API) 631 1st ed., 6/30/04 - 312579601 • Register (15): stores QCDS request return codes. Syntax The syntax for the QCDS request is: P arameters label label indicates a user-defined assembler labe l. REQUEST request indicates to access a library element record area. OPEN specifies to open a libra[...]

632 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 HST specifies the host info rmation record area MVC specifies the Multi-Volume Cartridge record area ST A specifies the station record area VO L specifies the volume record area VTV specifies the Virtual Tape Volume record area This parameter is required. BUFFER buffer indicate[...]

Appendix F. Batch Ap plication Program I nterfa ce (API) 633 1st ed., 6/30/04 - 312579601 Notes: 1. A CDS must be preallocated to ddname in the JCL or in a SVC 99 dynamic allocation request before issuing QCDS requests. 2. The input CDS does not need to be active or referenced by the HSC address space. 3. QCDS allows for multiple input CDSs, as lon[...]

634 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Return Codes Invalid SLSUREQ requests and QC DS access requests provide retu rn codes in register 15. T able 80 shows the list of return codes. T able 81. Batch API Return Codes Return Field Name: Decima l V alue and Description: Invalid SLSUREQ Requests: SLURRQPL 1 000 - SLSUR[...]

Appendix F. Batch Ap plication Program I nterfa ce (API) 635 1st ed., 6/30/04 - 312579601 Sample QCDS Requests The following QCDS program samples detail two different scenarios: • a request to open the current primary CDS • a request to process two library element record area types. Both of these examples can be found in the SAMPLIB data se t d[...]

636 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 QCDSVTV TITLE 'QCDS Read current pr imary CDS VTV record area' * * * Function: Use QCDS to automaticall y allocate and Open the * current primary CDS. Issue SLSUREQ QCDS requests to * read all the VTV rec ords. * * Attributes: * 1. Problem state, user key. * 2. Non-AP[...]

Appendix F. Batch Ap plication Program I nterfa ce (API) 637 1st ed., 6/30/04 - 312579601 MVC WKFLATDD(KFLATDDL),KF LATDD Initialize the working LA R4,WKFLATDD stora ge version of the DCB from the OPEN ((R4),(OUTPUT)) copy in the constants area. * * Use QCDS OPEN to automatically all ocate the current primary CDS * and open the VTV record area: * O[...]

638 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 * Inner loop - process each VTV reco rd in the response area: * VOLPROC DS 0H Over all VTV records in reply: * ... process VTV record he re ... PUT WKFLATDD,((R8)) LA R8,VDRECLEN(,R8) Poin ter to next VTV record BCT R9,VOLPROC Proc ess next VTV record CHECKEOA DS 0H Chec k for [...]

Appendix F. Batch Ap plication Program I nterfa ce (API) 639 1st ed., 6/30/04 - 312579601 * Constants: * QCDSMODL SLSUREQ MF=L SLSU REQ plist model QCDSMLEN EQU *-QCDSMODL Leng th of SLSUREQ plist model QCDSBLEN DC F'655360' QCDS READ response area buffer length KFLATDD DCB DDNAME=VDRECDAT,DSORG =PS,MACRF=(PM), + LRECL=VDRECLEN, + BLKSIZE[...]

640 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Sample 2 - Reading the A CS and DR V Recor d Areas T ogether This sample QCD S request reads two differ ent CDS record area s (ACS and DR V), alternating between the two. The job step JCL must include a DDNAME statement for the input CDS DDname (MVS1CDS in this example).[...]

Appendix F. Batch Ap plication Program I nterfa ce (API) 641 1st ed., 6/30/04 - 312579601 QACSDRV TITLE ‘QCDS READ ACS AND DRI VE RECORD AREAS TOGETHER’ * * QACSDRV ! QCDS READ ACS AND D RIVE RECORD AREAS TOGETHER. * * FUNCTION: USE SEPARATE RESPONSE AR EAS TO READ THE ACS AND DRV * RECORD AREAS IN AN ALTER NATING FASHION. * EACH RESPONSE AREA [...]

642 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 * * OPEN ACS AND DRIVE RECORD AREAS AN D MAP THE RESPONSE AREAS: * OPEN DS 0H OPEN ACS AND DRIVE RECORD AREAS: SLSUREQ QCDS, OPEN ACS RECORD AREA REQUEST=OPEN, TYPE=ACS, TOKEN=WKTOK, DDNAME=QCDSDD, UCALADR=WKUCAL, MF=(E,WKQCDS) SLSUREQ QCDS, OPEN DRIVE RECORD AREA REQUEST=OPEN,[...]

Appendix F. Batch Ap plication Program I nterfa ce (API) 643 1st ed., 6/30/04 - 312579601 * * CONDITIONALLY BRANCH TO CLOSE LABE L WHEN AN APPROPRIATE * LOOP TERMINATION CONDITION HAS BEE N SATISFIED (NOT SHOWN). * B PROCESS REPE AT MAIN PROCESSING LOOP * * CLOSE THE ACS AND DRIVE RECORD ARE AS: * CLOSE DS 0H CLOS E ACS AND DRIVE RECORD AREAS: SLSU[...]

644 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Output Description Each successful OPEN request returns th e name of the input CDS in the SLSUREQ parameter list (SLSUREQM field SLSUQDSN). Each successful READ request returns one or more library element records in the user-designated response area. Use the SLUR DSECT in the S[...]

Appendix F. Batch Ap plication Program I nterfa ce (API) 645 1st ed., 6/30/04 - 312579601 SLSUREQM Macro The SLSUREQM mapping macro must be spec ified in any assembly that uses the SLSUREQ macro. Syntax P arameters PRO={NO|YES} Specifies whether the prol ogue should be generated (YES) or not (NO). The default is NO. label SLSUREQM PRO= NO YES[...]

646 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Batch API Mapping (S LSUREQM) Macr o T able 83. SLSUREQM Record Format Dec Hex T ype Len gth Label Descript ion MACRO: SLSUREQM - BA TCH API USER INTERF ACE MAPPING MACRO FUNCTION: THIS MACRO MAPS THE SLSUCAL P ARAMETER LIST , REPL Y HEADER, AND RETURN CODES. 0 (0) STRUCTURE SL[...]

Appendix F. Batch Ap plication Program I nterfa ce (API) 647 1st ed., 6/30/04 - 312579601 12 (C) A-ADDR 4 SLSUQCDB QCDS RESPONSE AREA BUFFER ADDRESS 16 (10) SIGNED-FWORD 4 SLSUQCDL QCDS RESPONSE AREA BUFFER LENG TH 20 (14) A-ADDR 4 SLSUQCDD QCDS INPUT CDS DDNAME POINTER 24 (18) CHARACTER 44 SLSUQDSN QCDS INPUT CDS DA T A SET NAME 68 (44) CHARACTER [...]

648 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 12 (C) SIGNED-FWORD 4 SLURQCDO OFFSET T O QCDS LIBRAR Y ELEMENT RECORD SECTION FROM ST AR T OF REPL Y HEADER . QCDS OPEN RETURN CODES: 0 (00) CONST SLUROPOK RECORD AREA W AS OPENED SUCCESSFULL Y . 4 (04) CONST SLUROP AO OPEN F AILED - A TTEMP T TO OPEN A RECORD AREA THA T IS AL[...]

Appendix F. Batch Ap plication Program I nterfa ce (API) 649 1st ed., 6/30/04 - 312579601 4 (04) CONST SLURRDEA READ SUCCEEDED - ON E OR MORE RECORDS WERE TRANSFERRED TO THE RESPONSE AREA AND NO ADDITIONAL RECORDS CAN BE READ FROM THE ASSOCIA TED RECORD AREA. 8 (08) CONST SLURRDIT READ F AILED - INV ALID TOK EN V A LU E . 12 (0C) CONST SLURRDRA REA[...]

650 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 16 (10) CONST SLURCLIO CLOSE F AILED - I/O ERROR WHILE ACCESSING TH E ASSOCIA TED CDS. 16 (10) LENG TH SLURRHLN LENG TH OF REPL Y HEADER. 16 (10) AREA 4 SLURFRS ST AR T OF V ARIABLE-LENG TH FORMA TTED RECORD SEGMENT . T able 83 . SLSUREQM Recor d For mat (Continu ed) Dec Hex T [...]

Appendix F. Batch Ap plication Program I nterfa ce (API) 651 1st ed., 6/30/04 - 312579601 Cro ss Reference Name Len Offset Va l u e SLSUACSA - 00 SLSUARAN - 0A SLSUCAP A - 01 SLSUCDSA - 02 SLSUCFGA - 03 SLSUDR V A - 04 SLSUHDR 000004 00 SLSUHST A - 05 SLSUID - ‘CV AL ’ SLSULN - 148 SLSUMVCA - 08 SLSUQCDA 000001 07 SLSUQCDB 000004 0C SLSUQCDC - [...]

652 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SLURCLOK - 00 SLURCLRA - 0C SLURFRS 000004 10 SLURHDR 000004 00 SLURHSCV 000002 04 SLURID - ‘CV AL ’ SLUROP AO - 04 SLUROPDA - 1C SLUROPDD - 14 SLUROPDM - 20 SLUROPIO - 10 SLUROPIT - 08 SLUROPNA - 18 SLUROPOK - 00 SLUROPRA - 0C SLURQCDN 000004 08 SLURQCDO 000004 0C SLURQCR [...]

Appendix F. Batch Ap plication Program I nterfa ce (API) 653 1st ed., 6/30/04 - 312579601[...]

654 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601[...]

Glossary 65 5 1st ed., 6/30/04 - 312579601 Glossary T erms are defined as they are used in the text. If you cannot find a term here, check the index. A AC— Alternating current. access method— A te chnique fo r moving data between processor storage and I/O devices. ACS— See Automated Cartridge System. ACSid— An ACSid ( acs-id ) is a hexadeci[...]

1st ed., 6/30/04 - 312579601 656 VM/HSC 6.0 System Programmer’s Guide CAPid— A CAPid uniquely defines the location of a CAP by the LSM on which it resides. A CAPid is of the form AA:LL:CC where AA is the ACSid (00-FF hexadecimal), LL is the LSM number (00-17 hexadecimal), an d CC is the CAP number . Some commands and utilities perm it an abbrev[...]

Glossary 65 7 1st ed., 6/30/04 - 312579601 control data set recovery area— A portion of the CDS reserved for maintain ing integrity for updates that af fect multiple CDS blocks. control data set subfile— A portion of the CDS consisting of Data Blocks and Po inter Blocks containing related information. Control Unit (CU)— (1) A microprocessor-b[...]

1st ed., 6/30/04 - 312579601 658 VM/HSC 6.0 System Programmer’s Guide device group— A subset of the eligible devices. Device groups are defined by esoteric unit names but also may be created implicitly if co mmon devices exist in different device groups. device number— A four-digit hexadecimal num ber that uniquely identifies a devic e attach[...]

Glossary 65 9 1st ed., 6/30/04 - 312579601 ECCST— (1) A value that can be specified on the MEDia paramete r and that includes only enhanced capacity cartridge system tapes. (2) An alias of ECAR T . (3) See Enhanced Capaci ty Cartridge System T ape. EDL— See eligible device list. EDTGEN— Eligible Device T able Generation. A process used to rep[...]

1st ed., 6/30/04 - 312579601 660 VM/HSC 6.0 System Programmer’s Guide frozen panel— A panel to which cartridges cannot be moved. This restric tion includes allocating new cartridge locations on a panel as a result of: • a MOV e command, utility , or PGMI request • cartridge entry into the ACS • float, scratch dismount, or scratch redistri[...]

Glossary 66 1 1st ed., 6/30/04 - 312579601 programs at IPL execution. Devices running µ-software reload the func tional µ-software usually from a floppy diskette at IPL execution. initial value— A value assumed until explici tly changed. It must then be explicitly specified in another command to restore the initial value. An initial value for t[...]

1st ed., 6/30/04 - 312579601 662 VM/HSC 6.0 System Programmer’s Guide LMUPDEF— An HSC comm and used to load the definition data set that contains LMUP A TH control statements. load point— The beginning of the recording area on magnetic tape. loader— See Cartridge Scratch Loader . Local Area Network (LAN)— A computer network in which devic[...]

Glossary 66 3 1st ed., 6/30/04 - 312579601 media capa city— The amount of data that can be contained on storage media and expressed in bytes of data. media mismatch— A condition that occurs when the media value defined in a VOLA TTR control statement does not match the media value recorded in the CDS V AR record. micro-software— See µ-softwa[...]

1st ed., 6/30/04 - 312579601 664 VM/HSC 6.0 System Programmer’s Guide primary CDS— The active control data set. It contains the inventory of all cartridges in the library , the library configuration, information about library hardware and resource ow nership across multiple processors, and serves as a vehicle of communic ation between HSCs runn[...]

Glossary 66 5 1st ed., 6/30/04 - 312579601 problem impacts operations. Customers can set maintenance thre shold levels. servo— A device that uses feedback from a sensing element to control mechanical motion. Shared Tape Allocation Manager (STAM)— Third-party software by Computer Associates International, Inc. Silverton— See 4490 Cartridge Sub[...]

1st ed., 6/30/04 - 312579601 666 VM/HSC 6.0 System Programmer’s Guide specified type of 9840 cartridge or recording technique. STK1R can be abbreviated as R. STK1U— V alue that can be specified on the MEDia parameter and includ es only the specified type of 9840 cleaning cartridge. STK1U can be abbreviated as U. STK2— A generic value that can[...]

Glossary 66 7 1st ed., 6/30/04 - 312579601 See also Cartridge Access Port, standard CAP , enhanced CAP , priority CAP , W olfCreek CAP , or W olfCreek optional CAP . TP— T ape-to-Print. transaction— A short series of actions with the control data set. These actions are usually related to a specific function (e.g., Mount, ENter). transport— An[...]

1st ed., 6/30/04 - 312579601 668 VM/HSC 6.0 System Programmer’s Guide available in 500, 750, an d 1000 cartridge capacities (model numbers 936 0-050, 9360-075, an d 9360-100, respectively). W olfCreek LS Ms can be connected by pass-thru ports to 4410, 9310 , or other W olfCreek LSMs. WolfCreek CAP— The standard W olfCreek CAP contains a 20-cell[...]

Glossary 66 9 1st ed., 6/30/04 - 312579601 4490 Cartridge Subsystem— Cartridge tape transports that provide read/write capability f or 36-track recording format and extended capacity tape. 4490 transports can also read data recorded in 18-track format. The S tor ageT ek 4490 Cartridge Subsystem is equivalent to a 3490E d evice. 8500 library — S[...]

1st ed., 6/30/04 - 312579601 670 VM/HSC 6.0 System Programmer’s Guide[...]

Index 671 1st ed., 6/30/04 - 312579601 Inde x Numerics 4480 Cartridge Subs ystem, defined 66 8 4490 Cartridge Subs ystem, defined 66 9 9490 Cartridge Subs ystem, defined 66 9 9490EE Cartridge S ubsystem, defined 669 9840 Cartridge Subs ystem, defined 66 9 A abend codes HSC 347 SCP 347 abnormal mounts/dismounts 35 access method, defined 655 ACS See [...]

672 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 backup, CDS 170 Base service leve l, description 21 Batch Applicat ion Program Interface (API) overview 82 , 629 QCDS request addresses and registers 630 function 629 invoking 629 output description 644 programming considerations 633 return codes 634 sample requests 635 syntax [...]

Index 673 1st ed., 6/30/04 - 312579601 control data set defin ition control stat ement 448 control statement c ontinuation conventions 86 , 107 , 439 control statements CDS Definition (CDSDEF) 87 continuation 86 , 107 , 439 EXECParm 90 Journal Definition (JRNDEF) 92 License Key Definition (LKEYDEF) 94 License Key Information (LKEYINFO) 96 LKEYINFO [...]

674 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 JCL example 238 JCL requirements 236 output description 238 parameters 236 prerequisites 236 syntax 236 , 458 disconnected m ode, defined 658 dismount abnormal 35 processing 33 , 34 DISMount command 467 Dismount parameter 480 Display command 38 4 , 468 DOMed, defi ned 658 DRAin[...]

Index 675 1st ed., 6/30/04 - 312579601 Scratch Subpool control statement 102 SCRPDEF command and control stat ement 117 selective audit 1 ACS, 2 LSMs w/CAPid, JCL for 208 with panel/dis crepancy list, JCL for 208 TAPEREQ control stat ement 132 TREQDEF control statem ent 135 Unit Attribute Definition ( UNITDEF) control statemen t 142 UNITATTR contro[...]

676 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 setting 417 I Improved Cartridge Recording Capability (ICRC) , defined 660 Index, defined 660 INISH deck, defined 66 0 Initial Microprogram Load (IML), defined 660 Initial Program Load (IPL), defined 660 initial value, defined 661 input stack, defined 661 installation functions[...]

Index 677 1st ed., 6/30/04 - 312579601 MONITOR 478 MOVe 481 OPTion 482 RECover 482 RELease 482 SENter 483 SRVlev 483 STOPMN 483 SWitch 483 TRace 484 Vary 484 VIew 485 Warn 486 Library Control Unit (LCU), defined 661 Library Management Unit (LMU) defined 661 dynamic network connections to TCP/IP 70 LMU LAN interface error codes (0501-0512) 615 opera[...]

678 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 SLSSCAPJ, SMF CAP Eject Record 508 SLSSCAPN, SMF CAP Enter Record 509 SLSSDJLR, LOGREC Database/Journaling 553 SLSSFHDR, SMF Record Header 501 SLSSHLG1, LOGREC Host Communications Format 559 SLSSLHDR, LOGREC Header Layout 526 SLSSLLG1, LOGREC LMU Driver Format 535 SLSSLLG2, LOG[...]

Index 679 1st ed., 6/30/04 - 312579601 command-name 468 COMMPath 468 comp-list 484 comp-name 484 dataset.nam e 111 , 116 DDname 484 Defer 466 DELete 467 devaddr 467 , 479 dev-id 466 dev-list 466 dev-range 466 DIAGScan 206 Dialog 482 DISCmsg 482 Dismount 480 DRive 485 DSN 111 , 116 DSn 466 DUmp 484 EJctauto 480 EJect 476 EJLimit 482 EMPTYCel 206 Ena[...]

680 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 Journal Definition (JRNDEF) 92 License Key Defi nition (LKEYDEF) 94 License Key Information (LKEYINFO) 96 options 84 overview 83 processing 84 Reconfiguration CDS Definition (RECDEF) c ontrol statement 98 Scratch Subpool 100 pass-thru reduction 422 scheduled 423 unavoidable 423[...]

Index 681 1st ed., 6/30/04 - 312579601 SLUVHDAT, Flat File Host Information DSECT 574 SLUVIDAT, Flat File CDS Information DSECT 577 SLUVPDAT, Batch API CA P Information DSECT 598 SLUVSDAT, Flat File AC S Station Address DSECT 580 SLUVVDAT, Flat File Vo lume Data DSECT 582 RECover Host command 482 recovery functions 54 recovery functions 58 REcovery[...]

682 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 device numbers for drives 302 function 300 invoking 317 JCL requirements 316 new host parameters LIKEHOST 310 NEWHOST 310 output description 319 overview 299 parameters 304 LIKEHOST 310 NEWHOST 310 Set Cleaning Prefix 305 Set Delete Disposition 307 Set Device Numb ers for Drive[...]

Index 683 1st ed., 6/30/04 - 312579601 SRVlev command syntax 483 stand-alone utilities 185 standard (4410) LSM, defined 665 standard CAP, defined 665 standby CDS, defined 665 standby LMU, defined 665 standby, defined 665 station, defined 665 Stop Monitoring (STOPMN) command 48 3 storage class, defined 666 group, defined 666 supervisor call an d abn[...]

684 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601 T9840C Cartridge S ubsystem, defined 669 T9940A Cartridge S ubsystem, defined 669 T9940B Cartridge S ubsystem, defined 669 Tape Management Interfa ce (TMI), description 81 TAPEREQ control stat ement disabling 119 example 132 overview 118 parameters 123 PROGram/PGMname 124 synta[...]

Index 685 1st ed., 6/30/04 - 312579601 CP and CMS 6 operators and utility users 9 overview 6 SCP 7 tape management system (TMS) 9 VOLDEF command and control statement examples 112 , 156 VOLSER defined 667 ranges and lists 436 volume defined 667 specifying 143 Volume Attribute (VOLAT TR) control stat ement disabling 144 examples 153 overview 143 par[...]

686 VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 312579601[...]

[...]

Printed in U.S.A.[...]