592VM/HSC 6.0 System Programmer’s Guide

Name	Len	Offset
Name	Len	Value
		Value
VOLSPNLN	000001	03
VOLSPNON	-	‘CVAL’
VOLSPNSL	-	‘CVAL’
VOLSPSL	-	‘CVAL’
VOLSRCE	000006	7E
VOLSROWN	000001	04
VOLSTYPE	000001	00
VOLTDINS	000004	38
VOLTDMNT	000004	40
VOLTDSEL	000004	3C
VOLTMINS	000008	4C
VOLTMMNT	000008	6C
VOLTMSEL	000008	5C

592VM/HSC 6.0 System Programmer’s Guide

1st ed., 6/30/04 - 312579601

Page 622

Image 622

StorageTek manual 592VM/HSC 6.0 System Programmer’s Guide

Contents

312579601 System Programmer’s GuideRelease Host Software Component VM Implementation Limitations on Warranties and Liability Export Destination Control StatementRestricted Rights Proprietary Information Statement Host Software Component for Document EffectivityDoc Kit Number Document Effectivity ivVM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Preface ContentsWhat’s New With This Release? xxvii Matching VOLATTR and TAPEREQ Statements Chapter 4. Utility Functions SCP Environment Invoking the BACKup Utility Utility Name Page Chapter 6. Performance Considerations Page How to Specify a CAPid Reconfiguration utility Appendix B. CP Commands and DIAGNOSE Codes Appendix C. Record Formats Appendix D. Logging ACS Robotics Motion Glossary Appendix E. Remote-linkedLibrariesIndex Figures Figure Tables Table 28. Performance Parameters Controlled by PARMLIB Control Statements Table 67. Format for Total Motions and Temporary Error Counts xxivVM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Installation Guide What’s New With This Release?Installation Guide Installation Guide System Programmer’s Guide Installation GuideSystem Programmer’s Guide System Programmer’s Guide Intended Audience PrefaceScope Organization of This Guide How to Use This Guide Reader’s Comments References to HSC Product ReleasesRelated Publications StorageTek Product Support xxxVM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Chapter 1. System Description Automated Cartridge System Overview TimberWolf 9740 10-cellremovable magazine or 14-cellpermanent rack Host Software Component Overview HSC Subsystem Components HSC Architecture CONTROL APPLICATIONSCOMMON SERVERS VM Environment VM Operating System CP and CMS Device Management System Control Program SCPStorage Management File Management Processor Management Task ManagementJob Management Communication Host Software Component HSC Virtual Machine ConfigurationTask Recovery/Termination Tape Management System TMS HSC and Automated Cartridge System Interaction 10VM/HSC 6.0 System Programmer’s Guide Figure 2. Virtual Machine Relationships Chapter 1. System Description Figure 3. Shared Library Data Sets 12VM/HSC 6.0 System Programmer’s Guide Automated Mount Automated Dismount 14VM/HSC 6.0 System Programmer’s Guide Dual LMU Environment Utilities User Control of HSC FunctionsMacros PARMLIB Control Statements Commands 18VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Overview of HSC Functions Chapter 2. Host Software Component FunctionsAutomatic Functions of the HSC Installation Functions Description of Base Service Level HSC Service LevelsInitialization/Termination Functions Description of Full Service Level Base CommandService Level Execution Full Base Service Level ExecutionUtility Full Displaying/Setting Service Level Starting the HSC Subsystem at Base Service Level 26VM/HSC 6.0 System Programmer’s Guide Media Type and Recording Technique Processing1st ed., 6/30/04 - MEDIA TYPES MEDia and RECtech ParametersRECORDING TECHNIQUES MODel Model ParameterResulting RECtech Matching VOLATTR and TAPEREQ Statements Precedence of VOLATTR and TAPEREQ Statements Specific Volume RequestsNonspecific Volume Requests Scratch Selection How To Resolve Scratch Shortages •Standard and 36track •Long and 36track Mount Processing for Specific Volumes Mount/Dismount Functions Mount Processing for Scratch Volumes Dismount Processing for Library Volumes Abnormal Mounts/Dismounts Virtual Thumbwheel VTW HSC Mount Command SupportExample of Mount Command with Readonly Operand Tape Management Interface Automated Tape Transport Cleaning Tape Transport CleaningActivating Automated Cleaning Notes Identifying Cleaning CartridgesNotes Over-use Over-limitand Spent Cleaning Cartridges Managing Over-useCleaning Cartridges Managing Cleaning Cartridges Manual Tape Transport Cleaning 42VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Volume/Cell Control Functions Moving Volumes within the Library Scratch Subpool Management Scratch Threshold Task Restart Cartridge Access Port CAP Processing Functions Entering Cartridges into the Library CAP Mode Considerations Ejecting Cartridges from the LibraryCAP Exception Processing Releasing an Allocated CAP 48VM/HSC 6.0 System Programmer’s Guide Using Multiple CDS Copies Near Continuous Operations Automatic Update of LSM from 4410 to Automatic Recognition of Configuration ChangesRun-timeRecognition of 9740 CAP Configuration Defining Planned ACSs with no Stations Changing Panels To remove cartridges from rows on panels to facilitate hardware e.g., cabling changes Renaming/Relocating a CDS - Scenarios Using CDS Rename/Relocate/ExpandCDs Command Renaming a CDS Copy CDS ENABLE DSNACS.DBASENEW NEWLOC Relocating an Uncataloged CDS CopyExpanding a CDS - Scenario CDS EXPAND 56VM/HSC 6.0 System Programmer’s Guide Swapping Library Transports - New Model Types Common Recovery Functions Control Data Set Recovery User Control of Control Data Sets Control Data Set Recovery TechniquesAllocation of Control Data Sets Dynamic Enable/Disable of Control Data Sets 4. Issue the command Figure 5. HSC Command Functions Overview Command Functions62VM/HSC 6.0 System Programmer’s Guide Controlling CAP Operating Mode Controlling LSM Operating ModeViewing the Interior Components of an LSM •A VIew request is sent to the controlling LMU Figure 6. Utility Functions Overview Utility FunctionsChapter 2. Host Software Component Functions If the Master LMU Fails LMU Server FunctionsDual LMU Functionality If the Standby LMU Fails After an LMU Switch Occurs LMU Switchover MessagesHSC/LMU Software Combinations JCL to Add New Stations to an ACS Adding New Stations to an ACSNotes for the Example Reconstructing a LIBGEN Dynamic LMU Connection Recovery Maintenance RequirementsHSC Port Number Assignments Multiple TCP/IP Stack Implications 3270 to TCP/IP Transitioning Between 3270 and TCP/IPTCP/IP to Recovering TCP/IP Communications Communication Lost to Master LMU Operator Intervention - Single LMU ConfigurationOperator Intervention - Dual LMU Configuration Communication Lost to Standby LMU System Profile File ACS SYSPROF Configuring VM for TCP/IP SupportSystem Definition File ACS SYSDEF HSC Startup Job File ACS SLKJCL Commands to Format CMS Reserved Minidisk Initializing the LMUPATH Definition Data SetCommands to Format OS Minidisk Minidisk Statement for the LMUPATH Data Set FILE SYSPRINT DEV PRNT CLASS A LMUPATH Definition Data SetJOB SLSXUTIL SLUGENER /PARM RECCOPY FILE SYSUT2 DEV <vaddr> DSN <dsname> /FILE SYSUT1 Communication Functions Host-to-HostCommunications ServicesTypes of Communications Services Information Passed Between Hosts How Communications Services are Set or Changed Chapter 2. Host Software Component Functions Switching Communications Paths Tape Management Interface Software Requirements Batch Application Program Interface API 82VM/HSC 6.0 System Programmer’s Guide PARMLIB Control Statements OverviewDefining PARMLIB Control Statements CAP Preference Definition Processing PARMLIB Control StatementsOptions Offered by PARMLIB Control Statements Control Data Set Definition Journal Data Set Definition Communications Path DefinitionEXECPARM Control Definition License Key Information Option Control Control Statement Continuation ConventionsReconfiguration CDS Definition Scratch Subpool Control CDSDEF CDS Definition CDSDEF Control Statement Syntax Parameters CDSDEFControl Statement Name DISABLE CDSDEF ExampleDSN3SLS.DSTBY,VOL3HSC103,UNIT3503,+ DISABLE CDSDEF DSN1SLS.DBASE,VOL1HSC101,UNIT1501,+ Control Statement Name EXECParm EXECParm Control StatementSyntax EXECParm HOSTID EXECParm Control Statement - Command Prefix OffEXECParm Example Syntax JRNDEFJournal Definition JRNDEF Control Statement Control Statement Name FULL JRNDEFUNITx Abend Parameter Descriptions LKEYDEF LKEYDEF Command and Control StatementCommand Name dataset-name host-id LKEYDEFunitname UNIT customer-name LKEYINFOproduct-identifier nnnnnnn Examples license-key-stringLKEYINFO Control Statement Name RECDEFSyntax RECDEF RECDEF DSN1SLS.DBASE,VOL1HSC101,UNIT1501,+ RECDEFExample DSN2SLS.DBSEC,VOL2HSC102,UNIT2502 Control Statement Name SCRPOol Scratch Subpool Control StatementSyntax SCRPOol Notes SCRPOolRANGE LABEL SCRPOol Other Methods of Controlling Scratch SubpoolsExample Definition Data Set Control Statements LMU Parameter Definition OPTion TITLELMU Path Scratch Subpool Parameter Statement Definition Volume Attribute Defining LMU Network ConnectionsDefining Tape Request Attributes TAPEREQ Volume Attribute Definition Defining Volume Attributes VOLATTR Defining Unit Attributes UNITATTR Identifying the Definition Data Sets OPTION TITLE Control Statement Continuation Conventions Syntax LMUPATH LMUPATH Control StatementLMUPATH Usage Control Statement Name nnn.nnn.nnn.nnn LMUPATHlmu_hostname LMUADDR LMUPDEF LMUPDEF Command and Control Statement 110VM/HSC 6.0 System Programmer’s Guide Syntax LMUPDEFdataset.name Control Statement Name unitname LMUPDEFLoad the LMUPATH Parameters From YOUR.DSNMEMBER host-id Syntax OPTion TITLE OPTion TITLE Control Statementidentifying-string Control Statement Name 114VM/HSC 6.0 System Programmer’s Guide OPTion TITLEExample 1st ed., 6/30/04 - SCRPDEF Control Statement Name SCRPDEFSyntax Parameters unitname Load the SCRPOol Parameters From YOUR.DSNMEMBERSCRPDEF host-id TAPEREQ Tape Request TAPEREQ Control Statement TAPEREQ Usage TAPEREQ Disabling a TAPEREQ Definition TAPEREQ 120VM/HSC 6.0 System Programmer’s Guide Syntax TAPEREQTAPEREQ TAPEREQ Syntax continued122VM/HSC 6.0 System Programmer’s Guide TAPEREQ job-namestep-name Control Statement Name TAPEREQ program-nameDD-name PROGram or PGMname TAPEREQ retention-periodexpiration-date EXPDT Standard TAPEREQLONGItud ECART DD3A, DD3B, DD3C TAPEREQZCART STK1 Notes TAPEREQRECtech LONGItud TAPEREQ 36Atrack TAPEREQ STK1RC TAPEREQ subpool-name4490 Example Set Tape Request AttributesTAPEREQ 132VM/HSC 6.0 System Programmer’s Guide TREQDEF Control Statement Name TREQDEFSyntax Parameters unitname Load the TAPEREQ Parameters From YOUR.DSNMEMBERTREQDEF host-id Unit Attribute UNITATTR Control Statement UNITATTRUNITATTR Usage Syntax UNITATTRunit-address Control Statement Name UNITATTR MODel T9940B35 Specify Unit Attribute StatementsUNITATTR IGNORE UNITDEF 140VM/HSC 6.0 System Programmer’s Guide Control Statement Name UNITDEFSyntax Parameters Examples UNITDEFhost-id Specify a Data Set Containing UNITATTR Statements VOLATTR Volume Attribute VOLATTR Control StatementVOLATTR Usage VOLATTR Disabling a VOLATTR Definition144VM/HSC 6.0 System Programmer’s Guide Syntax This syntax diagram is continued on the next pageVOLATTR VOLATTR SERial volser Control Statement Name VOLATTRSyntax continued VOLATTR Parameters volser or vol-rangeor vol-listVOLATTR SERial VOLATTR Valid media types are DD3A, DD3B, DD3C, DD3D VOLATTRZCART STK1 RECtech VOLATTRSTK2P, STK2W LONGItud VOLATTR indicates a 9490 Timberline transport VOLATTR use-limitSTK1RC34 Example Set Volume AttributesVOLATTR VOLATTR SERIALL*,AA9* MEDIAECART VOLDEF 154VM/HSC 6.0 System Programmer’s Guide Control Statement Name VOLDEFSyntax Parameters unitname Load the VOLATTR Parameters From YOUR.DSNMEMBERVOLDEF host-id PARM Statement Parameters Creating an SLKJCL File for Starting the HSCPARM Statement Syntax SSYS RESETCOLD Dialog RECONFIGMember Both HSC Startup Job ACS SLKJCL Sample ACS SLKJCL File Example Notes Description of /FILE StatementSLSSYSXX Modifying LSMs Online Configuration MismatchesStarting HSC Execution Specifying CAP Preferences Multiple Hosts Startup Considerations 164VM/HSC 6.0 System Programmer’s Guide Starting the HSC Initializing the HSC to the Full Service Level Syntax for Initializing HSC to Full Service Level Initializing the HSC to the Base Service Level Syntax for Initializing HSC to Base Service Level 168VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Chapter 4. Utility Functions Overview of Library Utilities Function Selecting a UtilityUtility to Use Restore or recreate the library CDS Typical Use of Utilities Utility Syntax Conventions Control Statement Syntax ConventionsUtility Environmental Requirements ACS UTIL Exec CMS Environment ACSCMS EXEC SCP Environment ACSUTIL SLKJCL file JOB Statement JCL and Control StatementsSCP Batch Job Control Language JCL jobname COMM Statement PARM Statementparms comments ftype Submitting Jobsfname fmode Utility Control Statements Control Statements vs. JCL Utility Administrator SLUADMIN How to Invoke SLUADMIN Return Code How to Invoke Utility ProgramsSLUADMIN Program Return Codes Description Report Headings Reports Created by UtilitiesParameters Controlling Report Headings DATE=2YR Example of JCL Using Report Heading OptionsExample DATE=4YR Stand-AloneUtilities SLUACTV EXEC Activities Report UtilityActivities Report type PARM SLSSMF fname ftype fmodeActivities Report MIXED Parameters SyntaxUtility Name begin-date Activities Report end-dateend-time TODAY Output Description Invoking the Activities Report UtilityControl File Example Control File to Produce an Activities Report Activities Report Total Ave. time Activities Report% of all Ave. pass-thrus Earliest Usage NotesActivities Report Latest Activities Report •LSM operating statistics record, subtype 1, and ARM USE Activities ReportACS ID P-THRU Usage Notes Activities Report196VM/HSC 6.0 System Programmer’s Guide Chapter 4. Utility Functions Activities ReportFigure 9. Activities Report Utility Sample Output 1st ed., 6/30/04 - Audit Utility Audit Media Type Mismatch Conditions Audit How the AUDIt Utility Functions Actions Permitted During an AuditAudit Concurrent Audits Audit Syntax acs-idAudit Utility Name Audit lsm-listpanel-list PANel Audit row-listcolumn-list Notes cap-id Audit DIAGScan AuditEMPTYCel Notes ACSUTIL SLKJCL File JCL RequirementsInvoking the Audit Utility Audit JCL for Selective Audit 1 ACS, 2 LSMs, with CAPid JCL ExamplesJCL for Audit of Entire Library all ACSs Audit Audit JCL for Selective Audit of Diagnostic Cells OnlyJCL for Selective Audit of Empty Cells Output Description 210VM/HSC 6.0 System Programmer’s Guide AuditFigure 10. AUDIt Utility Sample Output 1st ed., 6/30/04 - Reasons for Running the BACKup Utility Backup UtilityBackup Prerequisites Backup How the BACKup Utility Functions Backup Backup Procedure Syntax BackupBACKup Utility Name Secondary BackupPrimary STandby Backup Restart SLSCNTL Backup JCL RequirementsSLSPRINT SLSCNTL2 Backup Invoking the BACKup Utility ACSUTIL SLKJCL File Run Backup Utility Backup JCL ExamplesJCL for Running Backup JCL for Running a Copy Backup Output Description Backup•the following data sets 4warning MESSAGES – Backup successful Backup•a condition code from backup processing Chapter 4. Utility Functions 222VM/HSC 6.0 System Programmer’s Guide BackupFigure 11. BACKup Utility Sample Output 1 of 1st ed., 6/30/04 - Chapter 4. Utility Functions BackupFigure 11. BACKup Utility Sample Output 2 of 1st ed., 6/30/04 - Related Utilities Backup How to Restart Backup224VM/HSC 6.0 System Programmer’s Guide How the Database Decompile Utility Functions Database Decompile LIBGEN UtilityDatabase Decompile Prerequisites Parameters Database Decompile SyntaxUtility Name JCL Requirements JCL for Database Decompile Invoking the Database Decompile UtilityJCL Example Database Decompile Label Database Decompile Output DescriptionDevice Description Chapter 4. Utility Functions Database Decompile1st ed., 6/30/04 - 230VM/HSC 6.0 System Programmer’s Guide Database Decompile1st ed., 6/30/04 - Chapter 4. Utility Functions Database Decompile1st ed., 6/30/04 - 232VM/HSC 6.0 System Programmer’s Guide Database Decompile1st ed., 6/30/04 - Chapter 4. Utility Functions Database Decompile1st ed., 6/30/04 - 234VM/HSC 6.0 System Programmer’s Guide Database Decompile1st ed., 6/30/04 - Chapter 4. Utility Functions Database Decompile1st ed., 6/30/04 - Reasons for Running the Directory Rebuild Utility Directory Rebuild UtilityDirectory Rebuild How the Directory Rebuild Utility Functions SLSCNTL, SLSCNTL2, SLSSTBY Directory RebuildInvoking the Database Decompile Utility SLSIN JCL for Directory Rebuild Directory Rebuild JCL ExampleOutput Description Eject Cartridge Eject Cartridge UtilitySyntax EJECt Eject CartridgeUtility Name Eject Method 2 continued count Eject Cartridge Parametersvol-list VOLser Eject Cartridge •CST •MEDIA1 •STD •1 •3480 Eject Cartridge Note: STK2P can be abbreviated to P Eject Cartridge indicates a 3490E-image9840 transport cap-list Eject Cartridge JCL Requirements Invoking the Eject Cartridge UtilityEject Cartridge ACSUTIL SLKJCL File JCL to Eject Five SD-3Scratch Cartridges JCL for Ejecting a Single VolumeJCL to Eject One STD Scratch Cartridge Eject Cartridge Figure 13. EJECt Cartridge Utility Sample Output Eject Cartridge Output Description248VM/HSC 6.0 System Programmer’s Guide CAP Operating Instructions Enter Cartridges UtilityEnter Cartridges Syntax JCL Requirements Invoking the Enter Cartridges UtilityEnter Cartridges SCRatch JCL Example JCL for Entering Cartridges in a CAPEnter Cartridges Output Description 252VM/HSC 6.0 System Programmer’s Guide Enter CartridgesFigure 14. Enter Cartridge Utility Sample Output 1st ed., 6/30/04 - Syntax Journal Offload UtilityJournal Offload Utility Name SLSOFF02 Invoking the Journal Offload UtilityJournal Offload SLSIN JCL for Offload of Journals Journal Offload JCL ExampleOutput Description 256VM/HSC 6.0 System Programmer’s Guide Journal OffloadFigure 15. Journal Offload Utility Sample Output 1st ed., 6/30/04 - Move Move UtilityMOVe Considerations Syntax lsm-idMove Utility Name row-list panelMove column-list Invoking the Move Utility Move JCL RequirementsACSUTIL SLKJCL File Move JCL Examples Move Several Volumes From an LSM to Another LSMOutput Description 262VM/HSC 6.0 System Programmer’s Guide MoveFigure 16. MOVe Utility Sample Output 1st ed., 6/30/04 - Syntax CMS Statement Performance Log Reblocker UtilityPerformance Log Reblocker Performance Log Reblocker utility Performance Log Reblocker JCL Requirements mvsnodePerformance Log Reblocker class Reconfiguration Reconfiguration UtilityReasons for Running the Reconfiguration Utility DASD Considerations in a VM-onlyEnvironment Considerations Before Running ReconfigurationReconfiguration Reconfiguration How the Reconfiguration Utility Functions268VM/HSC 6.0 System Programmer’s Guide Condition I/O ConsiderationsReconfiguration Number of I/Os Reconfiguration Running a Successful ReconfigurationMinimizing I/O Time Notes Reconfiguration 7.Log on to STKACS Reconfiguration Comment out any AUTOJOB statements Reconfiguration e. Copy the updated SYSPROF to the RUN-disk Reconfiguration q.Issue the following command Reconfiguration 17.Save ACS SYSPROF on the RUN-diskB Reasons for Running the RESTore Utility Restore UtilityRestore How the RESTore Utility Functions Utility Name RestoreRESTore Parameters Only RestoreJCL Requirements Short JCL Examples Restore Invoking the Restore UtilityACSUTIL SLKJCL File Restore JCL for RESTore with Journals AppliedJCL for RESTore with GENerate Only 280VM/HSC 6.0 System Programmer’s Guide Restore JCL for RESTore Journals and Output to SLSAUDITOutput Description 282VM/HSC 6.0 System Programmer’s Guide RestoreFigure 17. Restore Utility Sample Output 1st ed., 6/30/04 - How to Handle BACKup/RESTore Discrepancies Restore Scratch Redistribution Scratch Redistribution UtilityHow the Scratch Redistribution Utility Functions SCREdist Scratch Redistribution SyntaxUtility Name Chapter 4. Utility Functions acs-id Scratch Redistribution Parameterstolerance-value lsm-list Scratch Redistribution expnumlsm Scratch Redistribution indicates any Standard, ECART, or ZCART cartridge Scratch Redistribution indicates any T9840 cartridge indicates a device using helical recording Scratch Redistribution Scratch Redistribution indicates any T9940A transport JCL Examples Scratch Redistribution JCL RequirementsInvoking the Scratch Redistribution Utility ACSUTIL SLKJCL File JCL to Perform Scratch Redistribution JCL to Perform Scratch RedistributionScratch Redistribution JCL to Perform Scratch Redistribution Scratch Redistribution Output Description 294VM/HSC 6.0 System Programmer’s Guide Utility Names Scratch Update UtilitiesScratch Update SCRAtch utility JCL Requirements Scratch Update ParametersInvoking the Scratch Update Utilities vol-list JCL Example JCL to Scratch, Unscratch, and ReplaceScratch Update Output Description 298VM/HSC 6.0 System Programmer’s Guide Scratch UpdateFigure 19. Scratch Update Utilities Sample Output 1st ed., 6/30/04 - SET Utility Affected HSCs How the SET Utility FunctionsSET Option All Other HSCs Considerations Before Running the SET Utility Summary of SET Utility Options SET Option SET Utility Function and Location of Description Note: This syntax is continued on the next page Set SyntaxChapter 4. Utility Functions Utility Name SET ACS Esotericesoteric Parameters SET HSC Command Prefix SET Cleaning PrefixSET CLNPRFX PROCEDURE prefix Character Description SCRTCH SET Eject PasswordSET Delete Disposition NOSCRTCH SET Freeze Panel oldpswdFREEZE oldhost SET Host IDnewhost SET HSC Level SET New Host SET ENQ/DEQ/RESERVE QNAMEqname model-host esoteric SET Scratch Label TypeSET Device Numbers for Drives FORHOST addr0,...addr19 lsm-id Running SET SLIDRIVS With the HSC ActiveFORLSMID FORPANEL stat1,...,stat16 SET SLIDRIVS ProcedureSET LMU Station Address Numbers SLISTATN libtype SET Recovery TechniqueSET SMF Record Type FORACS SHADOW SET TCHNIQE PROCEDUREJCL Requirements BOTH Invoking the Set Utility ACSUTIL SLKJCL File Set JCL Examples JCL for Set Utility JCL for Multiple SET Statements Output Description Unselect Unselect UtilitySyntax Parameters Unselect Utility NameInvoking the Unselect Utility JCL Requirements JCL Example JCL to Unselect a VolumeUnselect Output Description Chapter 4. Utility Functions UnselectFigure 20. Unselect Utility Sample Output 1st ed., 6/30/04 Volume Report Utility Volume Report Media Type and Recording Technique Considerations Volume Report Volume Report •change the VOLATTR statements Volume Report Syntax Parameters Volume Report Utility Namevolser or vol-range or vol-list acs-id Volume Report SORT Volume Report INCLude NONMEDEQ Volume ReportMEDEQUAL NOEXTernal VOLDATA Volume ReportVOLIST CDSDATA SLSCNTL, SLSCNTL2, SLSSTBY JCL/Parameter File RequirementsVolume Report SLSPRINT vaddr JCL/Parameter File SyntaxSLSCNTL control.set.name SLSCDATA CMS only fn, ft, fmkeywords SLSSCRPL CMS only parameters SLSVA CMS onlyPARM JOB SCP only Parameter File Volume Report Invoking the Volume Report UtilitySLUVOLR EXEC CMS ACSUTIL SLKJCL File Volume Report JCL to Produce a Volume ReportJCL Example Media and Recording Technique Origin JCL to Produce a Volume Report for an MVS PDSReport Detail Lines Volume Report External Label Field Media Type Prefix CharactersErrant, Scratch, Selected Fields Cartridge Usability CLN USE Field Times Selected Field Volume Report TotalsSubpool ID Field Totals Reports Volume Report Flat Files Volume Report Chapter 4. Utility Functions Volume Report1st ed., 6/30/04 - 344VM/HSC 6.0 System Programmer’s Guide Volume Report1st ed., 6/30/04 - Chapter 4. Utility Functions Volume Report1st ed., 6/30/04 - 346VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - HSC Messages MessagesAbend Codes SCP Messages CP Trace Table Software Trace FacilitiesCCWTRACE TRACE Command Syntax VM CP Debug CommandsSCP SET TRACE Command SCP Internal Trace Table Master Trace Table Header Trace Table Entries DSP Trace Entry Code Query = IRT address IPARML IUCV Parameter ListTTEWORD1 TTEWORD2 = IPARML bytes IPARML for IUCV CONNECT to *BLOCKIO Inputs =target class 1=write; 2=read =flags type=2way IPARML for IUCV SEND to *BLOCKIOInputs =relative block number =data buffer address = target class IPARML for IUCV RECEIVEInputs = flags = IUCV message id IPARML for IUCV REPLYInputs = target class = name of virtual machine connected to IPARML for IUCV SEVERInputs Outputs IPRCODE IPTYPE IUCV Interrupt BufferInterrupt Type IPARML for Pending Connection Interrupt IPARML for Connection Complete Interrupt IPTYPE IPPATHID= IUCV path id = 03=severed, 04=quiesced, 05=resumed IPARML for Incoming Message Interrupt IPARML for Message Complete Interrupt SCP Trace Facility Diagnostic CapabilitiesError Recording Data Set Records Supervisor Call and Abnormal End Dumps SCP External Trace Facility SLUETRAC SCP Trace Formatter UtilityEXEC 368VM/HSC 6.0 System Programmer’s Guide infm infninft outfn 370VM/HSC 6.0 System Programmer’s Guide Supervisor Call SVC Functions1st ed., 6/30/04 - Decimal Refer to TableFunction SCP GTRACE Emulation The valid EID ranges are HSC Internal Trace Table Figure 23. HSC Internal Trace Table Example HSC TRACE Command Format of HSC GTRACE USR Records Setting Initialization Sequence Break-Points Diagnostic CommandsVM CP Commands SCP Debug Mode offset length Enabling the Diagnostic Subsystem SCP Diagnostic Subsystem Commands=DEBUG =DDICT =NODEBUGfieldname offset =HPERepname length address =WHEREepname Syntax Parameters HSC Diagnostic CommandsLIst Command data-structure size DISPLAY Commandaddress Dynamic Recovery of the Control Data Set CDS Recovery CapabilitiesControl Data Set Recovery 386VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Figure 24. Control Data Set Recovery Scheme Control Data Set Error Diagnostics Control Data Set Processes Control Data Set Integrity During Restore Detecting Mismatch of Control Data Sets Recommended Recovery Actions Information Required for StorageTek Diagnosis Dump Processing How to Request a DumpType of Dumps Supported What to do When a Dump Occurs Note Reason For Dump Load Dump and CONSLOG Onto Disk Move Problem Materials to TapeCall StorageTek Software Support Dump Analysis Using SLUIPCS VIEW CVT VIEW CCVT VIEW NUCON VIEW MTT SLUIPCS SCAN SubcommandsVIEW VIEW STORMAN VIEW LVT VIEW structname Data Structures Data Structures IHAASCB TRB SAVE AREA TRACEBACK EX EXECUTE CMS COMMANDFIND TTE TRACE TABLE ENTRY STAT STATUS WA WHERE ADDRESSWN WHERE NAME TASK FIND TASK Major SCP Data Relationships SLUIPCS PRINT Options 1st ed., 6/30/04 - Command, Message, Trace ProcessingFigure 25. Command, Message and Trace Processing NUCON X’10’ VECTPTR TRCTAB SCP Task/Job Data Relationships Diagnostic TechniquesSubsystem Data Relationships TKRBLIST Figure 26. SCP Task/Job Data RelationshipNUCON JBLOK PSAAOLD JBLTASK TBLOK PSATOLD RQBLOK NUCON CVT VECTPTR CVTJESCT Figure 27. Subsystem Data Relationships404VM/HSC 6.0 System Programmer’s Guide JESCT JESSSCT SSCT SSCTSCTA SSCTSSVT SSCT Find a Module Address, Given a Name Common Dump Analysis TasksFind a Module Plus Offset, Given an Address View an HSC or SCP Data Area Find the Failing Task Identify the Failing RoutineFind the Failing Request Block Find the LCT, LST, HST Save Area Trace BackFind the LVT Identify the Last Interrupt Event Examine an SDWA Gather Diagnostic MaterialsDiagnostic Materials Find IUCV Path Descriptors details of problem circumstances •STKACS abend Tape Format Tape Return How Library Activity Affects Library Performance Chapter 6. Performance ConsiderationsOverview Monitoring Library Activity and Performance Using the Activities Report UtilityHow Operators Control Library Performance Tape Volume Report ACS Daily Report Define CAP Preferences Redistribute Scratch Volumes in the LibraryMaintain Quantities of Scratch Cartridges 414VM/HSC 6.0 System Programmer’s Guide Operator Command Use SMF Records to Collect Performance DataUse PARMLIB to Define Static Parameters Performance Parameter Journal Definition Define High Dispatching Priority for the HSC Set High-Performance Host-to-HostCommunications Designation of Communication parameters Functioning of Host-to-HostCommunications418VM/HSC 6.0 System Programmer’s Guide Define Secondary and Standby Control Data Sets Limit View Time to Maintain High Performance How to Monitor Usage of the VIew Command Excessive Use of VIew Command Affects PerformanceAdvantages of Using the VIew Command Chapter 6. Performance Considerations 1st ed., 6/30/04 - Loading Cartridges Into the Library Reduce Pass-Thrus Scheduled Pass-Thrus Unavoidable Pass-ThrusUnnecessary Pass-Thrus Ways to Reduce Pass-ThruActivity Eject through the CAP closest to the cartridge Reduce Operator InterventionEnsure adequate free cells Redistribute cartridges during off-peaktimes Prefetch Enters ACSPROP EXECReduce Tape Transport Contention Avoid Crashing Test Systems Syntax Reduce Scheduling ContentionUsage Requirements Parameters Use Performance Log Reblocker to Format Data Use the Audit Utility Effectively Use LSMs as Scratch Loaders in a Mixed ACS Specifying Commands Commands Syntax ReferenceSyntax Flow Diagrams Variables Flow Lines Single Required Choice Single Optional Choice DefaultsRepeat Symbol Default Value Value2 Value3 432VM/HSC 6.0 System Programmer’s Guide Syntax Continuation FragmentsFragment 1st ed., 6/30/04 - Library Identification LSM Model 4410 and PowderHorn LSM Model How to Specify a CAPidCAPid Formats WolfCreek LSM Models 9360-050, 9360-075,and 00indicates one of the following Ranges And Lists 436VM/HSC 6.0 System Programmer’s Guide A00A0-A99A0 438VM/HSC 6.0 System Programmer’s Guide The control statement for each utility program consists of a command indicating the utility function followed by parameters, as applicable, in 80-character card-imagerecords. The standard syntax conventions for control statements are as follows Control Statement Syntax Conventions ZZZ000ZZZ999 SCRPOOL NAME=STD36,RANGEAAA000AAA999440VM/HSC 6.0 System Programmer’s Guide acs-id, lsm-id MEDia, RECtech, and MODel ParametersMODel, and RECtech parameters acs-id, lsm-id Mount VOLATTR acs-id, lsm-id 444VM/HSC 6.0 System Programmer’s Guide LIBGEN Macros1st ed., 6/30/04 - SLIDLIST macro SLIACS macroSLIALIST macro SLIDRIVS macros 446VM/HSC 6.0 System Programmer’s Guide SLILIBRY macro1st ed., 6/30/04 - SLISTATN macro SLILSM macroSLIRCVRY macro SLIRCVRY Journal Definition JRNDEF control statement HSC Control StatementsEXECParm control statement 448VM/HSC 6.0 System Programmer’s Guide LMUPATH control statement LKEYDEF command and control statementLKEYINFO control statement VOLumevolser 450VM/HSC 6.0 System Programmer’s Guide OPTion control statementScratch Subpool SCRPOol control statement 1st ed., 6/30/04 - Tape Request TAPEREQ control statement Tape Request TAPEREQ control statement continued 452VM/HSC 6.0 System Programmer’s Guide Unit Attribute UNITATTR control statement 454VM/HSC 6.0 System Programmer’s Guide Volume Attribute VOLATTR control statement1st ed., 6/30/04 - STK1RA STK1RA34 STK1RA35 STK1RB STK1RB34 STK1RB35 456VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - AUDIt utility UtilitiesACTIvities Report utility ACSacs-id Directory Rebuild DIRBLD utility BACKup utilityDatabase Decompile LIBGEN utility EJECt utility EJECt utility continued Enter Cartridges utility MOVe utility Reconfiguration utilityJournal OFFLoad utility REPLace utility RESTore utility SCRAtch utility Scratch Redistribution SCREdist utility 462VM/HSC 6.0 System Programmer’s Guide SET utility Options SET utility continued UNSCratch utilityUnselect utility 464VM/HSC 6.0 System Programmer’s Guide Volume Report VOLRpt utility CLean command Operator CommandsCDs Enable/Disable command 466VM/HSC 6.0 System Programmer’s Guide DISMount command Display ALl Display commandDisplay Acs Display ALLOC Display DRives Display CmdDisplay COMMPath CMd COmmand Display Drives continued 470VM/HSC 6.0 System Programmer’s Guide Display LMUPDEF Display ExceptionsDisplay LKEYDEF Display LSM Display Requests Display MONitorDisplay OPTion 472VM/HSC 6.0 System Programmer’s Guide Display SCRatch Display Status Display SCRPDEFDisplay SRVlev 474VM/HSC 6.0 System Programmer’s Guide Display THReshld Display TREQDEF Display Volume DRAin CAP commandEJect command Display UNITDEF Eject Command continued MODify command ENter commandJournal command MONITOR command devaddr Mount commandvolser host-id 480VM/HSC 6.0 System Programmer’s Guide MOVe MOVe commandVolume Flsmlsm-id RELease CAP command OPTion command and control statementRECover Host command 482VM/HSC 6.0 System Programmer’s Guide Stop Monitoring STOPMN command SENter commandSRVlev Service Level command SWitch command Vary Station command TRace commandTRACELKP command 484VM/HSC 6.0 System Programmer’s Guide VIew command Warn command 486VM/HSC 6.0 System Programmer’s Guide TRace command HSC Diagnostic CommandsLIst command 1st ed., 6/30/04 CANCEL command SCP Operator CommandsAUTHorize Command CP Command Modify Command SCP FILE CommandHELP Command Query Command SET Command Reply Command490VM/HSC 6.0 System Programmer’s Guide destination events STOP Command SLK CommandSTArt Command STOPSCP Command SLKGCS Command GCS Component Server Commands1st ed., 6/30/04 - CMS HELP CMS Operator CommandsACS EXEC 494VM/HSC 6.0 System Programmer’s Guide CP Programming Services Appendix B. CP Commands and DIAGNOSE CodesCP Commands Overview 496VM/HSC 6.0 System Programmer’s Guide IUCV1st ed., 6/30/04 - Appendix C. Record Formats Overview Mapping Macros for Batch API Records Mapping Macros for SMF RecordsMapping Macros for LOGREC Records Type SMF Records SMF Mapping Macros Cross Reference SMF Record FormatsSLSDVAR Type Type SLSSFHDRTable 33. SLSSFHDR Record Format Length Length Table 33. SLSSFHDR Record Format ContinuedType Label Length Table 33. SLSSFHDR Record Format ContinuedType Label Cross Reference 504VM/HSC 6.0 System Programmer’s Guide Value NameOffset Appendix C. Record Formats SLSSBLOS Cross Reference SIGNED-FWORD SLSSCAPJ Cross Reference SLSSCAPN Cross Reference SLSSVSTA SLSSVSTA Cross ReferenceAppendix C. Record Formats SLSSMLSM Cross Reference SLSSLSB Type Cross ReferenceTable 39. SLSSLSB Record Format Continued Length SLSSMF07 1.1 X’05’ CHARACTER CHAR CONST LENGTH Cross Reference 520VM/HSC 6.0 System Programmer’s Guide SMF07MVU Appendix C. Record Formats 522VM/HSC 6.0 System Programmer’s Guide SLSSMF08 Cross Reference 524VM/HSC 6.0 System Programmer’s Guide LOGREC Records LOGREC Mapping Macros LOGREC Record Formats SLSSLHDR OFFSET Length Table 43. SLSSLHDR Record Format ContinuedType Label LTYPAREA Cross ReferenceAppendix C. Record Formats 530VM/HSC 6.0 System Programmer’s Guide SLSSVLG1 Cross Reference 532VM/HSC 6.0 System Programmer’s Guide SLSSBLOG Cross Reference 534VM/HSC 6.0 System Programmer’s Guide SLSSLLG1 CONST 1.. .... X’40’ Cross Reference 538VM/HSC 6.0 System Programmer’s Guide LLG1NWSN Appendix C. Record Formats SLSSLLG2 Cross Reference HEXSTRING SLSSLLG3 Cross Reference SLSSLLG4 Cross Reference 544VM/HSC 6.0 System Programmer’s Guide SLSSLLG5 1... .... X’80’ LLG5ACS Cross ReferenceAppendix C. Record Formats SLSSLLG6 1... X’08’ SIGNED-FWORD LLG6ACS Cross ReferenceAppendix C. Record Formats 552VM/HSC 6.0 System Programmer’s Guide SLSSDJLR Cross Reference CHARACTER SLSSPSWI Cross Reference 556VM/HSC 6.0 System Programmer’s Guide SLSSRL00 Cross Reference SLSSRL01 Cross Reference SLSSHLG1 1. .... X’20’ HLG1FLG1 Cross ReferenceAppendix C. Record Formats Volume Report and Batch API Records Volume Report and Batch API Mapping Macros Volume Report and Batch API Record Formats SLUVADAT 1.. .... X’40’ HEXSTRING 1 ..1. X’12’ Cross Reference X’80’ 568VM/HSC 6.0 System Programmer’s Guide LSMNADLS Appendix C. Record Formats 570VM/HSC 6.0 System Programmer’s Guide SLUVCDAT 1 X’01’ CFGCCPFX Cross ReferenceAppendix C. Record Formats SLUVHDAT 1.. .... X’40’ Cross Reference 576VM/HSC 6.0 System Programmer’s Guide SLUVIDAT CHARACTER CDSALL Cross ReferenceAppendix C. Record Formats SLUVSDAT STNACS Cross ReferenceAppendix C. Record Formats SLUVVDAT CHAR CONST CHARACTER CHARACTER X’20’ HEXSTRING HEXSTRING VOLDEST Cross ReferenceAppendix C. Record Formats 590VM/HSC 6.0 System Programmer’s Guide VOLRRCNL Appendix C. Record Formats 592VM/HSC 6.0 System Programmer’s Guide Table 64. Mapping macros for Batch API Records Batch API RecordsBatch API Mapping Macros Appendix C. Record Formats Batch API Record Formats SLUVDDAT Cross Reference F0F1 596VM/HSC 6.0 System Programmer’s Guide ‘CVAL’ UVD994B5Appendix C. Record Formats 1st ed., 6/30/04 - SLUVPDAT SIGNED-HWORD Cross Reference 600VM/HSC 6.0 System Programmer’s Guide Value NameOffset UVPTWSTD 602VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Information Being Logged Temporary Motion Error CountsAppendix D. Logging ACS Robotics Motion Robotics Motion Start Counts 604VM/HSC 6.0 System Programmer’s Guide Permanent Motion Errors1st ed., 6/30/04 - BYTE # How Information is LoggedDescription of Field 46-46 152-155 BYTE # Motion Hard Fail Software Error RecordDescription of Field Logging Interval Single-HostEnvironment Multi-HostEnvironment LMU Response Codes Invalid Parameter Error Codes: 0101 - Configuration Error Codes: 0201 - CAP Procedural Error Codes: 0301 - General Procedural Error Codes: 0401 - Drive not rewound LMU LAN Interface Error Codes: 0501 -0426 0427 LMU Logical Error Codes: 0601 - LSM Robotics Error Codes: 0701 - LSM Hardware Error Codes: 0801 - LSM Logical Error Codes: 0901 - 0921 1012 Drive Error CodesUndefined Response Code Load Failure on Special Use Appendix E. Remote-linkedLibraries Appendix E. Remote-linkedLibrariesOverview 1st ed., 6/30/04 - Figure 29. Configuration Configuration622VM/HSC 6.0 System Programmer’s Guide MVS/CSC ConfigurationAppendix E. Remote-linkedLibraries Figure 30. Configuration Configuration624VM/HSC 6.0 System Programmer’s Guide Figure 31. Configuration ConfigurationAppendix E. Remote-linkedLibraries Figure 32. Configuration Configuration626VM/HSC 6.0 System Programmer’s Guide Programming and Operational Considerations Resolving CDS Issues After a Remote-LinkFailureControl Data Set Integrity •Prior to reestablishing the link Invoking QCDS SLSUREQ Macro QCDS RequestHow QCDS Functions Overview VM Requirement Addresses and RegistersSLSUREQ VM Requirements Syntax Parameterslabel REQUEST This parameter is required BUFFER Notes QCDS Programming ConsiderationsE,parmaddr UCALADR Decimal Value and Description Return CodesReturn Field Name Invalid SLSUREQ Requests Sample QCDS Requests 636VM/HSC 6.0 System Programmer’s Guide WKFLATDDKFLATDDL,KFLATDD Initialize the working 638VM/HSC 6.0 System Programmer’s Guide Constants 640VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - RECORD AREAS IN AN ALTERNATING FASHION 642VM/HSC 6.0 System Programmer’s Guide PROCESS Request Entered Output DescriptionRecords Returned Parameters SLSUREQM MacroSyntax PRO=NO|YES Batch API Mapping SLSUREQM Macro A-ADDR SIGNED-FWORD CONST CONST Cross Reference SLSUACSA 652VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 654VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Glossary Central Support Remote Center CSRC— See Page device separation— See drive exclusion directed allocation— See drive prioritizationPage Page Page Page Page Page Silverton— See 4490 Cartridge Subsystem Page Page Symbols Numerics 8500 library— See StreamLine SL8500 library 670VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Numerics IndexIndex 672VM/HSC 6.0 System Programmer’s Guide control data set definition control statement Index 674VM/HSC 6.0 System Programmer’s Guide 377, 383, 676VM/HSC 6.0 System Programmer’s Guide Library Control Unit LCU, defined Index cap-id 466, 476, 478, 482, 483 cap-list 466, ACS 108,CAP 468, 478, 678VM/HSC 6.0 System Programmer’s Guide 478, 680VM/HSC 6.0 System Programmer’s Guide RECover Host command recovery functions Index 682VM/HSC 6.0 System Programmer’s Guide SRVlev command Index 684VM/HSC 6.0 System Programmer’s Guide Index 686VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 -Page Printed in U.S.A