SLILIBRY macro, 1st ed., 6/30/04 | StorageTek instruction

SLILIBRY macro

SLILIBRY macro

SLILIBRY HOSTID=(host-id0,host-id1,...,host-id15) ,ACSLIST=acslist

Optional Parameters

Optional Parameters:

CLN

,CLNPRFX= prefix

255

,SMF= libtype

,NNLBDRV=(esoteric0,...,esoteric15)

NOSCRTCH

,DELDISP= SCRTCH

STKALSQN

.

SL

,MAJNAME=

qname

,COMPRFX=

commandchar

,SCRLABL=

AL

NL

NSL

,EJCTPAS=password

446VM/HSC 6.0 System Programmer’s Guide

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

Image 476

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

Contents

System Programmer’s Guide Release312579601 Host Software Component VM Implementation Export Destination Control Statement Restricted RightsLimitations on Warranties and Liability Proprietary Information Statement Document Effectivity Doc Kit NumberHost Software Component for Document Effectivity ivVM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Contents What’s New With This Release?Preface xxvii Matching VOLATTR and TAPEREQ Statements Chapter 4. Utility Functions SCP Environment Invoking the BACKup Utility Utility Name Page Chapter 6. Performance Considerations Page How to Specify a CAPid Reconfiguration utility Appendix B. CP Commands and DIAGNOSE Codes Appendix C. Record Formats Appendix D. Logging ACS Robotics Motion 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 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 - 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 Command Service Level ExecutionBase Full Service Level Execution UtilityBase Full Displaying/Setting Service Level Starting the HSC Subsystem at Base 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 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 Activating Automated Cleaning Tape Transport CleaningAutomated Tape Transport 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 Exception Processing Ejecting Cartridges from the LibraryCAP Mode Considerations Releasing an Allocated CAP 48VM/HSC 6.0 System Programmer’s Guide Using Multiple CDS Copies Near Continuous Operations 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 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 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 LMU Server Functions Dual LMU FunctionalityIf 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 - 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 Defining PARMLIB Control Statements OverviewPARMLIB 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 LKEYINFO license-key-stringExamples 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 Example Other Methods of Controlling Scratch SubpoolsSCRPOol Definition Data Set Control Statements OPTion TITLE LMU PathLMU Parameter Definition Scratch Subpool Parameter Statement Definition Defining LMU Network Connections Defining Tape Request Attributes TAPEREQVolume Attribute Volume Attribute Definition Defining Volume Attributes VOLATTR Defining Unit Attributes UNITATTR Identifying the Definition Data Sets OPTION TITLE Control Statement Continuation Conventions LMUPATH LMUPATH Control Statement LMUPATH UsageSyntax Control Statement Name LMUPATH lmu_hostnamennn.nnn.nnn.nnn LMUADDR LMUPDEF LMUPDEF Command and Control Statement 110VM/HSC 6.0 System Programmer’s Guide LMUPDEF dataset.nameSyntax Control Statement Name LMUPDEF Load the LMUPATH Parameters From YOUR.DSNMEMBERunitname host-id OPTion TITLE OPTion TITLE Control Statement identifying-stringSyntax Control Statement Name OPTion TITLE Example114VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - SCRPDEF SCRPDEF SyntaxControl Statement Name Parameters Load the SCRPOol Parameters From YOUR.DSNMEMBER SCRPDEFunitname host-id TAPEREQ Tape Request TAPEREQ Control Statement TAPEREQ Usage TAPEREQ Disabling a TAPEREQ Definition TAPEREQ 120VM/HSC 6.0 System Programmer’s Guide TAPEREQ TAPEREQSyntax 122VM/HSC 6.0 System Programmer’s Guide Syntax continuedTAPEREQ 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 4490 subpool-nameTAPEREQ Set Tape Request Attributes TAPEREQExample 132VM/HSC 6.0 System Programmer’s Guide TREQDEF TREQDEF SyntaxControl Statement Name Parameters Load the TAPEREQ Parameters From YOUR.DSNMEMBER TREQDEFunitname host-id UNITATTR Usage UNITATTRUnit Attribute UNITATTR Control Statement 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 Usage Volume Attribute VOLATTR Control StatementVOLATTR 144VM/HSC 6.0 System Programmer’s Guide Disabling a VOLATTR DefinitionVOLATTR 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 STK1RC34 use-limitVOLATTR 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 COLD RESETSSYS RECONFIG MemberDialog Both HSC Startup Job ACS SLKJCL Sample ACS SLKJCL File Example SLSSYSXX Description of /FILE StatementNotes 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 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 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 Parameters Controlling Report Headings Reports Created by UtilitiesReport 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 196VM/HSC 6.0 System Programmer’s Guide Activities ReportUsage Notes 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 Audit Actions Permitted During an AuditHow the AUDIt Utility Functions 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 •the following data sets BackupOutput Description 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 - 224VM/HSC 6.0 System Programmer’s Guide Backup How to Restart BackupRelated Utilities 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 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 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 Output Description Directory Rebuild JCL ExampleJCL for Directory Rebuild Syntax Eject Cartridge UtilityEject Cartridge 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 248VM/HSC 6.0 System Programmer’s Guide Eject Cartridge Output DescriptionFigure 13. EJECt Cartridge Utility Sample Output 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 Output Description Journal Offload JCL ExampleJCL for Offload of Journals Journal Offload Figure 15. Journal Offload Utility Sample Output256VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - MOVe Considerations Move UtilityMove lsm-id MoveSyntax Utility Name panel Moverow-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 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 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 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 ACSUTIL SLKJCL File Restore Invoking the Restore UtilityJCL Examples JCL for RESTore with Journals Applied JCL for RESTore with GENerate OnlyRestore 280VM/HSC 6.0 System Programmer’s Guide Output Description JCL for RESTore Journals and Output to SLSAUDITRestore 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 How the Scratch Redistribution Utility Functions Scratch Redistribution UtilityScratch Redistribution 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 Chapter 4. Utility Functions Set SyntaxNote: This syntax is continued on the next page 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 FREEZE oldpswdSET Freeze Panel 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 Syntax Unselect UtilityUnselect Unselect Utility Name Invoking the Unselect UtilityParameters JCL Requirements JCL to Unselect a Volume UnselectJCL Example Output Description Unselect Figure 20. Unselect Utility Sample OutputChapter 4. Utility Functions 1st ed., 6/30/04 Volume Report Utility Volume Report Media Type and Recording Technique Considerations Volume Report Volume Report •change the VOLATTR statements Volume Report Syntax Volume Report Utility Name volser or vol-range or vol-listParameters acs-id Volume Report SORT Volume Report INCLude Volume Report MEDEQUALNONMEDEQ NOEXTernal Volume Report VOLISTVOLDATA CDSDATA JCL/Parameter File Requirements Volume ReportSLSCNTL, SLSCNTL2, SLSSTBY SLSPRINT JCL/Parameter File Syntax SLSCNTLvaddr control.set.name fn, ft, fm keywordsSLSCDATA CMS only SLSSCRPL CMS only SLSVA CMS only PARMparameters JOB SCP only Volume Report Invoking the Volume Report Utility SLUVOLR EXEC CMSParameter File ACSUTIL SLKJCL File JCL Example JCL to Produce a Volume ReportVolume Report 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 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 346VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Messages Abend CodesHSC Messages SCP Messages CCWTRACE Software Trace FacilitiesCP Trace Table 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 Interrupt Type IUCV Interrupt BufferIPTYPE 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 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 HSC TRACE Command Format of HSC GTRACE USR Records Diagnostic Commands VM CP CommandsSetting Initialization Sequence Break-Points SCP Debug Mode offset length =DEBUG SCP Diagnostic Subsystem CommandsEnabling the Diagnostic Subsystem fieldname =NODEBUG=DDICT =HPER epnameoffset length epname =WHEREaddress HSC Diagnostic Commands LIst CommandSyntax Parameters data-structure address DISPLAY Commandsize Control Data Set Recovery CDS Recovery CapabilitiesDynamic Recovery of the Control Data Set 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 Type of Dumps Supported How to Request a DumpDump Processing What to do When a Dump Occurs Note Reason For Dump Call StorageTek Software Support Move Problem Materials to TapeLoad Dump and CONSLOG Onto Disk 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 Subsystem Data Relationships Diagnostic TechniquesSCP Task/Job 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 Request Block Identify the Failing RoutineFind the Failing Task 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 Overview Chapter 6. Performance ConsiderationsHow Library Activity Affects Library Performance How Operators Control Library Performance Using the Activities Report UtilityMonitoring Library Activity and 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 418VM/HSC 6.0 System Programmer’s Guide Functioning of Host-to-HostCommunicationsDesignation of Communication parameters Define Secondary and Standby Control Data Sets Limit View Time to Maintain High Performance Advantages of Using the VIew Command Excessive Use of VIew Command Affects PerformanceHow to Monitor Usage of 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 440VM/HSC 6.0 System Programmer’s Guide SCRPOOL NAME=STD36,RANGEAAA000AAA999ZZZ000ZZZ999 MEDia, RECtech, and MODel Parameters MODel, and RECtech parametersacs-id, lsm-id acs-id, lsm-id Mount VOLATTR acs-id, lsm-id 1st ed., 6/30/04 - LIBGEN Macros444VM/HSC 6.0 System Programmer’s Guide SLIACS macro SLIALIST macroSLIDLIST macro SLIDRIVS macros 1st ed., 6/30/04 - SLILIBRY macro446VM/HSC 6.0 System Programmer’s Guide 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 1st ed., 6/30/04 - Volume Attribute VOLATTR control statement454VM/HSC 6.0 System Programmer’s Guide 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 490VM/HSC 6.0 System Programmer’s Guide Reply CommandSET Command destination events SLK Command STArt CommandSTOP Command STOPSCP Command 1st ed., 6/30/04 - GCS Component Server CommandsSLKGCS Command 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 1st ed., 6/30/04 - IUCV496VM/HSC 6.0 System Programmer’s Guide 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 Appendix C. Record Formats Cross ReferenceSLSSVSTA 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 Appendix C. Record Formats Cross ReferenceLTYPAREA 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’ 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 Cross Reference CHARACTER SLSSPSWI Cross Reference 556VM/HSC 6.0 System Programmer’s Guide SLSSRL00 Cross Reference SLSSRL01 Cross Reference SLSSHLG1 1. .... X’20’ Appendix C. Record Formats Cross ReferenceHLG1FLG1 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’ Appendix C. Record Formats Cross ReferenceCFGCCPFX SLUVHDAT 1.. .... X’40’ Cross Reference 576VM/HSC 6.0 System Programmer’s Guide 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 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 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 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 - 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 QCDS Request How QCDS FunctionsInvoking QCDS SLSUREQ Macro Overview SLSUREQ VM Requirements Addresses and RegistersVM Requirement 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 Records Returned Output DescriptionRequest Entered SLSUREQM Macro SyntaxParameters PRO=NO|YES Batch API Mapping SLSUREQM Macro A-ADDR SIGNED-FWORD CONST CONST Cross Reference SLSUACSA 652VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 654VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Glossary Central Support Remote Center CSRC— See Page device separation— See drive exclusion directed allocation— See drive prioritizationPage Page Page Page Page Page Silverton— See 4490 Cartridge Subsystem Page Page Symbols Numerics 8500 library— See StreamLine SL8500 library 670VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Index IndexNumerics 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