References to HSC Product Releases

For purposes of convenience, the HSC Release 6.0.0 product is referred to as HSC 6.0 throughout all guides of the HSC documentation set.

Related Publications

The following documents are referenced in this guide. Additional information may be obtained on specific topics relating to the Automated Cartridge System from these publications.

StorageTek HSC Publications - VM environment

•Installation Guide

•Operator’s Guide

•System Programmer’s Guide

•Interface to Tape Management Systems

•Messages and Codes Guide

•SCP Messages and Codes Guide

Miscellaneous Publications

•A Guide to Magnetic Tape Management

•Automated Cartridge System Hardware Operator’s Guide

•Hardware Operator’s Guide

•Requesting Help from Software Support

•Nearline Physical Planning Guide

•Physical Planning Guide

Reader’s Comments

We would like to know what you think about this book. E-mail your comments to

Software Information Development directly. Our Internet address is:

sid@stortek.com

Be sure to include the document title and number with your comments.

StorageTek Product Support

StorageTek Customer Services provides 24-hour assistance for questions or problems related to StorageTek products. Calls from our customers receive immediate attention from trained diagnostic specialists.

See the Requesting Help from Software Support guide for information about contacting StorageTek for technical support and for requesting changes to software products. See “Gather Diagnostic Materials” on page 408 for information about diagnostic materials that Software Support might request.

Preface xxix

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

Page 29

Image 29

StorageTek 6 manual References to HSC Product Releases, Related Publications, Reader’s Comments, StorageTek Product Support

Contents

Release System Programmer’s Guide312579601 Host Software Component VM Implementation Restricted Rights Export Destination Control StatementLimitations on Warranties and Liability Proprietary Information Statement Doc Kit Number Document EffectivityHost Software Component for Document Effectivity 1st ed., 6/30/04 - ivVM/HSC 6.0 System Programmer’s Guide What’s New With This Release? ContentsPreface 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 C. Record Formats Appendix B. CP Commands and DIAGNOSE Codes Appendix D. Logging ACS Robotics Motion Index Appendix E. Remote-linkedLibrariesGlossary Figures Figure Tables Table 28. Performance Parameters Controlled by PARMLIB Control Statements Table 67. Format for Total Motions and Temporary Error Counts 1st ed., 6/30/04 - xxivVM/HSC 6.0 System Programmer’s Guide 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 Scope PrefaceIntended Audience Organization of This Guide How to Use This Guide Related Publications References to HSC Product ReleasesReader’s Comments StorageTek Product Support 1st ed., 6/30/04 - xxxVM/HSC 6.0 System Programmer’s Guide Automated Cartridge System Overview Chapter 1. System Description TimberWolf 9740 10-cellremovable magazine or 14-cellpermanent rack Host Software Component Overview HSC Architecture HSC Subsystem Components COMMON APPLICATIONSCONTROL SERVERS VM Operating System CP and CMS VM Environment Storage Management System Control Program SCPDevice Management File Management Job Management Task ManagementProcessor Management Communication Task Recovery/Termination Virtual Machine ConfigurationHost Software Component HSC Tape Management System TMS 10VM/HSC 6.0 System Programmer’s Guide HSC and Automated Cartridge System Interaction Chapter 1. System Description Figure 2. Virtual Machine Relationships 12VM/HSC 6.0 System Programmer’s Guide Figure 3. Shared Library Data Sets Automated Dismount Automated Mount 14VM/HSC 6.0 System Programmer’s Guide Dual LMU Environment Macros User Control of HSC FunctionsUtilities PARMLIB Control Statements Commands 1st ed., 6/30/04 - 18VM/HSC 6.0 System Programmer’s Guide Automatic Functions of the HSC Chapter 2. Host Software Component FunctionsOverview of HSC Functions Installation Functions Initialization/Termination Functions HSC Service LevelsDescription of Base Service Level Description of Full Service Level Service Level Execution CommandBase Full Utility Service Level ExecutionBase Full Starting the HSC Subsystem at Base Service Level Displaying/Setting Service Level 1st ed., 6/30/04 - Media Type and Recording Technique Processing26VM/HSC 6.0 System Programmer’s Guide RECORDING TECHNIQUES MEDia and RECtech ParametersMEDIA TYPES Resulting RECtech Model ParameterMODel Matching VOLATTR and TAPEREQ Statements Nonspecific Volume Requests Specific Volume RequestsPrecedence of VOLATTR and TAPEREQ Statements Scratch Selection How To Resolve Scratch Shortages •Standard and 36track •Long and 36track Mount/Dismount Functions Mount Processing for Specific Volumes Dismount Processing for Library Volumes Mount Processing for Scratch Volumes Abnormal Mounts/Dismounts Example of Mount Command with Readonly Operand HSC Mount Command SupportVirtual Thumbwheel VTW Tape Management Interface Activating Automated Cleaning Tape Transport CleaningAutomated Tape Transport Cleaning Notes Identifying Cleaning CartridgesNotes Over-use Over-limitand Spent Cleaning Cartridges Managing Over-useCleaning Cartridges Manual Tape Transport Cleaning Managing Cleaning Cartridges 1st ed., 6/30/04 - 42VM/HSC 6.0 System Programmer’s Guide Moving Volumes within the Library Volume/Cell Control Functions Scratch Subpool Management Scratch Threshold Task Restart Entering Cartridges into the Library Cartridge Access Port CAP Processing Functions CAP Exception Processing Ejecting Cartridges from the LibraryCAP Mode Considerations 48VM/HSC 6.0 System Programmer’s Guide Releasing an Allocated CAP Near Continuous Operations Using Multiple CDS Copies Run-timeRecognition of 9740 CAP Configuration Automatic Recognition of Configuration ChangesAutomatic Update of LSM from 4410 to Defining Planned ACSs with no Stations Changing Panels To remove cartridges from rows on panels to facilitate hardware e.g., cabling changes CDs Command Using CDS Rename/Relocate/ExpandRenaming/Relocating a CDS - Scenarios Renaming a CDS Copy Expanding a CDS - Scenario Relocating an Uncataloged CDS CopyCDS ENABLE DSNACS.DBASENEW NEWLOC CDS EXPAND 56VM/HSC 6.0 System Programmer’s Guide Swapping Library Transports - New Model Types Control Data Set Recovery Common Recovery Functions Allocation of Control Data Sets Control Data Set Recovery TechniquesUser Control of Control Data Sets Dynamic Enable/Disable of Control Data Sets 4. Issue the command 62VM/HSC 6.0 System Programmer’s Guide Command FunctionsFigure 5. HSC Command Functions Overview Viewing the Interior Components of an LSM Controlling LSM Operating ModeControlling CAP Operating Mode •A VIew request is sent to the controlling LMU Chapter 2. Host Software Component Functions Utility FunctionsFigure 6. Utility Functions Overview Dual LMU Functionality LMU Server FunctionsIf the Master LMU Fails If the Standby LMU Fails HSC/LMU Software Combinations LMU Switchover MessagesAfter an LMU Switch Occurs Notes for the Example Adding New Stations to an ACSJCL to Add New Stations to an ACS Reconstructing a LIBGEN HSC Port Number Assignments Recovery Maintenance RequirementsDynamic LMU Connection Multiple TCP/IP Stack Implications TCP/IP to Transitioning Between 3270 and TCP/IP3270 to TCP/IP Recovering TCP/IP Communications Operator Intervention - Dual LMU Configuration Operator Intervention - Single LMU ConfigurationCommunication Lost to Master LMU Communication Lost to Standby LMU System Definition File ACS SYSDEF Configuring VM for TCP/IP SupportSystem Profile File ACS SYSPROF HSC Startup Job File ACS SLKJCL Commands to Format OS Minidisk Initializing the LMUPATH Definition Data SetCommands to Format CMS Reserved Minidisk Minidisk Statement for the LMUPATH Data Set JOB SLSXUTIL SLUGENER /PARM RECCOPY LMUPATH Definition Data SetFILE SYSPRINT DEV PRNT CLASS A FILE SYSUT2 DEV <vaddr> DSN <dsname> /FILE SYSUT1 Types of Communications Services Host-to-HostCommunications ServicesCommunication Functions Information Passed Between Hosts Chapter 2. Host Software Component Functions How Communications Services are Set or Changed Switching Communications Paths Software Requirements Tape Management Interface 82VM/HSC 6.0 System Programmer’s Guide Batch Application Program Interface API Defining PARMLIB Control Statements OverviewPARMLIB Control Statements Options Offered by PARMLIB Control Statements Processing PARMLIB Control StatementsCAP Preference Definition Control Data Set Definition EXECPARM Control Definition Communications Path DefinitionJournal Data Set Definition License Key Information Reconfiguration CDS Definition Control Statement Continuation ConventionsOption Control Scratch Subpool Control Syntax CDSDEF CDS Definition CDSDEF Control Statement Control Statement Name CDSDEFParameters DISABLE DSN3SLS.DSTBY,VOL3HSC103,UNIT3503,+ DISABLE ExampleCDSDEF CDSDEF DSN1SLS.DBASE,VOL1HSC101,UNIT1501,+ Syntax EXECParm EXECParm Control StatementControl Statement Name EXECParm EXECParm EXECParm Control Statement - Command Prefix OffHOSTID Example Journal Definition JRNDEF Control Statement JRNDEFSyntax Control Statement Name UNITx JRNDEFFULL Abend Command Name LKEYDEF LKEYDEF Command and Control StatementParameter Descriptions dataset-name unitname LKEYDEFhost-id UNIT product-identifier LKEYINFOcustomer-name nnnnnnn LKEYINFO license-key-stringExamples Syntax RECDEFControl Statement Name RECDEF Example RECDEFRECDEF DSN1SLS.DBASE,VOL1HSC101,UNIT1501,+ DSN2SLS.DBSEC,VOL2HSC102,UNIT2502 Syntax SCRPOol Scratch Subpool Control StatementControl Statement Name SCRPOol RANGE SCRPOolNotes LABEL Example Other Methods of Controlling Scratch SubpoolsSCRPOol Definition Data Set Control Statements LMU Path OPTion TITLELMU Parameter Definition Scratch Subpool Parameter Statement Definition Defining Tape Request Attributes TAPEREQ Defining LMU Network ConnectionsVolume Attribute Volume Attribute Definition Defining Unit Attributes UNITATTR Defining Volume Attributes VOLATTR Control Statement Continuation Conventions Identifying the Definition Data Sets OPTION TITLE LMUPATH Usage LMUPATH LMUPATH Control StatementSyntax Control Statement Name lmu_hostname LMUPATHnnn.nnn.nnn.nnn LMUADDR 110VM/HSC 6.0 System Programmer’s Guide LMUPDEF LMUPDEF Command and Control Statement dataset.name LMUPDEFSyntax Control Statement Name Load the LMUPATH Parameters From YOUR.DSNMEMBER LMUPDEFunitname host-id identifying-string OPTion TITLE OPTion TITLE Control StatementSyntax Control Statement Name Example OPTion TITLE114VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - SCRPDEF Syntax SCRPDEFControl Statement Name Parameters SCRPDEF Load the SCRPOol Parameters From YOUR.DSNMEMBERunitname host-id TAPEREQ Usage TAPEREQ Tape Request TAPEREQ Control Statement Disabling a TAPEREQ Definition TAPEREQ 120VM/HSC 6.0 System Programmer’s Guide TAPEREQ TAPEREQ TAPEREQSyntax 122VM/HSC 6.0 System Programmer’s Guide Syntax continuedTAPEREQ step-name job-nameTAPEREQ Control Statement Name DD-name program-nameTAPEREQ PROGram or PGMname expiration-date retention-periodTAPEREQ EXPDT LONGItud TAPEREQStandard ECART ZCART TAPEREQDD3A, DD3B, DD3C STK1 RECtech TAPEREQNotes LONGItud 36Atrack TAPEREQ STK1RC TAPEREQ 4490 subpool-nameTAPEREQ TAPEREQ Set Tape Request AttributesExample 132VM/HSC 6.0 System Programmer’s Guide TREQDEF Syntax TREQDEFControl Statement Name Parameters TREQDEF Load the TAPEREQ Parameters From YOUR.DSNMEMBERunitname host-id UNITATTR Usage UNITATTRUnit Attribute UNITATTR Control Statement unit-address UNITATTRSyntax Control Statement Name MODel UNITATTR UNITATTR Specify Unit Attribute StatementsT9940B35 IGNORE 140VM/HSC 6.0 System Programmer’s Guide UNITDEF Syntax UNITDEFControl Statement Name Parameters host-id UNITDEFExamples Specify a Data Set Containing UNITATTR Statements VOLATTR Usage Volume Attribute VOLATTR Control StatementVOLATTR 144VM/HSC 6.0 System Programmer’s Guide Disabling a VOLATTR DefinitionVOLATTR VOLATTR This syntax diagram is continued on the next pageSyntax VOLATTR SERial volser Syntax continued VOLATTRControl Statement Name VOLATTR VOLATTR volser or vol-rangeor vol-listParameters SERial Valid media types are VOLATTR ZCART VOLATTRDD3A, DD3B, DD3C, DD3D STK1 STK2P, STK2W VOLATTRRECtech LONGItud indicates a 9490 Timberline transport VOLATTR STK1RC34 use-limitVOLATTR VOLATTR Set Volume AttributesExample VOLATTR SERIALL*,AA9* MEDIAECART 154VM/HSC 6.0 System Programmer’s Guide VOLDEF Syntax VOLDEFControl Statement Name Parameters VOLDEF Load the VOLATTR Parameters From YOUR.DSNMEMBERunitname host-id PARM Statement Creating an SLKJCL File for Starting the HSCPARM Statement Parameters Syntax COLD RESETSSYS Member RECONFIGDialog Both HSC Startup Job ACS SLKJCL Example Sample ACS SLKJCL File SLSSYSXX Description of /FILE StatementNotes Starting HSC Execution Configuration MismatchesModifying LSMs Online Specifying CAP Preferences 164VM/HSC 6.0 System Programmer’s Guide Multiple Hosts Startup Considerations Starting the HSC Syntax for Initializing HSC to Full Service Level Initializing the HSC to the Full Service Level Syntax for Initializing HSC to Base Service Level Initializing the HSC to the Base Service Level 1st ed., 6/30/04 - 168VM/HSC 6.0 System Programmer’s Guide Overview of Library Utilities Chapter 4. Utility Functions Utility to Use Selecting a UtilityFunction Restore or recreate the library CDS Typical Use of Utilities Utility Environmental Requirements Control Statement Syntax ConventionsUtility Syntax Conventions ACS UTIL Exec ACSCMS EXEC CMS Environment ACSUTIL SLKJCL file SCP Environment SCP Batch Job Control Language JCL JCL and Control StatementsJOB Statement jobname parms PARM StatementCOMM Statement comments fname Submitting Jobsftype fmode Control Statements vs. JCL Utility Control Statements How to Invoke SLUADMIN Utility Administrator SLUADMIN SLUADMIN Program Return Codes How to Invoke Utility ProgramsReturn Code Description Parameters Controlling Report Headings Reports Created by UtilitiesReport Headings Example Example of JCL Using Report Heading OptionsDATE=2YR DATE=4YR Stand-AloneUtilities Activities Report Activities Report UtilitySLUACTV EXEC type Activities Report SLSSMF fname ftype fmodePARM MIXED Utility Name SyntaxParameters begin-date end-time end-dateActivities Report TODAY Control File Example Invoking the Activities Report UtilityOutput Description Control File to Produce an Activities Report Total Activities Report % of all Activities ReportAve. time Ave. pass-thrus Activities Report Usage NotesEarliest Latest •LSM operating statistics record, subtype 1, and Activities Report ACS ID Activities ReportARM USE P-THRU 196VM/HSC 6.0 System Programmer’s Guide Activities ReportUsage Notes Figure 9. Activities Report Utility Sample Output Activities ReportChapter 4. Utility Functions 1st ed., 6/30/04 - Audit Audit Utility Audit Media Type Mismatch Conditions Audit Actions Permitted During an AuditHow the AUDIt Utility Functions Audit Concurrent Audits Audit acs-idSyntax Utility Name panel-list lsm-listAudit PANel column-list row-listAudit Notes Audit cap-id EMPTYCel AuditDIAGScan Notes Invoking the Audit Utility JCL RequirementsACSUTIL SLKJCL File Audit JCL for Audit of Entire Library all ACSs JCL ExamplesJCL for Selective Audit 1 ACS, 2 LSMs, with CAPid Audit JCL for Selective Audit of Empty Cells JCL for Selective Audit of Diagnostic Cells OnlyAudit Output Description Figure 10. AUDIt Utility Sample Output Audit210VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Backup Backup UtilityReasons for Running the BACKup Utility Prerequisites Backup How the BACKup Utility Functions Backup Backup Procedure BACKup BackupSyntax Utility Name Primary BackupSecondary STandby Restart Backup SLSPRINT Backup JCL RequirementsSLSCNTL SLSCNTL2 ACSUTIL SLKJCL File Backup Invoking the BACKup Utility JCL for Running Backup Backup JCL ExamplesRun Backup Utility JCL for Running a Copy Backup •the following data sets BackupOutput Description •a condition code from backup processing Backup4warning MESSAGES – Backup successful Chapter 4. Utility Functions Figure 11. BACKup Utility Sample Output 1 of Backup222VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Figure 11. BACKup Utility Sample Output 2 of BackupChapter 4. Utility Functions 1st ed., 6/30/04 - 224VM/HSC 6.0 System Programmer’s Guide Backup How to Restart BackupRelated Utilities Database Decompile Database Decompile LIBGEN UtilityHow the Database Decompile Utility Functions Prerequisites Utility Name Database Decompile SyntaxParameters JCL Requirements JCL Example Invoking the Database Decompile UtilityJCL for Database Decompile Database Decompile Device Database Decompile Output DescriptionLabel Description 1st ed., 6/30/04 - Database DecompileChapter 4. Utility Functions 1st ed., 6/30/04 - Database Decompile230VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Database DecompileChapter 4. Utility Functions 1st ed., 6/30/04 - Database Decompile232VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Database DecompileChapter 4. Utility Functions 1st ed., 6/30/04 - Database Decompile234VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Database DecompileChapter 4. Utility Functions Directory Rebuild Directory Rebuild UtilityReasons for Running the Directory Rebuild Utility How the Directory Rebuild Utility Functions Invoking the Database Decompile Utility Directory RebuildSLSCNTL, SLSCNTL2, SLSSTBY SLSIN Output Description Directory Rebuild JCL ExampleJCL for Directory Rebuild Syntax Eject Cartridge UtilityEject Cartridge Utility Name Eject CartridgeEJECt Eject Method 2 continued vol-list Eject Cartridge Parameterscount VOLser •CST •MEDIA1 •STD •1 •3480 Eject Cartridge Note: STK2P can be abbreviated to P Eject Cartridge indicates a 3490E-image9840 transport Eject Cartridge Eject Cartridge cap-list Eject Cartridge Invoking the Eject Cartridge UtilityJCL Requirements ACSUTIL SLKJCL File JCL to Eject One STD Scratch Cartridge JCL for Ejecting a Single VolumeJCL to Eject Five SD-3Scratch Cartridges Eject Cartridge 248VM/HSC 6.0 System Programmer’s Guide Eject Cartridge Output DescriptionFigure 13. EJECt Cartridge Utility Sample Output Enter Cartridges Enter Cartridges UtilityCAP Operating Instructions Syntax Enter Cartridges Invoking the Enter Cartridges UtilityJCL Requirements SCRatch Enter Cartridges JCL for Entering Cartridges in a CAPJCL Example Output Description Figure 14. Enter Cartridge Utility Sample Output Enter Cartridges252VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Journal Offload Journal Offload UtilitySyntax Utility Name Journal Offload Invoking the Journal Offload UtilitySLSOFF02 SLSIN Output Description Journal Offload JCL ExampleJCL for Offload of Journals Figure 15. Journal Offload Utility Sample Output Journal Offload256VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - MOVe Considerations Move UtilityMove Move lsm-idSyntax Utility Name Move panelrow-list column-list ACSUTIL SLKJCL File Move JCL RequirementsInvoking the Move Utility Output Description Move Several Volumes From an LSM to Another LSMMove JCL Examples Figure 16. MOVe Utility Sample Output Move262VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Performance Log Reblocker Performance Log Reblocker UtilitySyntax CMS Statement Performance Log Reblocker utility Performance Log Reblocker Performance Log Reblocker mvsnodeJCL Requirements class Reasons for Running the Reconfiguration Utility Reconfiguration UtilityReconfiguration Reconfiguration Considerations Before Running ReconfigurationDASD Considerations in a VM-onlyEnvironment 268VM/HSC 6.0 System Programmer’s Guide How the Reconfiguration Utility FunctionsReconfiguration Reconfiguration I/O ConsiderationsCondition Number of I/Os Minimizing I/O Time Running a Successful ReconfigurationReconfiguration Notes 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 Reconfiguration Restore Restore UtilityReasons for Running the RESTore Utility How the RESTore Utility Functions RESTore RestoreUtility Name Parameters JCL Requirements RestoreOnly Short ACSUTIL SLKJCL File Restore Invoking the Restore UtilityJCL Examples JCL for RESTore with GENerate Only JCL for RESTore with Journals AppliedRestore 280VM/HSC 6.0 System Programmer’s Guide Output Description JCL for RESTore Journals and Output to SLSAUDITRestore Figure 17. Restore Utility Sample Output Restore282VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Restore How to Handle BACKup/RESTore Discrepancies How the Scratch Redistribution Utility Functions Scratch Redistribution UtilityScratch Redistribution Utility Name Scratch Redistribution SyntaxSCREdist Chapter 4. Utility Functions tolerance-value Scratch Redistribution Parametersacs-id lsm-list expnumlsm Scratch Redistribution indicates any Standard, ECART, or ZCART cartridge Scratch Redistribution indicates any T9840 cartridge Scratch Redistribution Scratch Redistribution indicates a device using helical recording indicates any T9940A transport Scratch Redistribution Invoking the Scratch Redistribution Utility Scratch Redistribution JCL RequirementsJCL Examples ACSUTIL SLKJCL File Scratch Redistribution JCL to Perform Scratch RedistributionJCL to Perform Scratch Redistribution JCL to Perform Scratch Redistribution 294VM/HSC 6.0 System Programmer’s Guide Scratch Redistribution Output Description Scratch Update Scratch Update UtilitiesUtility Names SCRAtch utility Invoking the Scratch Update Utilities Scratch Update ParametersJCL Requirements vol-list Scratch Update JCL to Scratch, Unscratch, and ReplaceJCL Example Output Description Figure 19. Scratch Update Utilities Sample Output Scratch Update298VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - SET Utility SET Option How the SET Utility FunctionsAffected HSCs All Other HSCs Summary of SET Utility Options Considerations Before Running the SET Utility SET Utility Function and Location of Description SET Option Chapter 4. Utility Functions Set SyntaxNote: This syntax is continued on the next page esoteric SET ACS EsotericUtility Name Parameters SET CLNPRFX PROCEDURE SET Cleaning PrefixSET HSC Command Prefix prefix Description Character SET Delete Disposition SET Eject PasswordSCRTCH NOSCRTCH FREEZE oldpswdSET Freeze Panel newhost SET Host IDoldhost SET HSC Level qname SET ENQ/DEQ/RESERVE QNAMESET New Host model-host SET Device Numbers for Drives SET Scratch Label Typeesoteric FORHOST addr0,...addr19 FORLSMID Running SET SLIDRIVS With the HSC Activelsm-id FORPANEL SET LMU Station Address Numbers SET SLIDRIVS Procedurestat1,...,stat16 SLISTATN SET SMF Record Type SET Recovery Techniquelibtype FORACS JCL Requirements SET TCHNIQE PROCEDURESHADOW BOTH ACSUTIL SLKJCL File Invoking the Set Utility JCL for Set Utility Set JCL Examples Output Description JCL for Multiple SET Statements Syntax Unselect UtilityUnselect Invoking the Unselect Utility Unselect Utility NameParameters JCL Requirements Unselect JCL to Unselect a VolumeJCL Example Output Description Figure 20. Unselect Utility Sample Output UnselectChapter 4. Utility Functions 1st ed., 6/30/04 Volume Report Volume Report Utility Volume Report Media Type and Recording Technique Considerations •change the VOLATTR statements Volume Report Volume Report Syntax volser or vol-range or vol-list Volume Report Utility NameParameters acs-id SORT Volume Report INCLude Volume Report MEDEQUAL Volume ReportNONMEDEQ NOEXTernal VOLIST Volume ReportVOLDATA CDSDATA Volume Report JCL/Parameter File RequirementsSLSCNTL, SLSCNTL2, SLSSTBY SLSPRINT SLSCNTL JCL/Parameter File Syntaxvaddr control.set.name keywords fn, ft, fmSLSCDATA CMS only SLSSCRPL CMS only PARM SLSVA CMS onlyparameters JOB SCP only SLUVOLR EXEC CMS Volume Report Invoking the Volume Report UtilityParameter File ACSUTIL SLKJCL File JCL Example JCL to Produce a Volume ReportVolume Report Report Detail Lines JCL to Produce a Volume Report for an MVS PDSMedia and Recording Technique Origin Volume Report Errant, Scratch, Selected Fields Media Type Prefix CharactersExternal Label Field Cartridge Usability CLN USE Field Subpool ID Field Volume Report TotalsTimes Selected Field Totals Reports Volume Report Volume Report Flat Files 1st ed., 6/30/04 - Volume ReportChapter 4. Utility Functions 1st ed., 6/30/04 - Volume Report344VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Volume ReportChapter 4. Utility Functions 1st ed., 6/30/04 - 346VM/HSC 6.0 System Programmer’s Guide Abend Codes MessagesHSC Messages SCP Messages CCWTRACE Software Trace FacilitiesCP Trace Table SCP SET TRACE Command VM CP Debug CommandsTRACE Command Syntax SCP Internal Trace Table Trace Table Entries Master Trace Table Header DSP Trace Entry Query Code TTEWORD1 IPARML IUCV Parameter List= IRT address TTEWORD2 = IPARML bytes Inputs IPARML for IUCV CONNECT to *BLOCKIO Inputs IPARML for IUCV SEND to *BLOCKIO=target class 1=write; 2=read =flags type=2way =relative block number =data buffer address Inputs IPARML for IUCV RECEIVE= target class = flags Inputs IPARML for IUCV REPLY= IUCV message id = target class Inputs IPARML for IUCV SEVER= name of virtual machine connected to Outputs IPRCODE Interrupt Type IUCV Interrupt BufferIPTYPE IPARML for Pending Connection Interrupt IPARML for Connection Complete Interrupt = IUCV path id IPPATHIDIPTYPE = 03=severed, 04=quiesced, 05=resumed IPARML for Incoming Message Interrupt IPARML for Message Complete Interrupt Error Recording Data Set Records Diagnostic CapabilitiesSCP Trace Facility Supervisor Call and Abnormal End Dumps SCP External Trace Facility EXEC SCP Trace Formatter UtilitySLUETRAC 368VM/HSC 6.0 System Programmer’s Guide inft infninfm outfn 1st ed., 6/30/04 - Supervisor Call SVC Functions370VM/HSC 6.0 System Programmer’s Guide Function Refer to TableDecimal SCP GTRACE Emulation The valid EID ranges are HSC Internal Trace Table Figure 23. HSC Internal Trace Table Example Format of HSC GTRACE USR Records HSC TRACE Command VM CP Commands Diagnostic CommandsSetting Initialization Sequence Break-Points SCP Debug Mode length offset =DEBUG SCP Diagnostic Subsystem CommandsEnabling the Diagnostic Subsystem fieldname =NODEBUG=DDICT epname =HPERoffset length epname =WHEREaddress LIst Command HSC Diagnostic CommandsSyntax Parameters data-structure address DISPLAY Commandsize Control Data Set Recovery CDS Recovery CapabilitiesDynamic Recovery of the Control Data Set 1st ed., 6/30/04 - 386VM/HSC 6.0 System Programmer’s Guide Figure 24. Control Data Set Recovery Scheme Control Data Set Processes Control Data Set Error Diagnostics Detecting Mismatch of Control Data Sets Control Data Set Integrity During Restore Information Required for StorageTek Diagnosis Recommended Recovery Actions Type of Dumps Supported How to Request a DumpDump Processing Note Reason For Dump What to do When a Dump Occurs Call StorageTek Software Support Move Problem Materials to TapeLoad Dump and CONSLOG Onto Disk Dump Analysis Using SLUIPCS VIEW SLUIPCS SCAN SubcommandsVIEW CVT VIEW CCVT VIEW NUCON VIEW MTT VIEW STORMAN VIEW LVT VIEW structname Data Structures Data Structures IHAASCB FIND EX EXECUTE CMS COMMANDTRB SAVE AREA TRACEBACK TTE TRACE TABLE ENTRY WN WHERE NAME WA WHERE ADDRESSSTAT STATUS TASK FIND TASK SLUIPCS PRINT Options Major SCP Data Relationships Figure 25. Command, Message and Trace Processing Command, Message, Trace Processing1st ed., 6/30/04 - NUCON X’10’ VECTPTR TRCTAB Subsystem Data Relationships Diagnostic TechniquesSCP Task/Job Data Relationships NUCON JBLOK PSAAOLD JBLTASK TBLOK PSATOLD Figure 26. SCP Task/Job Data RelationshipTKRBLIST RQBLOK 404VM/HSC 6.0 System Programmer’s Guide Figure 27. Subsystem Data RelationshipsNUCON CVT VECTPTR CVTJESCT JESCT JESSSCT SSCT SSCTSCTA SSCTSSVT SSCT Find a Module Plus Offset, Given an Address Common Dump Analysis TasksFind a Module Address, Given a Name View an HSC or SCP Data Area Find the Failing Request Block Identify the Failing RoutineFind the Failing Task Find the LVT Save Area Trace BackFind the LCT, LST, HST Identify the Last Interrupt Event Diagnostic Materials Gather Diagnostic MaterialsExamine an SDWA Find IUCV Path Descriptors details of problem circumstances •STKACS abend Tape Return Tape Format Overview Chapter 6. Performance ConsiderationsHow Library Activity Affects Library Performance How Operators Control Library Performance Using the Activities Report UtilityMonitoring Library Activity and Performance ACS Daily Report Tape Volume Report Maintain Quantities of Scratch Cartridges Redistribute Scratch Volumes in the LibraryDefine CAP Preferences 414VM/HSC 6.0 System Programmer’s Guide Use PARMLIB to Define Static Parameters Use SMF Records to Collect Performance DataOperator Command Performance Parameter Journal Definition Set High-Performance Host-to-HostCommunications Define High Dispatching Priority for the HSC 418VM/HSC 6.0 System Programmer’s Guide Functioning of Host-to-HostCommunicationsDesignation of Communication parameters Limit View Time to Maintain High Performance Define Secondary and Standby Control Data Sets Advantages of Using the VIew Command Excessive Use of VIew Command Affects PerformanceHow to Monitor Usage of the VIew Command 1st ed., 6/30/04 - Chapter 6. Performance Considerations Reduce Pass-Thrus Loading Cartridges Into the Library Unnecessary Pass-Thrus Unavoidable Pass-ThrusScheduled Pass-Thrus Ways to Reduce Pass-ThruActivity Ensure adequate free cells Reduce Operator InterventionEject through the CAP closest to the cartridge Redistribute cartridges during off-peaktimes Reduce Tape Transport Contention ACSPROP EXECPrefetch Enters Avoid Crashing Test Systems Usage Requirements Reduce Scheduling ContentionSyntax Parameters Use the Audit Utility Effectively Use Performance Log Reblocker to Format Data Use LSMs as Scratch Loaders in a Mixed ACS Syntax Flow Diagrams Commands Syntax ReferenceSpecifying Commands Variables Single Required Choice Flow Lines Repeat Symbol DefaultsSingle Optional Choice Default Value Value2 Value3 Fragment Syntax Continuation Fragments432VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Library Identification CAPid Formats How to Specify a CAPidLSM Model 4410 and PowderHorn LSM Model WolfCreek LSM Models 9360-050, 9360-075,and 00indicates one of the following 436VM/HSC 6.0 System Programmer’s Guide Ranges And Lists A00A0-A99A0 438VM/HSC 6.0 System Programmer’s Guide Control Statement Syntax Conventions 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 440VM/HSC 6.0 System Programmer’s Guide SCRPOOL NAME=STD36,RANGEAAA000AAA999ZZZ000ZZZ999 MODel, and RECtech parameters MEDia, RECtech, and MODel Parametersacs-id, lsm-id acs-id, lsm-id Mount acs-id, lsm-id VOLATTR 1st ed., 6/30/04 - LIBGEN Macros444VM/HSC 6.0 System Programmer’s Guide SLIALIST macro SLIACS macroSLIDLIST macro SLIDRIVS macros 1st ed., 6/30/04 - SLILIBRY macro446VM/HSC 6.0 System Programmer’s Guide SLIRCVRY macro SLILSM macroSLISTATN macro SLIRCVRY EXECParm control statement HSC Control StatementsJournal Definition JRNDEF control statement 448VM/HSC 6.0 System Programmer’s Guide LKEYINFO control statement LKEYDEF command and control statementLMUPATH control statement VOLumevolser Scratch Subpool SCRPOol control statement OPTion control statement450VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Tape Request TAPEREQ control statement 452VM/HSC 6.0 System Programmer’s Guide Tape Request TAPEREQ control statement continued Unit Attribute UNITATTR control statement 1st ed., 6/30/04 - Volume Attribute VOLATTR control statement454VM/HSC 6.0 System Programmer’s Guide STK1RA STK1RA34 STK1RA35 STK1RB STK1RB34 STK1RB35 1st ed., 6/30/04 - 456VM/HSC 6.0 System Programmer’s Guide ACTIvities Report utility UtilitiesAUDIt utility ACSacs-id Database Decompile LIBGEN utility BACKup utilityDirectory Rebuild DIRBLD utility EJECt utility Enter Cartridges utility EJECt utility continued Journal OFFLoad utility Reconfiguration utilityMOVe utility REPLace utility SCRAtch utility RESTore utility 462VM/HSC 6.0 System Programmer’s Guide Scratch Redistribution SCREdist utility Options SET utility Unselect utility UNSCratch utilitySET utility continued 464VM/HSC 6.0 System Programmer’s Guide Volume Report VOLRpt utility CDs Enable/Disable command Operator CommandsCLean command 466VM/HSC 6.0 System Programmer’s Guide DISMount command Display Acs Display commandDisplay ALl Display ALLOC Display COMMPath Display CmdDisplay DRives CMd COmmand 470VM/HSC 6.0 System Programmer’s Guide Display Drives continued Display LKEYDEF Display ExceptionsDisplay LMUPDEF Display LSM Display OPTion Display MONitorDisplay Requests 472VM/HSC 6.0 System Programmer’s Guide Display SCRatch Display SRVlev Display SCRPDEFDisplay Status 474VM/HSC 6.0 System Programmer’s Guide Display TREQDEF Display THReshld EJect command DRAin CAP commandDisplay Volume Display UNITDEF Eject Command continued Journal command ENter commandMODify command MONITOR command volser Mount commanddevaddr host-id 480VM/HSC 6.0 System Programmer’s Guide Volume MOVe commandMOVe Flsmlsm-id RECover Host command OPTion command and control statementRELease CAP command 482VM/HSC 6.0 System Programmer’s Guide SRVlev Service Level command SENter commandStop Monitoring STOPMN command SWitch command TRACELKP command TRace commandVary Station command 484VM/HSC 6.0 System Programmer’s Guide VIew command 486VM/HSC 6.0 System Programmer’s Guide Warn command LIst command HSC Diagnostic CommandsTRace command 1st ed., 6/30/04 AUTHorize Command SCP Operator CommandsCANCEL command CP Command HELP Command FILE CommandModify Command SCP Query Command 490VM/HSC 6.0 System Programmer’s Guide Reply CommandSET Command events destination STArt Command SLK CommandSTOP Command STOPSCP Command 1st ed., 6/30/04 - GCS Component Server CommandsSLKGCS Command ACS EXEC CMS Operator CommandsCMS HELP 494VM/HSC 6.0 System Programmer’s Guide CP Commands Appendix B. CP Commands and DIAGNOSE CodesCP Programming Services Overview 1st ed., 6/30/04 - IUCV496VM/HSC 6.0 System Programmer’s Guide Overview Appendix C. Record Formats Mapping Macros for LOGREC Records Mapping Macros for SMF RecordsMapping Macros for Batch API Records Type SMF Mapping Macros SMF Records SLSDVAR SMF Record FormatsCross Reference Type Table 33. SLSSFHDR Record Format SLSSFHDRType Length Type Table 33. SLSSFHDR Record Format ContinuedLength Label Type Table 33. SLSSFHDR Record Format ContinuedLength Label 504VM/HSC 6.0 System Programmer’s Guide Cross Reference Offset NameValue Appendix C. Record Formats SLSSBLOS SIGNED-FWORD Cross Reference Cross Reference SLSSCAPJ Cross Reference SLSSCAPN SLSSVSTA Appendix C. Record Formats Cross ReferenceSLSSVSTA Cross Reference SLSSMLSM SLSSLSB Table 39. SLSSLSB Record Format Continued Cross ReferenceType Length SLSSMF07 1.1 X’05’ CHARACTER CHAR CONST LENGTH 520VM/HSC 6.0 System Programmer’s Guide Cross Reference Appendix C. Record Formats SMF07MVU 522VM/HSC 6.0 System Programmer’s Guide SLSSMF08 524VM/HSC 6.0 System Programmer’s Guide Cross Reference LOGREC Mapping Macros LOGREC Records SLSSLHDR LOGREC Record Formats OFFSET Type Table 43. SLSSLHDR Record Format ContinuedLength Label Appendix C. Record Formats Cross ReferenceLTYPAREA 530VM/HSC 6.0 System Programmer’s Guide SLSSVLG1 532VM/HSC 6.0 System Programmer’s Guide Cross Reference SLSSBLOG 534VM/HSC 6.0 System Programmer’s Guide Cross Reference SLSSLLG1 CONST 1.. .... X’40’ 538VM/HSC 6.0 System Programmer’s Guide Cross Reference Appendix C. Record Formats LLG1NWSN SLSSLLG2 HEXSTRING Cross Reference Cross Reference SLSSLLG3 SLSSLLG4 544VM/HSC 6.0 System Programmer’s Guide Cross Reference SLSSLLG5 1... .... X’80’ Appendix C. Record Formats Cross ReferenceLLG5ACS SLSSLLG6 1... X’08’ SIGNED-FWORD Appendix C. Record Formats Cross ReferenceLLG6ACS 552VM/HSC 6.0 System Programmer’s Guide SLSSDJLR CHARACTER Cross Reference SLSSPSWI 556VM/HSC 6.0 System Programmer’s Guide Cross Reference Cross Reference SLSSRL00 Cross Reference SLSSRL01 SLSSHLG1 1. .... X’20’ Appendix C. Record Formats Cross ReferenceHLG1FLG1 Volume Report and Batch API Mapping Macros Volume Report and Batch API Records SLUVADAT Volume Report and Batch API Record Formats 1.. .... X’40’ HEXSTRING 1 ..1. X’12’ X’80’ Cross Reference 568VM/HSC 6.0 System Programmer’s Guide Appendix C. Record Formats LSMNADLS 570VM/HSC 6.0 System Programmer’s Guide SLUVCDAT 1 X’01’ Appendix C. Record Formats Cross ReferenceCFGCCPFX SLUVHDAT 1.. .... X’40’ 576VM/HSC 6.0 System Programmer’s Guide Cross Reference SLUVIDAT CHARACTER Appendix C. Record Formats Cross ReferenceCDSALL SLUVSDAT Appendix C. Record Formats Cross ReferenceSTNACS SLUVVDAT CHAR CONST CHARACTER CHARACTER X’20’ HEXSTRING HEXSTRING Appendix C. Record Formats Cross ReferenceVOLDEST 590VM/HSC 6.0 System Programmer’s Guide Appendix C. Record Formats VOLRRCNL 592VM/HSC 6.0 System Programmer’s Guide Batch API Mapping Macros Batch API RecordsTable 64. Mapping macros for Batch API Records Appendix C. Record Formats SLUVDDAT Batch API Record Formats F0F1 Cross Reference 596VM/HSC 6.0 System Programmer’s Guide Appendix C. Record Formats UVD994B5‘CVAL’ 1st ed., 6/30/04 - SLUVPDAT SIGNED-HWORD 600VM/HSC 6.0 System Programmer’s Guide Cross Reference Offset NameValue UVPTWSTD 1st ed., 6/30/04 - 602VM/HSC 6.0 System Programmer’s Guide Appendix D. Logging ACS Robotics Motion Temporary Motion Error CountsInformation Being Logged Robotics Motion Start Counts 1st ed., 6/30/04 - Permanent Motion Errors604VM/HSC 6.0 System Programmer’s Guide Description of Field How Information is LoggedBYTE # 46-46 152-155 Description of Field Motion Hard Fail Software Error RecordBYTE # Logging Interval Multi-HostEnvironment Single-HostEnvironment LMU Response Codes Invalid Parameter Error Codes: 0101 - CAP Procedural Error Codes: 0301 - Configuration Error Codes: 0201 - General Procedural Error Codes: 0401 - 0426 LMU LAN Interface Error Codes: 0501 -Drive not rewound 0427 LMU Logical Error Codes: 0601 - LSM Robotics Error Codes: 0701 - LSM Logical Error Codes: 0901 - LSM Hardware Error Codes: 0801 - 0921 Undefined Response Code Drive Error Codes1012 Load Failure on Special Use Overview Appendix E. Remote-linkedLibrariesAppendix E. Remote-linkedLibraries 1st ed., 6/30/04 - 622VM/HSC 6.0 System Programmer’s Guide ConfigurationFigure 29. Configuration Appendix E. Remote-linkedLibraries ConfigurationMVS/CSC 624VM/HSC 6.0 System Programmer’s Guide ConfigurationFigure 30. Configuration Appendix E. Remote-linkedLibraries ConfigurationFigure 31. Configuration 626VM/HSC 6.0 System Programmer’s Guide ConfigurationFigure 32. Configuration Control Data Set Integrity Resolving CDS Issues After a Remote-LinkFailureProgramming and Operational Considerations •Prior to reestablishing the link How QCDS Functions QCDS RequestInvoking QCDS SLSUREQ Macro Overview SLSUREQ VM Requirements Addresses and RegistersVM Requirement label ParametersSyntax REQUEST This parameter is required BUFFER E,parmaddr QCDS Programming ConsiderationsNotes UCALADR Return Field Name Return CodesDecimal 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 1st ed., 6/30/04 - 640VM/HSC 6.0 System Programmer’s Guide RECORD AREAS IN AN ALTERNATING FASHION 642VM/HSC 6.0 System Programmer’s Guide PROCESS Records Returned Output DescriptionRequest Entered Syntax SLSUREQM MacroParameters PRO=NO|YES Batch API Mapping SLSUREQM Macro A-ADDR SIGNED-FWORD CONST CONST SLSUACSA Cross Reference 652VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 1st ed., 6/30/04 - 654VM/HSC 6.0 System Programmer’s Guide Glossary Central Support Remote Center CSRC— See Page directed allocation— See drive prioritization device separation— See drive exclusionPage Page Page Page Page Page Silverton— See 4490 Cartridge Subsystem Page Page Numerics Symbols 8500 library— See StreamLine SL8500 library 1st ed., 6/30/04 - 670VM/HSC 6.0 System Programmer’s Guide Index IndexNumerics 672VM/HSC 6.0 System Programmer’s Guide Index control data set definition control statement 674VM/HSC 6.0 System Programmer’s Guide 377, 383, 676VM/HSC 6.0 System Programmer’s Guide Index Library Control Unit LCU, defined CAP 468, 478, ACS 108,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 Index RECover Host command recovery functions 682VM/HSC 6.0 System Programmer’s Guide Index SRVlev command 684VM/HSC 6.0 System Programmer’s Guide Index 1st ed., 6/30/04 - 686VM/HSC 6.0 System Programmer’s GuidePage Printed in U.S.A