Scratch Redistribution Syntax, Utility Name

Scratch Redistribution

Syntax

SCREdist

ACS(acs-id)

LSM(

lsm-list

)

SUBpool(subpool-name)

BALtol(tolerance-value)MEDia(

LONGItud Standard

CST MEDIA1 STD

3480 ECART E ECCST ETAPE Long

MEDIA2

3490E ZCART Z HELical DD3 DD3A DD3B DD3C STK1 STK1R

STK2

STK2P

) RECtech(

LONGItud 18track 36track 36Atrack 36Btrack 36Ctrack HELical DD3 STK1R STK1R34 STK1R35

STK1RA

STK1RA34

STK1RA35

STK1RB

STK1RB34

STK1RB35

STK1RAB

STK1RAB4

STK1RAB5

STK1RC

STK1RC34

STK1RC35

STK2P

STK2P34

STK2P35

STK2PA

STK2PA34

STK2PA35

STK2PB

STK2PB34

STK2PB35

)

Utility Name

SCREdist

specifies that a scratch redistribution is to be performed.

Chapter 4. Utility Functions 285

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

Page 315

Image 315

StorageTek 6 manual Scratch Redistribution Syntax, Utility Name, SCREdist, Utility Functions

Contents

Host Software Component VM Implementation System Programmer’s GuideRelease 312579601 Proprietary Information Statement Export Destination Control StatementRestricted Rights Limitations on Warranties and Liability Document Effectivity Document EffectivityDoc Kit Number Host Software Component for 1st ed., 6/30/04 - ivVM/HSC 6.0 System Programmer’s Guide xxvii ContentsWhat’s New With This Release? Preface 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 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 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 Organization of This Guide PrefaceScope Intended Audience How to Use This Guide StorageTek Product Support References to HSC Product ReleasesRelated Publications Reader’s Comments 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 SERVERS APPLICATIONSCOMMON CONTROL VM Operating System CP and CMS VM Environment File Management System Control Program SCPStorage Management Device Management Communication Task ManagementJob Management Processor Management Tape Management System TMS Virtual Machine ConfigurationTask Recovery/Termination Host Software Component HSC 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 PARMLIB Control Statements User Control of HSC FunctionsMacros Utilities Commands 1st ed., 6/30/04 - 18VM/HSC 6.0 System Programmer’s Guide 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 Full CommandService Level Execution Base Full Service Level ExecutionUtility Base Starting the HSC Subsystem at Base Service Level Displaying/Setting 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 Scratch Selection Specific Volume RequestsNonspecific Volume Requests Precedence of VOLATTR and TAPEREQ Statements 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 Tape Management Interface HSC Mount Command SupportExample of Mount Command with Readonly Operand Virtual Thumbwheel VTW Tape Transport Cleaning Automated Tape Transport CleaningActivating Automated Cleaning Identifying Cleaning Cartridges NotesNotes 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 Ejecting Cartridges from the Library CAP Mode ConsiderationsCAP Exception Processing 48VM/HSC 6.0 System Programmer’s Guide Releasing an Allocated CAP Near Continuous Operations Using Multiple CDS Copies 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 Renaming a CDS Copy Using CDS Rename/Relocate/ExpandCDs Command Renaming/Relocating a CDS - Scenarios CDS EXPAND Relocating an Uncataloged CDS CopyExpanding a CDS - Scenario CDS ENABLE DSNACS.DBASENEW NEWLOC 56VM/HSC 6.0 System Programmer’s Guide Swapping Library Transports - New Model Types Control Data Set Recovery Common Recovery Functions 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 If the Standby LMU Fails LMU Server FunctionsDual LMU Functionality If the Master 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 Communication Lost to Standby LMU Operator Intervention - Single LMU ConfigurationOperator Intervention - Dual LMU Configuration Communication Lost to Master LMU HSC Startup Job File ACS SLKJCL Configuring VM for TCP/IP SupportSystem Definition File ACS SYSDEF System Profile File ACS SYSPROF Minidisk Statement for the LMUPATH Data Set Initializing the LMUPATH Definition Data SetCommands to Format OS Minidisk Commands to Format CMS Reserved Minidisk FILE SYSUT2 DEV <vaddr> DSN <dsname> /FILE SYSUT1 LMUPATH Definition Data SetJOB SLSXUTIL SLUGENER /PARM RECCOPY FILE SYSPRINT DEV PRNT CLASS A Information Passed Between Hosts Host-to-HostCommunications ServicesTypes of Communications Services Communication Functions 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 Overview PARMLIB Control StatementsDefining PARMLIB Control Statements Control Data Set Definition Processing PARMLIB Control StatementsOptions Offered by PARMLIB Control Statements CAP Preference Definition License Key Information Communications Path DefinitionEXECPARM Control Definition Journal Data Set Definition Scratch Subpool Control Control Statement Continuation ConventionsReconfiguration CDS Definition Option Control Syntax CDSDEF CDS Definition CDSDEF Control Statement DISABLE CDSDEFControl Statement Name Parameters CDSDEF DSN1SLS.DBASE,VOL1HSC101,UNIT1501,+ ExampleDSN3SLS.DSTBY,VOL3HSC103,UNIT3503,+ DISABLE CDSDEF EXECParm EXECParm EXECParm Control StatementSyntax Control Statement Name Example EXECParm Control Statement - Command Prefix OffEXECParm HOSTID Control Statement Name JRNDEFJournal Definition JRNDEF Control Statement Syntax Abend JRNDEFUNITx FULL dataset-name LKEYDEF LKEYDEF Command and Control StatementCommand Name Parameter Descriptions UNIT LKEYDEFunitname host-id nnnnnnn LKEYINFOproduct-identifier customer-name license-key-string ExamplesLKEYINFO RECDEF RECDEFSyntax Control Statement Name DSN2SLS.DBSEC,VOL2HSC102,UNIT2502 RECDEFExample RECDEF DSN1SLS.DBASE,VOL1HSC101,UNIT1501,+ SCRPOol SCRPOol Scratch Subpool Control StatementSyntax Control Statement Name LABEL SCRPOolRANGE Notes Other Methods of Controlling Scratch Subpools SCRPOolExample Definition Data Set Control Statements Scratch Subpool Parameter Statement Definition OPTion TITLELMU Path LMU Parameter Definition Volume Attribute Definition Defining LMU Network ConnectionsDefining Tape Request Attributes TAPEREQ Volume Attribute Defining Unit Attributes UNITATTR Defining Volume Attributes VOLATTR Control Statement Continuation Conventions Identifying the Definition Data Sets OPTION TITLE Control Statement Name LMUPATH LMUPATH Control StatementLMUPATH Usage Syntax LMUADDR LMUPATHlmu_hostname nnn.nnn.nnn.nnn 110VM/HSC 6.0 System Programmer’s Guide LMUPDEF LMUPDEF Command and Control Statement Control Statement Name LMUPDEFdataset.name Syntax host-id LMUPDEFLoad the LMUPATH Parameters From YOUR.DSNMEMBER unitname Control Statement Name OPTion TITLE OPTion TITLE Control Statementidentifying-string Syntax 1st ed., 6/30/04 - OPTion TITLEExample 114VM/HSC 6.0 System Programmer’s Guide SCRPDEF Parameters SCRPDEFSyntax Control Statement Name host-id Load the SCRPOol Parameters From YOUR.DSNMEMBERSCRPDEF unitname TAPEREQ Usage TAPEREQ Tape Request TAPEREQ Control Statement Disabling a TAPEREQ Definition TAPEREQ 120VM/HSC 6.0 System Programmer’s Guide TAPEREQ TAPEREQ SyntaxTAPEREQ Syntax continued TAPEREQ122VM/HSC 6.0 System Programmer’s Guide Control Statement Name job-namestep-name TAPEREQ PROGram or PGMname program-nameDD-name TAPEREQ EXPDT retention-periodexpiration-date TAPEREQ ECART TAPEREQLONGItud Standard STK1 TAPEREQZCART DD3A, DD3B, DD3C LONGItud TAPEREQRECtech Notes 36Atrack TAPEREQ STK1RC TAPEREQ subpool-name TAPEREQ4490 132VM/HSC 6.0 System Programmer’s Guide Set Tape Request AttributesTAPEREQ Example TREQDEF Parameters TREQDEFSyntax Control Statement Name host-id Load the TAPEREQ Parameters From YOUR.DSNMEMBERTREQDEF unitname UNITATTR Unit Attribute UNITATTR Control StatementUNITATTR Usage Control Statement Name UNITATTRunit-address Syntax MODel UNITATTR IGNORE Specify Unit Attribute StatementsUNITATTR T9940B35 140VM/HSC 6.0 System Programmer’s Guide UNITDEF Parameters UNITDEFSyntax Control Statement Name Specify a Data Set Containing UNITATTR Statements UNITDEFhost-id Examples Volume Attribute VOLATTR Control Statement VOLATTRVOLATTR Usage Disabling a VOLATTR Definition VOLATTR144VM/HSC 6.0 System Programmer’s Guide VOLATTR SERial volser This syntax diagram is continued on the next pageVOLATTR Syntax VOLATTR VOLATTRSyntax continued Control Statement Name SERial volser or vol-rangeor vol-listVOLATTR Parameters Valid media types are VOLATTR STK1 VOLATTRZCART DD3A, DD3B, DD3C, DD3D LONGItud VOLATTRSTK2P, STK2W RECtech indicates a 9490 Timberline transport VOLATTR use-limit VOLATTRSTK1RC34 VOLATTR SERIALL*,AA9* MEDIAECART Set Volume AttributesVOLATTR Example 154VM/HSC 6.0 System Programmer’s Guide VOLDEF Parameters VOLDEFSyntax Control Statement Name host-id Load the VOLATTR Parameters From YOUR.DSNMEMBERVOLDEF unitname Syntax Creating an SLKJCL File for Starting the HSCPARM Statement PARM Statement Parameters RESET SSYSCOLD Both RECONFIGMember Dialog HSC Startup Job ACS SLKJCL Example Sample ACS SLKJCL File Description of /FILE Statement NotesSLSSYSXX Specifying CAP Preferences Configuration MismatchesStarting HSC Execution Modifying LSMs Online 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 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 ACSCMS EXEC CMS Environment ACSUTIL SLKJCL file SCP Environment jobname JCL and Control StatementsSCP Batch Job Control Language JCL JOB Statement comments PARM Statementparms COMM Statement fmode Submitting Jobsfname ftype Control Statements vs. JCL Utility Control Statements How to Invoke SLUADMIN Utility Administrator SLUADMIN Description How to Invoke Utility ProgramsSLUADMIN Program Return Codes Return Code Reports Created by Utilities Report HeadingsParameters Controlling Report Headings DATE=4YR Example of JCL Using Report Heading OptionsExample DATE=2YR Stand-AloneUtilities type Activities Report UtilityActivities Report SLUACTV EXEC MIXED SLSSMF fname ftype fmodeActivities Report PARM begin-date SyntaxUtility Name Parameters TODAY end-dateend-time Activities Report Control File to Produce an Activities Report Invoking the Activities Report UtilityControl File Example Output Description Total Activities Report Ave. pass-thrus Activities Report% of all Ave. time Latest Usage NotesActivities Report Earliest •LSM operating statistics record, subtype 1, and Activities Report P-THRU Activities ReportACS ID ARM USE Activities Report Usage Notes196VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Activities ReportFigure 9. Activities Report Utility Sample Output Chapter 4. Utility Functions Audit Audit Utility Audit Media Type Mismatch Conditions Actions Permitted During an Audit How the AUDIt Utility FunctionsAudit Audit Concurrent Audits Utility Name acs-idAudit Syntax PANel lsm-listpanel-list Audit Notes row-listcolumn-list Audit Audit cap-id Notes AuditEMPTYCel DIAGScan Audit JCL RequirementsInvoking the Audit Utility ACSUTIL SLKJCL File Audit JCL ExamplesJCL for Audit of Entire Library all ACSs JCL for Selective Audit 1 ACS, 2 LSMs, with CAPid Output Description JCL for Selective Audit of Diagnostic Cells OnlyJCL for Selective Audit of Empty Cells Audit 1st ed., 6/30/04 - AuditFigure 10. AUDIt Utility Sample Output 210VM/HSC 6.0 System Programmer’s Guide Prerequisites Backup UtilityBackup Reasons for Running the BACKup Utility Backup How the BACKup Utility Functions Backup Backup Procedure Utility Name BackupBACKup Syntax STandby BackupPrimary Secondary Restart Backup SLSCNTL2 Backup JCL RequirementsSLSPRINT SLSCNTL ACSUTIL SLKJCL File Backup Invoking the BACKup Utility JCL for Running a Copy Backup Backup JCL ExamplesJCL for Running Backup Run Backup Utility Backup Output Description•the following data sets Chapter 4. Utility Functions Backup•a condition code from backup processing 4warning MESSAGES – Backup successful 1st ed., 6/30/04 - BackupFigure 11. BACKup Utility Sample Output 1 of 222VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - BackupFigure 11. BACKup Utility Sample Output 2 of Chapter 4. Utility Functions Backup How to Restart Backup Related Utilities224VM/HSC 6.0 System Programmer’s Guide Prerequisites Database Decompile LIBGEN UtilityDatabase Decompile How the Database Decompile Utility Functions JCL Requirements Database Decompile SyntaxUtility Name Parameters Database Decompile Invoking the Database Decompile UtilityJCL Example JCL for Database Decompile Description Database Decompile Output DescriptionDevice Label 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 - How the Directory Rebuild Utility Functions Directory Rebuild UtilityDirectory Rebuild Reasons for Running the Directory Rebuild Utility SLSIN Directory RebuildInvoking the Database Decompile Utility SLSCNTL, SLSCNTL2, SLSSTBY Directory Rebuild JCL Example JCL for Directory RebuildOutput Description Eject Cartridge Utility Eject CartridgeSyntax Eject Method 2 continued Eject CartridgeUtility Name EJECt VOLser Eject Cartridge Parametersvol-list count •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 ACSUTIL SLKJCL File Invoking the Eject Cartridge UtilityEject Cartridge JCL Requirements Eject Cartridge JCL for Ejecting a Single VolumeJCL to Eject One STD Scratch Cartridge JCL to Eject Five SD-3Scratch Cartridges Eject Cartridge Output Description Figure 13. EJECt Cartridge Utility Sample Output248VM/HSC 6.0 System Programmer’s Guide Syntax Enter Cartridges UtilityEnter Cartridges CAP Operating Instructions SCRatch Invoking the Enter Cartridges UtilityEnter Cartridges JCL Requirements Output Description JCL for Entering Cartridges in a CAPEnter Cartridges JCL Example 1st ed., 6/30/04 - Enter CartridgesFigure 14. Enter Cartridge Utility Sample Output 252VM/HSC 6.0 System Programmer’s Guide Utility Name Journal Offload UtilityJournal Offload Syntax SLSIN Invoking the Journal Offload UtilityJournal Offload SLSOFF02 Journal Offload JCL Example JCL for Offload of JournalsOutput Description 1st ed., 6/30/04 - Journal OffloadFigure 15. Journal Offload Utility Sample Output 256VM/HSC 6.0 System Programmer’s Guide Move Utility MoveMOVe Considerations Utility Name lsm-idMove Syntax column-list panelMove row-list Move JCL Requirements Invoking the Move UtilityACSUTIL SLKJCL File Move Several Volumes From an LSM to Another LSM Move JCL ExamplesOutput Description 1st ed., 6/30/04 - MoveFigure 16. MOVe Utility Sample Output 262VM/HSC 6.0 System Programmer’s Guide Performance Log Reblocker utility Performance Log Reblocker UtilityPerformance Log Reblocker Syntax CMS Statement Performance Log Reblocker class mvsnodePerformance Log Reblocker JCL Requirements 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 Number of I/Os I/O ConsiderationsReconfiguration Condition Notes Running a Successful ReconfigurationMinimizing I/O Time 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 Reconfiguration How the RESTore Utility Functions Restore UtilityRestore Reasons for Running the RESTore Utility Parameters RestoreRESTore Utility Name Short RestoreJCL Requirements Only Restore Invoking the Restore Utility JCL ExamplesACSUTIL SLKJCL File 280VM/HSC 6.0 System Programmer’s Guide JCL for RESTore with Journals AppliedJCL for RESTore with GENerate Only Restore JCL for RESTore Journals and Output to SLSAUDIT RestoreOutput Description 1st ed., 6/30/04 - RestoreFigure 17. Restore Utility Sample Output 282VM/HSC 6.0 System Programmer’s Guide Restore How to Handle BACKup/RESTore Discrepancies Scratch Redistribution Utility Scratch RedistributionHow the Scratch Redistribution Utility Functions Chapter 4. Utility Functions Scratch Redistribution SyntaxUtility Name SCREdist lsm-list Scratch Redistribution Parameterstolerance-value acs-id 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 ACSUTIL SLKJCL File Scratch Redistribution JCL RequirementsInvoking the Scratch Redistribution Utility JCL Examples JCL to Perform Scratch Redistribution JCL to Perform Scratch RedistributionScratch Redistribution JCL to Perform Scratch Redistribution 294VM/HSC 6.0 System Programmer’s Guide Scratch Redistribution Output Description SCRAtch utility Scratch Update UtilitiesScratch Update Utility Names vol-list Scratch Update ParametersInvoking the Scratch Update Utilities JCL Requirements Output Description JCL to Scratch, Unscratch, and ReplaceScratch Update JCL Example 1st ed., 6/30/04 - Scratch UpdateFigure 19. Scratch Update Utilities Sample Output 298VM/HSC 6.0 System Programmer’s Guide SET Utility All Other HSCs How the SET Utility FunctionsSET Option Affected HSCs Summary of SET Utility Options Considerations Before Running the SET Utility SET Utility Function and Location of Description SET Option Set Syntax Note: This syntax is continued on the next pageChapter 4. Utility Functions Parameters SET ACS Esotericesoteric Utility Name prefix SET Cleaning PrefixSET CLNPRFX PROCEDURE SET HSC Command Prefix Description Character NOSCRTCH SET Eject PasswordSET Delete Disposition SCRTCH oldpswd SET Freeze PanelFREEZE SET HSC Level SET Host IDnewhost oldhost model-host SET ENQ/DEQ/RESERVE QNAMEqname SET New Host FORHOST SET Scratch Label TypeSET Device Numbers for Drives esoteric addr0,...addr19 FORPANEL Running SET SLIDRIVS With the HSC ActiveFORLSMID lsm-id SLISTATN SET SLIDRIVS ProcedureSET LMU Station Address Numbers stat1,...,stat16 FORACS SET Recovery TechniqueSET SMF Record Type libtype BOTH SET TCHNIQE PROCEDUREJCL Requirements SHADOW ACSUTIL SLKJCL File Invoking the Set Utility JCL for Set Utility Set JCL Examples Output Description JCL for Multiple SET Statements Unselect Utility UnselectSyntax JCL Requirements Unselect Utility NameInvoking the Unselect Utility Parameters Output Description JCL to Unselect a VolumeUnselect JCL Example 1st ed., 6/30/04 UnselectFigure 20. Unselect Utility Sample Output Chapter 4. Utility Functions Volume Report Volume Report Utility Volume Report Media Type and Recording Technique Considerations •change the VOLATTR statements Volume Report Volume Report Syntax acs-id Volume Report Utility Namevolser or vol-range or vol-list Parameters SORT Volume Report INCLude Volume Report NOEXTernal Volume ReportMEDEQUAL NONMEDEQ CDSDATA Volume ReportVOLIST VOLDATA SLSPRINT JCL/Parameter File RequirementsVolume Report SLSCNTL, SLSCNTL2, SLSSTBY control.set.name JCL/Parameter File SyntaxSLSCNTL vaddr SLSSCRPL CMS only fn, ft, fmkeywords SLSCDATA CMS only JOB SCP only SLSVA CMS onlyPARM parameters ACSUTIL SLKJCL File Volume Report Invoking the Volume Report UtilitySLUVOLR EXEC CMS Parameter File JCL to Produce a Volume Report Volume ReportJCL Example Volume Report JCL to Produce a Volume Report for an MVS PDSReport Detail Lines Media and Recording Technique Origin Cartridge Usability CLN USE Field Media Type Prefix CharactersErrant, Scratch, Selected Fields External Label Field Totals Reports Volume Report TotalsSubpool ID Field Times Selected Field Volume Report Volume Report Flat Files 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 - 1st ed., 6/30/04 - 346VM/HSC 6.0 System Programmer’s Guide SCP Messages MessagesAbend Codes HSC Messages Software Trace Facilities CP Trace TableCCWTRACE SCP Internal Trace Table VM CP Debug CommandsSCP SET TRACE Command TRACE Command Syntax Trace Table Entries Master Trace Table Header DSP Trace Entry Query Code TTEWORD2 = IPARML bytes IPARML IUCV Parameter ListTTEWORD1 = IRT address Inputs IPARML for IUCV CONNECT to *BLOCKIO =relative block number =data buffer address IPARML for IUCV SEND to *BLOCKIOInputs =target class 1=write; 2=read =flags type=2way = flags IPARML for IUCV RECEIVEInputs = target class = target class IPARML for IUCV REPLYInputs = IUCV message id Outputs IPARML for IUCV SEVERInputs = name of virtual machine connected to IPRCODE IUCV Interrupt Buffer IPTYPEInterrupt Type IPARML for Pending Connection Interrupt IPARML for Connection Complete Interrupt = 03=severed, 04=quiesced, 05=resumed IPPATHID= IUCV path id IPTYPE IPARML for Incoming Message Interrupt IPARML for Message Complete Interrupt Supervisor Call and Abnormal End Dumps Diagnostic CapabilitiesError Recording Data Set Records SCP Trace Facility SCP External Trace Facility 368VM/HSC 6.0 System Programmer’s Guide SCP Trace Formatter UtilityEXEC SLUETRAC outfn infninft infm 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 Format of HSC GTRACE USR Records HSC TRACE Command SCP Debug Mode Diagnostic CommandsVM CP Commands Setting Initialization Sequence Break-Points length offset SCP Diagnostic Subsystem Commands Enabling the Diagnostic Subsystem=DEBUG =NODEBUG =DDICTfieldname length =HPERepname offset =WHERE addressepname data-structure HSC Diagnostic CommandsLIst Command Syntax Parameters DISPLAY Command sizeaddress CDS Recovery Capabilities Dynamic Recovery of the Control Data SetControl Data Set Recovery 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 How to Request a Dump Dump ProcessingType of Dumps Supported Note Reason For Dump What to do When a Dump Occurs Move Problem Materials to Tape Load Dump and CONSLOG Onto DiskCall StorageTek Software Support Dump Analysis Using SLUIPCS VIEW STORMAN VIEW LVT VIEW structname SLUIPCS SCAN SubcommandsVIEW VIEW CVT VIEW CCVT VIEW NUCON VIEW MTT Data Structures Data Structures IHAASCB TTE TRACE TABLE ENTRY EX EXECUTE CMS COMMANDFIND TRB SAVE AREA TRACEBACK TASK FIND TASK WA WHERE ADDRESSWN WHERE NAME STAT STATUS SLUIPCS PRINT Options Major SCP Data Relationships NUCON X’10’ VECTPTR TRCTAB Command, Message, Trace ProcessingFigure 25. Command, Message and Trace Processing 1st ed., 6/30/04 - Diagnostic Techniques SCP Task/Job Data RelationshipsSubsystem Data Relationships RQBLOK Figure 26. SCP Task/Job Data RelationshipNUCON JBLOK PSAAOLD JBLTASK TBLOK PSATOLD TKRBLIST JESCT JESSSCT SSCT SSCTSCTA SSCTSSVT SSCT Figure 27. Subsystem Data Relationships404VM/HSC 6.0 System Programmer’s Guide NUCON CVT VECTPTR CVTJESCT View an HSC or SCP Data Area Common Dump Analysis TasksFind a Module Plus Offset, Given an Address Find a Module Address, Given a Name Identify the Failing Routine Find the Failing TaskFind the Failing Request Block Identify the Last Interrupt Event Save Area Trace BackFind the LVT Find the LCT, LST, HST Find IUCV Path Descriptors Gather Diagnostic MaterialsDiagnostic Materials Examine an SDWA details of problem circumstances •STKACS abend Tape Return Tape Format Chapter 6. Performance Considerations How Library Activity Affects Library PerformanceOverview Using the Activities Report Utility Monitoring Library Activity and PerformanceHow Operators Control Library Performance ACS Daily Report Tape Volume Report 414VM/HSC 6.0 System Programmer’s Guide Redistribute Scratch Volumes in the LibraryMaintain Quantities of Scratch Cartridges Define CAP Preferences Performance Parameter Use SMF Records to Collect Performance DataUse PARMLIB to Define Static Parameters Operator Command Journal Definition Set High-Performance Host-to-HostCommunications Define High Dispatching Priority for the HSC Functioning of Host-to-HostCommunications Designation of Communication parameters418VM/HSC 6.0 System Programmer’s Guide Limit View Time to Maintain High Performance Define Secondary and Standby Control Data Sets Excessive Use of VIew Command Affects Performance How to Monitor Usage of the VIew CommandAdvantages of Using the VIew Command 1st ed., 6/30/04 - Chapter 6. Performance Considerations Reduce Pass-Thrus Loading Cartridges Into the Library Ways to Reduce Pass-ThruActivity Unavoidable Pass-ThrusUnnecessary Pass-Thrus Scheduled Pass-Thrus Redistribute cartridges during off-peaktimes Reduce Operator InterventionEnsure adequate free cells Eject through the CAP closest to the cartridge Avoid Crashing Test Systems ACSPROP EXECReduce Tape Transport Contention Prefetch Enters Parameters Reduce Scheduling ContentionUsage Requirements Syntax Use the Audit Utility Effectively Use Performance Log Reblocker to Format Data Use LSMs as Scratch Loaders in a Mixed ACS Variables Commands Syntax ReferenceSyntax Flow Diagrams Specifying Commands Single Required Choice Flow Lines Default Value Value2 Value3 DefaultsRepeat Symbol Single Optional Choice 1st ed., 6/30/04 - Syntax Continuation FragmentsFragment 432VM/HSC 6.0 System Programmer’s Guide Library Identification WolfCreek LSM Models 9360-050, 9360-075,and How to Specify a CAPidCAPid Formats LSM Model 4410 and PowderHorn LSM Model 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 SCRPOOL NAME=STD36,RANGEAAA000AAA999 ZZZ000ZZZ999440VM/HSC 6.0 System Programmer’s Guide acs-id, lsm-id MEDia, RECtech, and MODel ParametersMODel, and RECtech parameters acs-id, lsm-id Mount acs-id, lsm-id VOLATTR LIBGEN Macros 444VM/HSC 6.0 System Programmer’s Guide1st ed., 6/30/04 - SLIDRIVS macros SLIACS macroSLIALIST macro SLIDLIST macro SLILIBRY macro 446VM/HSC 6.0 System Programmer’s Guide1st ed., 6/30/04 - SLIRCVRY SLILSM macroSLIRCVRY macro SLISTATN macro 448VM/HSC 6.0 System Programmer’s Guide HSC Control StatementsEXECParm control statement Journal Definition JRNDEF control statement VOLumevolser LKEYDEF command and control statementLKEYINFO control statement LMUPATH control statement 1st ed., 6/30/04 - OPTion control statementScratch Subpool SCRPOol control statement 450VM/HSC 6.0 System Programmer’s Guide Tape Request TAPEREQ control statement 452VM/HSC 6.0 System Programmer’s Guide Tape Request TAPEREQ control statement continued 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 1st ed., 6/30/04 - 456VM/HSC 6.0 System Programmer’s Guide ACSacs-id UtilitiesACTIvities Report utility AUDIt utility EJECt utility BACKup utilityDatabase Decompile LIBGEN utility Directory Rebuild DIRBLD utility Enter Cartridges utility EJECt utility continued REPLace utility Reconfiguration utilityJournal OFFLoad utility MOVe utility SCRAtch utility RESTore utility 462VM/HSC 6.0 System Programmer’s Guide Scratch Redistribution SCREdist utility Options SET utility 464VM/HSC 6.0 System Programmer’s Guide UNSCratch utilityUnselect utility SET utility continued Volume Report VOLRpt utility 466VM/HSC 6.0 System Programmer’s Guide Operator CommandsCDs Enable/Disable command CLean command DISMount command Display ALLOC Display commandDisplay Acs Display ALl CMd COmmand Display CmdDisplay COMMPath Display DRives 470VM/HSC 6.0 System Programmer’s Guide Display Drives continued Display LSM Display ExceptionsDisplay LKEYDEF Display LMUPDEF 472VM/HSC 6.0 System Programmer’s Guide Display MONitorDisplay OPTion Display Requests Display SCRatch 474VM/HSC 6.0 System Programmer’s Guide Display SCRPDEFDisplay SRVlev Display Status Display TREQDEF Display THReshld Display UNITDEF DRAin CAP commandEJect command Display Volume Eject Command continued MONITOR command ENter commandJournal command MODify command host-id Mount commandvolser devaddr 480VM/HSC 6.0 System Programmer’s Guide Flsmlsm-id MOVe commandVolume MOVe 482VM/HSC 6.0 System Programmer’s Guide OPTion command and control statementRECover Host command RELease CAP command SWitch command SENter commandSRVlev Service Level command Stop Monitoring STOPMN command 484VM/HSC 6.0 System Programmer’s Guide TRace commandTRACELKP command Vary Station command VIew command 486VM/HSC 6.0 System Programmer’s Guide Warn command 1st ed., 6/30/04 HSC Diagnostic CommandsLIst command TRace command CP Command SCP Operator CommandsAUTHorize Command CANCEL command Query Command FILE CommandHELP Command Modify Command SCP Reply Command SET Command490VM/HSC 6.0 System Programmer’s Guide events destination STOPSCP Command SLK CommandSTArt Command STOP Command GCS Component Server Commands SLKGCS Command1st ed., 6/30/04 - 494VM/HSC 6.0 System Programmer’s Guide CMS Operator CommandsACS EXEC CMS HELP Overview Appendix B. CP Commands and DIAGNOSE CodesCP Commands CP Programming Services IUCV 496VM/HSC 6.0 System Programmer’s Guide1st ed., 6/30/04 - Overview Appendix C. Record Formats Type Mapping Macros for SMF RecordsMapping Macros for LOGREC Records Mapping Macros for Batch API Records SMF Mapping Macros SMF Records Type SMF Record FormatsSLSDVAR Cross Reference Length SLSSFHDRTable 33. SLSSFHDR Record Format Type Label Table 33. SLSSFHDR Record Format ContinuedType Length Label Table 33. SLSSFHDR Record Format ContinuedType Length 504VM/HSC 6.0 System Programmer’s Guide Cross Reference Appendix C. Record Formats NameOffset Value SLSSBLOS SIGNED-FWORD Cross Reference Cross Reference SLSSCAPJ Cross Reference SLSSCAPN SLSSVSTA Cross Reference SLSSVSTAAppendix C. Record Formats Cross Reference SLSSMLSM SLSSLSB Length Cross ReferenceTable 39. SLSSLSB Record Format Continued Type 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 Label Table 43. SLSSLHDR Record Format ContinuedType Length Cross Reference LTYPAREAAppendix C. Record Formats 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’ 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 CHARACTER Cross Reference SLSSPSWI 556VM/HSC 6.0 System Programmer’s Guide Cross Reference Cross Reference SLSSRL00 Cross Reference SLSSRL01 SLSSHLG1 1. .... X’20’ Cross Reference HLG1FLG1Appendix C. Record Formats 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’ Cross Reference CFGCCPFXAppendix C. Record Formats SLUVHDAT 1.. .... X’40’ 576VM/HSC 6.0 System Programmer’s Guide Cross Reference 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 Appendix C. Record Formats VOLRRCNL 592VM/HSC 6.0 System Programmer’s Guide Appendix C. Record Formats Batch API RecordsBatch API Mapping Macros Table 64. Mapping macros for Batch API Records SLUVDDAT Batch API Record Formats F0F1 Cross Reference 596VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - UVD994B5Appendix C. Record Formats ‘CVAL’ SLUVPDAT SIGNED-HWORD 600VM/HSC 6.0 System Programmer’s Guide Cross Reference UVPTWSTD NameOffset Value 1st ed., 6/30/04 - 602VM/HSC 6.0 System Programmer’s Guide Robotics Motion Start Counts Temporary Motion Error CountsAppendix D. Logging ACS Robotics Motion Information Being Logged 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 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 - 0427 LMU LAN Interface Error Codes: 0501 -0426 Drive not rewound LMU Logical Error Codes: 0601 - LSM Robotics Error Codes: 0701 - LSM Logical Error Codes: 0901 - LSM Hardware Error Codes: 0801 - 0921 Load Failure on Special Use Drive Error CodesUndefined Response Code 1012 1st ed., 6/30/04 - Appendix E. Remote-linkedLibrariesOverview Appendix E. Remote-linkedLibraries 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 Overview QCDS RequestHow QCDS Functions Invoking QCDS SLSUREQ Macro Addresses and Registers VM RequirementSLSUREQ VM Requirements REQUEST Parameterslabel Syntax This parameter is required BUFFER UCALADR QCDS Programming ConsiderationsE,parmaddr Notes Invalid SLSUREQ Requests Return CodesReturn Field Name Decimal Value and Description 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 Output Description Request EnteredRecords Returned PRO=NO|YES SLSUREQM MacroSyntax Parameters 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 NumericsIndex 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 678VM/HSC 6.0 System Programmer’s Guide ACS 108,CAP 468, 478, cap-id 466, 476, 478, 482, 483 cap-list 466, 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