Batch Application Program Interface API | StorageTek 6 specification

Image 112

StorageTek manual Batch Application Program Interface API, 82VM/HSC 6.0 System Programmer’s Guide

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 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 - 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 - 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 Command Service Level ExecutionBase Full Service Level Execution UtilityBase 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 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 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 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 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 LMU Server Functions Dual LMU FunctionalityIf the Master LMU Fails 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 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 PARMLIB Control Statements OverviewDefining 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 Examples license-key-stringLKEYINFO 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 SCRPOol Other Methods of Controlling Scratch SubpoolsExample 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 Syntax TAPEREQTAPEREQ TAPEREQ Syntax continued122VM/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 TAPEREQ subpool-name4490 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 Unit Attribute UNITATTR Control Statement UNITATTRUNITATTR 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 VOLATTR Volume Attribute VOLATTR Control StatementVOLATTR Usage VOLATTR Disabling a VOLATTR Definition144VM/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 VOLATTR use-limitSTK1RC34 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 SSYS RESETCOLD RECONFIG MemberDialog Both HSC Startup Job ACS SLKJCL Sample ACS SLKJCL File Example Notes Description of /FILE StatementSLSSYSXX 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 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 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 Report Headings Reports Created by UtilitiesParameters 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 Usage Notes Activities Report196VM/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 How the AUDIt Utility Functions Actions Permitted During an AuditAudit 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 Output Description Backup•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 - Related Utilities Backup How to Restart Backup224VM/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 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 - 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 JCL for Directory Rebuild Directory Rebuild JCL ExampleOutput Description Eject Cartridge Eject Cartridge UtilitySyntax 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 Figure 13. EJECt Cartridge Utility Sample Output Eject Cartridge Output Description248VM/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 JCL for Offload of Journals Journal Offload JCL ExampleOutput Description Journal Offload Figure 15. Journal Offload Utility Sample Output256VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Move Move UtilityMOVe Considerations lsm-id MoveSyntax Utility Name panel Moverow-list column-list Invoking the Move Utility Move JCL RequirementsACSUTIL SLKJCL File Move JCL Examples Move Several Volumes From an LSM to Another LSMOutput 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 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 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 JCL Examples Restore Invoking the Restore UtilityACSUTIL SLKJCL File JCL for RESTore with Journals Applied JCL for RESTore with GENerate OnlyRestore 280VM/HSC 6.0 System Programmer’s Guide Restore JCL for RESTore Journals and Output to SLSAUDITOutput 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 Scratch Redistribution UtilityHow 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 Note: This syntax is continued on the next page Set SyntaxChapter 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 SET Freeze Panel oldpswdFREEZE 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 Unselect UtilitySyntax 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 Volume Report JCL to Produce a 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 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 - Messages Abend CodesHSC Messages SCP Messages CP Trace Table Software Trace FacilitiesCCWTRACE 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 IPTYPE IUCV Interrupt BufferInterrupt 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 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 Diagnostic Commands VM CP CommandsSetting Initialization Sequence Break-Points SCP Debug Mode offset length Enabling the Diagnostic Subsystem SCP Diagnostic Subsystem Commands=DEBUG =DDICT =NODEBUGfieldname =HPER epnameoffset length address =WHEREepname HSC Diagnostic Commands LIst CommandSyntax Parameters 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 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 SCP Task/Job Data Relationships Diagnostic TechniquesSubsystem 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 Find the Failing Task Identify the Failing RoutineFind 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 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 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 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 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 ZZZ000ZZZ999 SCRPOOL NAME=STD36,RANGEAAA000AAA999440VM/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 444VM/HSC 6.0 System Programmer’s Guide LIBGEN Macros1st ed., 6/30/04 - SLIACS macro SLIALIST macroSLIDLIST macro SLIDRIVS macros 446VM/HSC 6.0 System Programmer’s Guide SLILIBRY macro1st 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 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 - 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 SET Command Reply Command490VM/HSC 6.0 System Programmer’s Guide destination events SLK Command STArt CommandSTOP Command STOPSCP Command SLKGCS Command GCS Component Server Commands1st 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 496VM/HSC 6.0 System Programmer’s Guide IUCV1st 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 SLSSVSTA Cross ReferenceAppendix 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 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 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 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 - 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 - 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 QCDS Request How QCDS FunctionsInvoking QCDS SLSUREQ Macro Overview VM Requirement Addresses and RegistersSLSUREQ 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 Request Entered Output DescriptionRecords 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 - 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 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