654VM/HSC 6.0 System Programmer’s Guide | StorageTek guide

654VM/HSC 6.0 System Programmer’s Guide

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

Image 684

StorageTek manual 654VM/HSC 6.0 System Programmer’s Guide, 1st ed., 6/30/04

Contents

System Programmer’s Guide Release312579601 Host Software Component VM Implementation Export Destination Control Statement Restricted RightsLimitations on Warranties and Liability Proprietary Information Statement Document Effectivity Doc Kit NumberHost Software Component for Document Effectivity ivVM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Contents What’s New With This Release?Preface 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 Appendix E. Remote-linkedLibraries GlossaryIndex 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 - What’s New With This Release? Installation GuideInstallation Guide Installation Guide Installation Guide System Programmer’s GuideSystem Programmer’s Guide System Programmer’s Guide Preface ScopeIntended Audience Organization of This Guide How to Use This Guide References to HSC Product Releases Related PublicationsReader’s Comments 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 APPLICATIONS COMMONCONTROL SERVERS VM Environment VM Operating System CP and CMS System Control Program SCP Storage ManagementDevice Management File Management Task Management Job ManagementProcessor Management Communication Virtual Machine Configuration Task Recovery/TerminationHost Software Component HSC 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 User Control of HSC Functions MacrosUtilities PARMLIB Control Statements Commands 18VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Chapter 2. Host Software Component Functions Overview of HSC FunctionsAutomatic Functions of the HSC Installation Functions HSC Service Levels Description of Base Service LevelInitialization/Termination Functions Description of Full Service Level Command Service Level ExecutionBase Full Service Level Execution UtilityBase Full Displaying/Setting Service Level Starting the HSC Subsystem at Base Service Level Media Type and Recording Technique Processing 26VM/HSC 6.0 System Programmer’s Guide1st ed., 6/30/04 - MEDia and RECtech Parameters MEDIA TYPESRECORDING TECHNIQUES Model Parameter MODelResulting RECtech Matching VOLATTR and TAPEREQ Statements Specific Volume Requests Nonspecific Volume RequestsPrecedence of VOLATTR and TAPEREQ Statements 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 HSC Mount Command Support Example of Mount Command with Readonly OperandVirtual Thumbwheel VTW Tape Management Interface Tape Transport Cleaning Automated Tape Transport CleaningActivating Automated Cleaning Identifying Cleaning Cartridges NotesNotes 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 Ejecting Cartridges from the Library CAP Mode ConsiderationsCAP Exception Processing Releasing an Allocated CAP 48VM/HSC 6.0 System Programmer’s Guide Using Multiple CDS Copies Near Continuous Operations Automatic Recognition of Configuration Changes Automatic Update of LSM from 4410 toRun-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 Using CDS Rename/Relocate/Expand CDs CommandRenaming/Relocating a CDS - Scenarios Renaming a CDS Copy Relocating an Uncataloged CDS Copy Expanding a CDS - ScenarioCDS ENABLE DSNACS.DBASENEW NEWLOC CDS EXPAND 56VM/HSC 6.0 System Programmer’s Guide Swapping Library Transports - New Model Types Common Recovery Functions Control Data Set Recovery Control Data Set Recovery Techniques User Control of Control Data SetsAllocation of Control Data Sets Dynamic Enable/Disable of Control Data Sets 4. Issue the command Command Functions Figure 5. HSC Command Functions Overview62VM/HSC 6.0 System Programmer’s Guide Controlling LSM Operating Mode Controlling CAP Operating ModeViewing the Interior Components of an LSM •A VIew request is sent to the controlling LMU Utility Functions Figure 6. Utility Functions OverviewChapter 2. Host Software Component Functions LMU Server Functions Dual LMU FunctionalityIf the Master LMU Fails If the Standby LMU Fails LMU Switchover Messages After an LMU Switch OccursHSC/LMU Software Combinations Adding New Stations to an ACS JCL to Add New Stations to an ACSNotes for the Example Reconstructing a LIBGEN Recovery Maintenance Requirements Dynamic LMU ConnectionHSC Port Number Assignments Multiple TCP/IP Stack Implications Transitioning Between 3270 and TCP/IP 3270 to TCP/IPTCP/IP to Recovering TCP/IP Communications Operator Intervention - Single LMU Configuration Operator Intervention - Dual LMU ConfigurationCommunication Lost to Master LMU Communication Lost to Standby LMU Configuring VM for TCP/IP Support System Definition File ACS SYSDEFSystem Profile File ACS SYSPROF HSC Startup Job File ACS SLKJCL Initializing the LMUPATH Definition Data Set Commands to Format OS MinidiskCommands to Format CMS Reserved Minidisk Minidisk Statement for the LMUPATH Data Set LMUPATH Definition Data Set JOB SLSXUTIL SLUGENER /PARM RECCOPYFILE SYSPRINT DEV PRNT CLASS A FILE SYSUT2 DEV <vaddr> DSN <dsname> /FILE SYSUT1 Host-to-HostCommunications Services Types of Communications ServicesCommunication Functions 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 Overview PARMLIB Control StatementsDefining PARMLIB Control Statements Processing PARMLIB Control Statements Options Offered by PARMLIB Control StatementsCAP Preference Definition Control Data Set Definition Communications Path Definition EXECPARM Control DefinitionJournal Data Set Definition License Key Information Control Statement Continuation Conventions Reconfiguration CDS DefinitionOption Control Scratch Subpool Control CDSDEF CDS Definition CDSDEF Control Statement Syntax CDSDEF Control Statement NameParameters DISABLE Example DSN3SLS.DSTBY,VOL3HSC103,UNIT3503,+ DISABLECDSDEF CDSDEF DSN1SLS.DBASE,VOL1HSC101,UNIT1501,+ EXECParm EXECParm Control Statement SyntaxControl Statement Name EXECParm EXECParm Control Statement - Command Prefix Off EXECParmHOSTID Example JRNDEF Journal Definition JRNDEF Control StatementSyntax Control Statement Name JRNDEF UNITxFULL Abend LKEYDEF LKEYDEF Command and Control Statement Command NameParameter Descriptions dataset-name LKEYDEF unitnamehost-id UNIT LKEYINFO product-identifiercustomer-name nnnnnnn license-key-string ExamplesLKEYINFO RECDEF SyntaxControl Statement Name RECDEF RECDEF ExampleRECDEF DSN1SLS.DBASE,VOL1HSC101,UNIT1501,+ DSN2SLS.DBSEC,VOL2HSC102,UNIT2502 SCRPOol Scratch Subpool Control Statement SyntaxControl Statement Name SCRPOol SCRPOol RANGENotes LABEL Other Methods of Controlling Scratch Subpools SCRPOolExample Definition Data Set Control Statements OPTion TITLE LMU PathLMU Parameter Definition Scratch Subpool Parameter Statement Definition Defining LMU Network Connections Defining Tape Request Attributes TAPEREQVolume Attribute Volume Attribute Definition Defining Volume Attributes VOLATTR Defining Unit Attributes UNITATTR Identifying the Definition Data Sets OPTION TITLE Control Statement Continuation Conventions LMUPATH LMUPATH Control Statement LMUPATH UsageSyntax Control Statement Name LMUPATH lmu_hostnamennn.nnn.nnn.nnn LMUADDR LMUPDEF LMUPDEF Command and Control Statement 110VM/HSC 6.0 System Programmer’s Guide LMUPDEF dataset.nameSyntax Control Statement Name LMUPDEF Load the LMUPATH Parameters From YOUR.DSNMEMBERunitname host-id OPTion TITLE OPTion TITLE Control Statement identifying-stringSyntax Control Statement Name OPTion TITLE Example114VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - SCRPDEF SCRPDEF SyntaxControl Statement Name Parameters Load the SCRPOol Parameters From YOUR.DSNMEMBER SCRPDEFunitname host-id TAPEREQ Tape Request TAPEREQ Control Statement TAPEREQ Usage TAPEREQ Disabling a TAPEREQ Definition TAPEREQ 120VM/HSC 6.0 System Programmer’s Guide TAPEREQ SyntaxTAPEREQ Syntax continued TAPEREQ122VM/HSC 6.0 System Programmer’s Guide job-name step-nameTAPEREQ Control Statement Name program-name DD-nameTAPEREQ PROGram or PGMname retention-period expiration-dateTAPEREQ EXPDT TAPEREQ LONGItudStandard ECART TAPEREQ ZCARTDD3A, DD3B, DD3C STK1 TAPEREQ RECtechNotes LONGItud TAPEREQ 36Atrack TAPEREQ STK1RC subpool-name TAPEREQ4490 Set Tape Request Attributes TAPEREQExample 132VM/HSC 6.0 System Programmer’s Guide TREQDEF TREQDEF SyntaxControl Statement Name Parameters Load the TAPEREQ Parameters From YOUR.DSNMEMBER TREQDEFunitname host-id UNITATTR Unit Attribute UNITATTR Control StatementUNITATTR Usage UNITATTR unit-addressSyntax Control Statement Name UNITATTR MODel Specify Unit Attribute Statements UNITATTRT9940B35 IGNORE UNITDEF 140VM/HSC 6.0 System Programmer’s Guide UNITDEF SyntaxControl Statement Name Parameters UNITDEF host-idExamples Specify a Data Set Containing UNITATTR Statements Volume Attribute VOLATTR Control Statement VOLATTRVOLATTR Usage Disabling a VOLATTR Definition VOLATTR144VM/HSC 6.0 System Programmer’s Guide This syntax diagram is continued on the next page VOLATTRSyntax VOLATTR SERial volser VOLATTR Syntax continuedControl Statement Name VOLATTR volser or vol-rangeor vol-list VOLATTRParameters SERial VOLATTR Valid media types are VOLATTR ZCARTDD3A, DD3B, DD3C, DD3D STK1 VOLATTR STK2P, STK2WRECtech LONGItud VOLATTR indicates a 9490 Timberline transport use-limit VOLATTRSTK1RC34 Set Volume Attributes VOLATTRExample VOLATTR SERIALL*,AA9* MEDIAECART VOLDEF 154VM/HSC 6.0 System Programmer’s Guide VOLDEF SyntaxControl Statement Name Parameters Load the VOLATTR Parameters From YOUR.DSNMEMBER VOLDEFunitname host-id Creating an SLKJCL File for Starting the HSC PARM StatementPARM Statement Parameters Syntax RESET SSYSCOLD RECONFIG MemberDialog Both HSC Startup Job ACS SLKJCL Sample ACS SLKJCL File Example Description of /FILE Statement NotesSLSSYSXX Configuration Mismatches Starting HSC ExecutionModifying LSMs Online 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 Selecting a Utility FunctionUtility to Use Restore or recreate the library CDS Typical Use of Utilities Control Statement Syntax Conventions Utility Syntax ConventionsUtility Environmental Requirements ACS UTIL Exec CMS Environment ACSCMS EXEC SCP Environment ACSUTIL SLKJCL file JCL and Control Statements SCP Batch Job Control Language JCLJOB Statement jobname PARM Statement parmsCOMM Statement comments Submitting Jobs fnameftype fmode Utility Control Statements Control Statements vs. JCL Utility Administrator SLUADMIN How to Invoke SLUADMIN How to Invoke Utility Programs SLUADMIN Program Return CodesReturn Code Description Reports Created by Utilities Report HeadingsParameters Controlling Report Headings Example of JCL Using Report Heading Options ExampleDATE=2YR DATE=4YR Stand-AloneUtilities Activities Report Utility Activities ReportSLUACTV EXEC type SLSSMF fname ftype fmode Activities ReportPARM MIXED Syntax Utility NameParameters begin-date end-date end-timeActivities Report TODAY Invoking the Activities Report Utility Control File ExampleOutput Description Control File to Produce an Activities Report Activities Report Total Activities Report % of allAve. time Ave. pass-thrus Usage Notes Activities ReportEarliest Latest Activities Report •LSM operating statistics record, subtype 1, and Activities Report ACS IDARM USE P-THRU Activities Report Usage Notes196VM/HSC 6.0 System Programmer’s Guide Activities Report Figure 9. Activities Report Utility Sample OutputChapter 4. Utility Functions 1st ed., 6/30/04 - Audit Utility Audit Media Type Mismatch Conditions Audit Actions Permitted During an Audit How the AUDIt Utility FunctionsAudit Concurrent Audits Audit acs-id AuditSyntax Utility Name lsm-list panel-listAudit PANel row-list column-listAudit Notes cap-id Audit Audit EMPTYCelDIAGScan Notes JCL Requirements Invoking the Audit UtilityACSUTIL SLKJCL File Audit JCL Examples JCL for Audit of Entire Library all ACSsJCL for Selective Audit 1 ACS, 2 LSMs, with CAPid Audit JCL for Selective Audit of Diagnostic Cells Only JCL for Selective Audit of Empty CellsAudit Output Description Audit Figure 10. AUDIt Utility Sample Output210VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Backup Utility BackupReasons for Running the BACKup Utility Prerequisites Backup How the BACKup Utility Functions Backup Backup Procedure Backup BACKupSyntax Utility Name Backup PrimarySecondary STandby Backup Restart Backup JCL Requirements SLSPRINTSLSCNTL SLSCNTL2 Backup Invoking the BACKup Utility ACSUTIL SLKJCL File Backup JCL Examples JCL for Running BackupRun Backup Utility JCL for Running a Copy Backup Backup Output Description•the following data sets Backup •a condition code from backup processing4warning MESSAGES – Backup successful Chapter 4. Utility Functions Backup Figure 11. BACKup Utility Sample Output 1 of222VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Backup Figure 11. BACKup Utility Sample Output 2 ofChapter 4. Utility Functions 1st ed., 6/30/04 - Backup How to Restart Backup Related Utilities224VM/HSC 6.0 System Programmer’s Guide Database Decompile LIBGEN Utility Database DecompileHow the Database Decompile Utility Functions Prerequisites Database Decompile Syntax Utility NameParameters JCL Requirements Invoking the Database Decompile Utility JCL ExampleJCL for Database Decompile Database Decompile Database Decompile Output Description DeviceLabel Description Database Decompile Chapter 4. Utility Functions1st ed., 6/30/04 - Database Decompile 230VM/HSC 6.0 System Programmer’s Guide1st ed., 6/30/04 - Database Decompile Chapter 4. Utility Functions1st ed., 6/30/04 - Database Decompile 232VM/HSC 6.0 System Programmer’s Guide1st ed., 6/30/04 - Database Decompile Chapter 4. Utility Functions1st ed., 6/30/04 - Database Decompile 234VM/HSC 6.0 System Programmer’s Guide1st ed., 6/30/04 - Database Decompile Chapter 4. Utility Functions1st ed., 6/30/04 - Directory Rebuild Utility Directory RebuildReasons for Running the Directory Rebuild Utility How the Directory Rebuild Utility Functions Directory Rebuild Invoking the Database Decompile UtilitySLSCNTL, SLSCNTL2, SLSSTBY SLSIN Directory Rebuild JCL Example JCL for Directory RebuildOutput Description Eject Cartridge Utility Eject CartridgeSyntax Eject Cartridge Utility NameEJECt Eject Method 2 continued Eject Cartridge Parameters vol-listcount 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 Invoking the Eject Cartridge Utility Eject CartridgeJCL Requirements ACSUTIL SLKJCL File JCL for Ejecting a Single Volume JCL to Eject One STD Scratch CartridgeJCL to Eject Five SD-3Scratch Cartridges Eject Cartridge Eject Cartridge Output Description Figure 13. EJECt Cartridge Utility Sample Output248VM/HSC 6.0 System Programmer’s Guide Enter Cartridges Utility Enter CartridgesCAP Operating Instructions Syntax Invoking the Enter Cartridges Utility Enter CartridgesJCL Requirements SCRatch JCL for Entering Cartridges in a CAP Enter CartridgesJCL Example Output Description Enter Cartridges Figure 14. Enter Cartridge Utility Sample Output252VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Journal Offload Utility Journal OffloadSyntax Utility Name Invoking the Journal Offload Utility Journal OffloadSLSOFF02 SLSIN Journal Offload JCL Example JCL for Offload of JournalsOutput Description Journal Offload Figure 15. Journal Offload Utility Sample Output256VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Move Utility MoveMOVe Considerations lsm-id MoveSyntax Utility Name panel Moverow-list column-list Move JCL Requirements Invoking the Move UtilityACSUTIL SLKJCL File Move Several Volumes From an LSM to Another LSM Move JCL ExamplesOutput Description Move Figure 16. MOVe Utility Sample Output262VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Performance Log Reblocker Utility Performance Log ReblockerSyntax CMS Statement Performance Log Reblocker utility Performance Log Reblocker mvsnode Performance Log ReblockerJCL Requirements class Reconfiguration Utility ReconfigurationReasons for Running the Reconfiguration Utility Considerations Before Running Reconfiguration DASD Considerations in a VM-onlyEnvironmentReconfiguration How the Reconfiguration Utility Functions Reconfiguration268VM/HSC 6.0 System Programmer’s Guide I/O Considerations ReconfigurationCondition Number of I/Os Running a Successful Reconfiguration Minimizing I/O TimeReconfiguration 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 Restore Utility RestoreReasons for Running the RESTore Utility How the RESTore Utility Functions Restore RESToreUtility Name Parameters Restore JCL RequirementsOnly Short Restore Invoking the Restore Utility JCL ExamplesACSUTIL SLKJCL File JCL for RESTore with Journals Applied JCL for RESTore with GENerate OnlyRestore 280VM/HSC 6.0 System Programmer’s Guide JCL for RESTore Journals and Output to SLSAUDIT RestoreOutput Description Restore Figure 17. Restore Utility Sample Output282VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - How to Handle BACKup/RESTore Discrepancies Restore Scratch Redistribution Utility Scratch RedistributionHow the Scratch Redistribution Utility Functions Scratch Redistribution Syntax Utility NameSCREdist Chapter 4. Utility Functions Scratch Redistribution Parameters tolerance-valueacs-id 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 Scratch Redistribution JCL Requirements Invoking the Scratch Redistribution UtilityJCL Examples ACSUTIL SLKJCL File JCL to Perform Scratch Redistribution Scratch RedistributionJCL to Perform Scratch Redistribution JCL to Perform Scratch Redistribution Scratch Redistribution Output Description 294VM/HSC 6.0 System Programmer’s Guide Scratch Update Utilities Scratch UpdateUtility Names SCRAtch utility Scratch Update Parameters Invoking the Scratch Update UtilitiesJCL Requirements vol-list JCL to Scratch, Unscratch, and Replace Scratch UpdateJCL Example Output Description Scratch Update Figure 19. Scratch Update Utilities Sample Output298VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - SET Utility How the SET Utility Functions SET OptionAffected HSCs All Other HSCs Considerations Before Running the SET Utility Summary of SET Utility Options SET Option SET Utility Function and Location of Description Set Syntax Note: This syntax is continued on the next pageChapter 4. Utility Functions SET ACS Esoteric esotericUtility Name Parameters SET Cleaning Prefix SET CLNPRFX PROCEDURESET HSC Command Prefix prefix Character Description SET Eject Password SET Delete DispositionSCRTCH NOSCRTCH oldpswd SET Freeze PanelFREEZE SET Host ID newhostoldhost SET HSC Level SET ENQ/DEQ/RESERVE QNAME qnameSET New Host model-host SET Scratch Label Type SET Device Numbers for Drivesesoteric FORHOST addr0,...addr19 Running SET SLIDRIVS With the HSC Active FORLSMIDlsm-id FORPANEL SET SLIDRIVS Procedure SET LMU Station Address Numbersstat1,...,stat16 SLISTATN SET Recovery Technique SET SMF Record Typelibtype FORACS SET TCHNIQE PROCEDURE JCL RequirementsSHADOW BOTH Invoking the Set Utility ACSUTIL SLKJCL File Set JCL Examples JCL for Set Utility JCL for Multiple SET Statements Output Description Unselect Utility UnselectSyntax Unselect Utility Name Invoking the Unselect UtilityParameters JCL Requirements JCL to Unselect a Volume UnselectJCL Example Output Description Unselect Figure 20. Unselect Utility Sample OutputChapter 4. Utility Functions 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 Volume Report Utility Name volser or vol-range or vol-listParameters acs-id Volume Report SORT Volume Report INCLude Volume Report MEDEQUALNONMEDEQ NOEXTernal Volume Report VOLISTVOLDATA CDSDATA JCL/Parameter File Requirements Volume ReportSLSCNTL, SLSCNTL2, SLSSTBY SLSPRINT JCL/Parameter File Syntax SLSCNTLvaddr control.set.name fn, ft, fm keywordsSLSCDATA CMS only SLSSCRPL CMS only SLSVA CMS only PARMparameters JOB SCP only Volume Report Invoking the Volume Report Utility SLUVOLR EXEC CMSParameter File ACSUTIL SLKJCL File JCL to Produce a Volume Report Volume ReportJCL Example JCL to Produce a Volume Report for an MVS PDS Report Detail LinesMedia and Recording Technique Origin Volume Report Media Type Prefix Characters Errant, Scratch, Selected FieldsExternal Label Field Cartridge Usability CLN USE Field Volume Report Totals Subpool ID FieldTimes Selected Field Totals Reports Volume Report Flat Files Volume Report Volume Report Chapter 4. Utility Functions1st ed., 6/30/04 - Volume Report 344VM/HSC 6.0 System Programmer’s Guide1st ed., 6/30/04 - Volume Report Chapter 4. Utility Functions1st ed., 6/30/04 - 346VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Messages Abend CodesHSC Messages SCP Messages Software Trace Facilities CP Trace TableCCWTRACE VM CP Debug Commands SCP SET TRACE CommandTRACE Command Syntax SCP Internal Trace Table Master Trace Table Header Trace Table Entries DSP Trace Entry Code Query IPARML IUCV Parameter List TTEWORD1= IRT address TTEWORD2 = IPARML bytes IPARML for IUCV CONNECT to *BLOCKIO Inputs IPARML for IUCV SEND to *BLOCKIO Inputs=target class 1=write; 2=read =flags type=2way =relative block number =data buffer address IPARML for IUCV RECEIVE Inputs= target class = flags IPARML for IUCV REPLY Inputs= IUCV message id = target class IPARML for IUCV SEVER Inputs= name of virtual machine connected to Outputs IPRCODE IUCV Interrupt Buffer IPTYPEInterrupt Type IPARML for Pending Connection Interrupt IPARML for Connection Complete Interrupt IPPATHID = IUCV path idIPTYPE = 03=severed, 04=quiesced, 05=resumed IPARML for Incoming Message Interrupt IPARML for Message Complete Interrupt Diagnostic Capabilities Error Recording Data Set RecordsSCP Trace Facility Supervisor Call and Abnormal End Dumps SCP External Trace Facility SCP Trace Formatter Utility EXECSLUETRAC 368VM/HSC 6.0 System Programmer’s Guide infn inftinfm outfn Supervisor Call SVC Functions 370VM/HSC 6.0 System Programmer’s Guide1st ed., 6/30/04 - Refer to Table DecimalFunction 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 Diagnostic Commands VM CP CommandsSetting Initialization Sequence Break-Points SCP Debug Mode offset length SCP Diagnostic Subsystem Commands Enabling the Diagnostic Subsystem=DEBUG =NODEBUG =DDICTfieldname =HPER epnameoffset length =WHERE addressepname HSC Diagnostic Commands LIst CommandSyntax Parameters data-structure DISPLAY Command sizeaddress CDS Recovery Capabilities Dynamic Recovery of the Control Data SetControl 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 How to Request a Dump Dump ProcessingType of Dumps Supported What to do When a Dump Occurs Note Reason For Dump Move Problem Materials to Tape Load Dump and CONSLOG Onto DiskCall StorageTek Software Support Dump Analysis Using SLUIPCS SLUIPCS SCAN Subcommands VIEWVIEW CVT VIEW CCVT VIEW NUCON VIEW MTT VIEW STORMAN VIEW LVT VIEW structname Data Structures Data Structures IHAASCB EX EXECUTE CMS COMMAND FINDTRB SAVE AREA TRACEBACK TTE TRACE TABLE ENTRY WA WHERE ADDRESS WN WHERE NAMESTAT STATUS TASK FIND TASK Major SCP Data Relationships SLUIPCS PRINT Options Command, Message, Trace Processing Figure 25. Command, Message and Trace Processing1st ed., 6/30/04 - NUCON X’10’ VECTPTR TRCTAB Diagnostic Techniques SCP Task/Job Data RelationshipsSubsystem Data Relationships Figure 26. SCP Task/Job Data Relationship NUCON JBLOK PSAAOLD JBLTASK TBLOK PSATOLDTKRBLIST RQBLOK Figure 27. Subsystem Data Relationships 404VM/HSC 6.0 System Programmer’s GuideNUCON CVT VECTPTR CVTJESCT JESCT JESSSCT SSCT SSCTSCTA SSCTSSVT SSCT Common Dump Analysis Tasks Find a Module Plus Offset, Given an AddressFind a Module Address, Given a Name View an HSC or SCP Data Area Identify the Failing Routine Find the Failing TaskFind the Failing Request Block Save Area Trace Back Find the LVTFind the LCT, LST, HST Identify the Last Interrupt Event Gather Diagnostic Materials Diagnostic MaterialsExamine an SDWA Find IUCV Path Descriptors details of problem circumstances •STKACS abend Tape Format Tape Return Chapter 6. Performance Considerations How Library Activity Affects Library PerformanceOverview Using the Activities Report Utility Monitoring Library Activity and PerformanceHow Operators Control Library Performance Tape Volume Report ACS Daily Report Redistribute Scratch Volumes in the Library Maintain Quantities of Scratch CartridgesDefine CAP Preferences 414VM/HSC 6.0 System Programmer’s Guide Use SMF Records to Collect Performance Data Use PARMLIB to Define Static ParametersOperator Command Performance Parameter Journal Definition Define High Dispatching Priority for the HSC Set High-Performance Host-to-HostCommunications Functioning of Host-to-HostCommunications Designation of Communication parameters418VM/HSC 6.0 System Programmer’s Guide Define Secondary and Standby Control Data Sets Limit View Time to Maintain High Performance Excessive Use of VIew Command Affects Performance How to Monitor Usage of the VIew CommandAdvantages of Using the VIew Command Chapter 6. Performance Considerations 1st ed., 6/30/04 - Loading Cartridges Into the Library Reduce Pass-Thrus Unavoidable Pass-Thrus Unnecessary Pass-ThrusScheduled Pass-Thrus Ways to Reduce Pass-ThruActivity Reduce Operator Intervention Ensure adequate free cellsEject through the CAP closest to the cartridge Redistribute cartridges during off-peaktimes ACSPROP EXEC Reduce Tape Transport ContentionPrefetch Enters Avoid Crashing Test Systems Reduce Scheduling Contention Usage RequirementsSyntax Parameters Use Performance Log Reblocker to Format Data Use the Audit Utility Effectively Use LSMs as Scratch Loaders in a Mixed ACS Commands Syntax Reference Syntax Flow DiagramsSpecifying Commands Variables Flow Lines Single Required Choice Defaults Repeat SymbolSingle Optional Choice Default Value Value2 Value3 Syntax Continuation Fragments Fragment432VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Library Identification How to Specify a CAPid CAPid FormatsLSM Model 4410 and PowderHorn LSM Model 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 SCRPOOL NAME=STD36,RANGEAAA000AAA999 ZZZ000ZZZ999440VM/HSC 6.0 System Programmer’s Guide MEDia, RECtech, and MODel Parameters MODel, and RECtech parametersacs-id, lsm-id acs-id, lsm-id Mount VOLATTR acs-id, lsm-id LIBGEN Macros 444VM/HSC 6.0 System Programmer’s Guide1st ed., 6/30/04 - SLIACS macro SLIALIST macroSLIDLIST macro SLIDRIVS macros SLILIBRY macro 446VM/HSC 6.0 System Programmer’s Guide1st ed., 6/30/04 - SLILSM macro SLIRCVRY macroSLISTATN macro SLIRCVRY HSC Control Statements EXECParm control statementJournal Definition JRNDEF control statement 448VM/HSC 6.0 System Programmer’s Guide LKEYDEF command and control statement LKEYINFO control statementLMUPATH control statement VOLumevolser OPTion control statement Scratch Subpool SCRPOol control statement450VM/HSC 6.0 System Programmer’s Guide 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 Volume Attribute VOLATTR control statement 454VM/HSC 6.0 System Programmer’s Guide1st ed., 6/30/04 - STK1RA STK1RA34 STK1RA35 STK1RB STK1RB34 STK1RB35 456VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Utilities ACTIvities Report utilityAUDIt utility ACSacs-id BACKup utility Database Decompile LIBGEN utilityDirectory Rebuild DIRBLD utility EJECt utility EJECt utility continued Enter Cartridges utility Reconfiguration utility Journal OFFLoad utilityMOVe utility REPLace utility RESTore utility SCRAtch utility Scratch Redistribution SCREdist utility 462VM/HSC 6.0 System Programmer’s Guide SET utility Options UNSCratch utility Unselect utilitySET utility continued 464VM/HSC 6.0 System Programmer’s Guide Volume Report VOLRpt utility Operator Commands CDs Enable/Disable commandCLean command 466VM/HSC 6.0 System Programmer’s Guide DISMount command Display command Display AcsDisplay ALl Display ALLOC Display Cmd Display COMMPathDisplay DRives CMd COmmand Display Drives continued 470VM/HSC 6.0 System Programmer’s Guide Display Exceptions Display LKEYDEFDisplay LMUPDEF Display LSM Display MONitor Display OPTionDisplay Requests 472VM/HSC 6.0 System Programmer’s Guide Display SCRatch Display SCRPDEF Display SRVlevDisplay Status 474VM/HSC 6.0 System Programmer’s Guide Display THReshld Display TREQDEF DRAin CAP command EJect commandDisplay Volume Display UNITDEF Eject Command continued ENter command Journal commandMODify command MONITOR command Mount command volserdevaddr host-id 480VM/HSC 6.0 System Programmer’s Guide MOVe command VolumeMOVe Flsmlsm-id OPTion command and control statement RECover Host commandRELease CAP command 482VM/HSC 6.0 System Programmer’s Guide SENter command SRVlev Service Level commandStop Monitoring STOPMN command SWitch command TRace command TRACELKP commandVary Station command 484VM/HSC 6.0 System Programmer’s Guide VIew command Warn command 486VM/HSC 6.0 System Programmer’s Guide HSC Diagnostic Commands LIst commandTRace command 1st ed., 6/30/04 SCP Operator Commands AUTHorize CommandCANCEL command CP Command FILE Command HELP CommandModify Command SCP Query Command Reply Command SET Command490VM/HSC 6.0 System Programmer’s Guide destination events SLK Command STArt CommandSTOP Command STOPSCP Command GCS Component Server Commands SLKGCS Command1st ed., 6/30/04 - CMS Operator Commands ACS EXECCMS HELP 494VM/HSC 6.0 System Programmer’s Guide Appendix B. CP Commands and DIAGNOSE Codes CP CommandsCP Programming Services Overview IUCV 496VM/HSC 6.0 System Programmer’s Guide1st ed., 6/30/04 - Appendix C. Record Formats Overview Mapping Macros for SMF Records Mapping Macros for LOGREC RecordsMapping Macros for Batch API Records Type SMF Records SMF Mapping Macros SMF Record Formats SLSDVARCross Reference Type SLSSFHDR Table 33. SLSSFHDR Record FormatType Length Table 33. SLSSFHDR Record Format Continued TypeLength Label Table 33. SLSSFHDR Record Format Continued TypeLength Label Cross Reference 504VM/HSC 6.0 System Programmer’s Guide Name OffsetValue Appendix C. Record Formats SLSSBLOS Cross Reference SIGNED-FWORD SLSSCAPJ Cross Reference SLSSCAPN Cross Reference SLSSVSTA Cross Reference SLSSVSTAAppendix C. Record Formats SLSSMLSM Cross Reference SLSSLSB Cross Reference Table 39. SLSSLSB Record Format ContinuedType 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 Table 43. SLSSLHDR Record Format Continued TypeLength Label Cross Reference LTYPAREAAppendix 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’ Cross Reference LLG5ACSAppendix C. Record Formats SLSSLLG6 1... X’08’ SIGNED-FWORD Cross Reference LLG6ACSAppendix 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’ Cross Reference HLG1FLG1Appendix 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’ Cross Reference CFGCCPFXAppendix C. Record Formats SLUVHDAT 1.. .... X’40’ Cross Reference 576VM/HSC 6.0 System Programmer’s Guide SLUVIDAT CHARACTER Cross Reference CDSALLAppendix C. Record Formats SLUVSDAT Cross Reference STNACSAppendix C. Record Formats SLUVVDAT CHAR CONST CHARACTER CHARACTER X’20’ HEXSTRING HEXSTRING Cross Reference VOLDESTAppendix C. Record Formats 590VM/HSC 6.0 System Programmer’s Guide VOLRRCNL Appendix C. Record Formats 592VM/HSC 6.0 System Programmer’s Guide Batch API Records Batch API Mapping MacrosTable 64. Mapping macros for Batch API Records Appendix C. Record Formats Batch API Record Formats SLUVDDAT Cross Reference F0F1 596VM/HSC 6.0 System Programmer’s Guide UVD994B5 Appendix C. Record Formats‘CVAL’ 1st ed., 6/30/04 - SLUVPDAT SIGNED-HWORD Cross Reference 600VM/HSC 6.0 System Programmer’s Guide Name OffsetValue UVPTWSTD 602VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Temporary Motion Error Counts Appendix D. Logging ACS Robotics MotionInformation Being Logged Robotics Motion Start Counts Permanent Motion Errors 604VM/HSC 6.0 System Programmer’s Guide1st ed., 6/30/04 - How Information is Logged BYTE #Description of Field 46-46 152-155 Motion Hard Fail Software Error Record BYTE #Description 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 - LMU LAN Interface Error Codes: 0501 - 0426Drive not rewound 0427 LMU Logical Error Codes: 0601 - LSM Robotics Error Codes: 0701 - LSM Hardware Error Codes: 0801 - LSM Logical Error Codes: 0901 - 0921 Drive Error Codes Undefined Response Code1012 Load Failure on Special Use Appendix E. Remote-linkedLibraries OverviewAppendix E. Remote-linkedLibraries 1st ed., 6/30/04 - Configuration Figure 29. Configuration622VM/HSC 6.0 System Programmer’s Guide Configuration MVS/CSCAppendix E. Remote-linkedLibraries Configuration Figure 30. Configuration624VM/HSC 6.0 System Programmer’s Guide Configuration Figure 31. ConfigurationAppendix E. Remote-linkedLibraries Configuration Figure 32. Configuration626VM/HSC 6.0 System Programmer’s Guide Resolving CDS Issues After a Remote-LinkFailure Programming and Operational ConsiderationsControl Data Set Integrity •Prior to reestablishing the link QCDS Request How QCDS FunctionsInvoking QCDS SLSUREQ Macro Overview Addresses and Registers VM RequirementSLSUREQ VM Requirements Parameters labelSyntax REQUEST This parameter is required BUFFER QCDS Programming Considerations E,parmaddrNotes UCALADR Return Codes Return Field NameDecimal Value and Description 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 Output Description Request EnteredRecords Returned SLSUREQM Macro SyntaxParameters 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 - Index NumericsIndex 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 ACS 108, CAP 468, 478,cap-id 466, 476, 478, 482, 483 cap-list 466, 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