Manuals / StorageTek / Household Appliance / Water System

StorageTek manual HSC Command Functions Overview, 62VM/HSC 6.0 System Programmer’s Guide

Models: 6

1 718

Download 718 pages 10.93 Kb

Page 92

Command Functions

Command Functions

Command functions consist of real-time control of automated cartridge handling, dynamic selection of HSC processing options, and various query operations.

Figure 6 illustrates the specific areas within a library where HSC commands enable you to control processing.

CARTRIDGE CONTROL

ALLOC (MVS only) DISMount Display

Mount

MOVe

MNTD SCRPOol Warn

CAP

CAPPref

Display

DRAin

EJect

ENter

MODify

OPTion

RELease

SENter

LMU

Display

SWitch

Vary

ACS

Display

SWitch

LSM

Display

MODify

VIew

OPTion (Viewtime)

HOST/HSC

CDs

COMMPath

Display

OPTion (Dialog)

RECover

RETry J3init (MVS/JES3 only)

SRVlev

Trace

TRACELKP

UEXIT (MVS only)

TAPE TRANSPORTS

ALLOC (MVS only) CLean DISMount

Mount

MNTDCONSOLE

Display

OPTion

MONITOR (MVS only) STOPMN (MVS only)

C29358

Figure 5. HSC Command Functions Overview

62VM/HSC 6.0 System Programmer’s Guide

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

Image 92

StorageTek manual HSC Command Functions Overview, 62VM/HSC 6.0 System Programmer’s Guide

Contents

System Programmer’s Guide Release312579601 Host Software Component VM ImplementationExport Destination Control Statement Restricted RightsLimitations on Warranties and Liability Proprietary Information StatementDocument Effectivity Doc Kit NumberHost Software Component for Document EffectivityivVM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 -Contents What’s New With This Release?Preface xxviiMatching 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 FormatsAppendix 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 GuideInstallation Guide System Programmer’s GuideSystem Programmer’s Guide System Programmer’s GuidePreface ScopeIntended Audience Organization of This GuideHow to Use This Guide References to HSC Product Releases Related PublicationsReader’s Comments StorageTek Product SupportxxxVM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 -Chapter 1. System Description Automated Cartridge System OverviewTimberWolf 9740 10-cellremovable magazine or 14-cellpermanent rack Host Software Component Overview HSC Subsystem Components HSC ArchitectureAPPLICATIONS COMMONCONTROL SERVERSVM Environment VM Operating System CP and CMSSystem Control Program SCP Storage ManagementDevice Management File ManagementTask Management Job ManagementProcessor Management CommunicationVirtual Machine Configuration Task Recovery/TerminationHost Software Component HSC Tape Management System TMSHSC and Automated Cartridge System Interaction 10VM/HSC 6.0 System Programmer’s GuideFigure 2. Virtual Machine Relationships Chapter 1. System DescriptionFigure 3. Shared Library Data Sets 12VM/HSC 6.0 System Programmer’s GuideAutomated Mount Automated Dismount14VM/HSC 6.0 System Programmer’s Guide Dual LMU Environment User Control of HSC Functions MacrosUtilities PARMLIB Control StatementsCommands 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 FullService Level Execution UtilityBase FullDisplaying/Setting Service Level Starting the HSC Subsystem at Base Service Level1st 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 SelectionHow To Resolve Scratch Shortages •Standard and 36track •Long and 36track Mount Processing for Specific Volumes Mount/Dismount FunctionsMount Processing for Scratch Volumes Dismount Processing for Library VolumesAbnormal Mounts/Dismounts HSC Mount Command Support Example of Mount Command with Readonly OperandVirtual Thumbwheel VTW Tape Management InterfaceActivating 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 Cleaning42VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 -Volume/Cell Control Functions Moving Volumes within the LibraryScratch Subpool Management Scratch Threshold Task Restart Cartridge Access Port CAP Processing Functions Entering Cartridges into the LibraryCAP Exception Processing CAP Mode ConsiderationsEjecting Cartridges from the Library Releasing an Allocated CAP 48VM/HSC 6.0 System Programmer’s GuideUsing Multiple CDS Copies Near Continuous OperationsRun-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 CopyRelocating an Uncataloged CDS Copy Expanding a CDS - ScenarioCDS ENABLE DSNACS.DBASENEW NEWLOC CDS EXPAND56VM/HSC 6.0 System Programmer’s Guide Swapping Library Transports - New Model Types Common Recovery Functions Control Data Set RecoveryAllocation 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 FailsHSC/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 LMUConfiguring VM for TCP/IP Support System Definition File ACS SYSDEFSystem Profile File ACS SYSPROF HSC Startup Job File ACS SLKJCLInitializing the LMUPATH Definition Data Set Commands to Format OS MinidiskCommands to Format CMS Reserved Minidisk Minidisk Statement for the LMUPATH Data SetLMUPATH Definition Data Set JOB SLSXUTIL SLUGENER /PARM RECCOPYFILE SYSPRINT DEV PRNT CLASS A FILE SYSUT2 DEV <vaddr> DSN <dsname> /FILE SYSUT1Host-to-HostCommunications Services Types of Communications ServicesCommunication Functions Information Passed Between HostsHow Communications Services are Set or Changed Chapter 2. Host Software Component FunctionsSwitching Communications Paths Tape Management Interface Software RequirementsBatch Application Program Interface API 82VM/HSC 6.0 System Programmer’s GuideDefining PARMLIB Control Statements OverviewPARMLIB Control Statements Processing PARMLIB Control Statements Options Offered by PARMLIB Control StatementsCAP Preference Definition Control Data Set DefinitionCommunications Path Definition EXECPARM Control DefinitionJournal Data Set Definition License Key InformationControl Statement Continuation Conventions Reconfiguration CDS DefinitionOption Control Scratch Subpool ControlCDSDEF CDS Definition CDSDEF Control Statement SyntaxCDSDEF Control Statement NameParameters DISABLEExample DSN3SLS.DSTBY,VOL3HSC103,UNIT3503,+ DISABLECDSDEF CDSDEF DSN1SLS.DBASE,VOL1HSC101,UNIT1501,+EXECParm EXECParm Control Statement SyntaxControl Statement Name EXECParmEXECParm Control Statement - Command Prefix Off EXECParmHOSTID ExampleJRNDEF Journal Definition JRNDEF Control StatementSyntax Control Statement NameJRNDEF UNITxFULL AbendLKEYDEF LKEYDEF Command and Control Statement Command NameParameter Descriptions dataset-nameLKEYDEF unitnamehost-id UNITLKEYINFO product-identifiercustomer-name nnnnnnnLKEYINFO license-key-stringExamples RECDEF SyntaxControl Statement Name RECDEFRECDEF ExampleRECDEF DSN1SLS.DBASE,VOL1HSC101,UNIT1501,+ DSN2SLS.DBSEC,VOL2HSC102,UNIT2502SCRPOol Scratch Subpool Control Statement SyntaxControl Statement Name SCRPOolSCRPOol RANGENotes LABELExample Other Methods of Controlling Scratch SubpoolsSCRPOol Definition Data Set Control Statements OPTion TITLE LMU PathLMU Parameter Definition Scratch Subpool Parameter Statement DefinitionDefining LMU Network Connections Defining Tape Request Attributes TAPEREQVolume Attribute Volume Attribute DefinitionDefining Volume Attributes VOLATTR Defining Unit Attributes UNITATTRIdentifying the Definition Data Sets OPTION TITLE Control Statement Continuation ConventionsLMUPATH LMUPATH Control Statement LMUPATH UsageSyntax Control Statement NameLMUPATH lmu_hostnamennn.nnn.nnn.nnn LMUADDRLMUPDEF LMUPDEF Command and Control Statement 110VM/HSC 6.0 System Programmer’s GuideLMUPDEF dataset.nameSyntax Control Statement NameLMUPDEF Load the LMUPATH Parameters From YOUR.DSNMEMBERunitname host-idOPTion TITLE OPTion TITLE Control Statement identifying-stringSyntax Control Statement NameOPTion TITLE Example114VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 -SCRPDEF SCRPDEF SyntaxControl Statement Name ParametersLoad the SCRPOol Parameters From YOUR.DSNMEMBER SCRPDEFunitname host-idTAPEREQ Tape Request TAPEREQ Control Statement TAPEREQ UsageTAPEREQ Disabling a TAPEREQ DefinitionTAPEREQ 120VM/HSC 6.0 System Programmer’s GuideTAPEREQ TAPEREQSyntax 122VM/HSC 6.0 System Programmer’s Guide Syntax continuedTAPEREQ job-name step-nameTAPEREQ Control Statement Nameprogram-name DD-nameTAPEREQ PROGram or PGMnameretention-period expiration-dateTAPEREQ EXPDTTAPEREQ LONGItudStandard ECARTTAPEREQ ZCARTDD3A, DD3B, DD3C STK1TAPEREQ RECtechNotes LONGItudTAPEREQ 36AtrackTAPEREQ STK1RC4490 subpool-nameTAPEREQ Set Tape Request Attributes TAPEREQExample 132VM/HSC 6.0 System Programmer’s GuideTREQDEF TREQDEF SyntaxControl Statement Name ParametersLoad the TAPEREQ Parameters From YOUR.DSNMEMBER TREQDEFunitname host-idUNITATTR Usage UNITATTRUnit Attribute UNITATTR Control Statement UNITATTR unit-addressSyntax Control Statement NameUNITATTR MODelSpecify Unit Attribute Statements UNITATTRT9940B35 IGNOREUNITDEF 140VM/HSC 6.0 System Programmer’s GuideUNITDEF SyntaxControl Statement Name ParametersUNITDEF host-idExamples Specify a Data Set Containing UNITATTR StatementsVOLATTR 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 volserVOLATTR Syntax continuedControl Statement Name VOLATTRvolser or vol-rangeor vol-list VOLATTRParameters SERialVOLATTR Valid media types areVOLATTR ZCARTDD3A, DD3B, DD3C, DD3D STK1VOLATTR STK2P, STK2WRECtech LONGItudVOLATTR indicates a 9490 Timberline transportSTK1RC34 use-limitVOLATTR Set Volume Attributes VOLATTRExample VOLATTR SERIALL*,AA9* MEDIAECARTVOLDEF 154VM/HSC 6.0 System Programmer’s GuideVOLDEF SyntaxControl Statement Name ParametersLoad the VOLATTR Parameters From YOUR.DSNMEMBER VOLDEFunitname host-idCreating an SLKJCL File for Starting the HSC PARM StatementPARM Statement Parameters SyntaxCOLD RESETSSYS RECONFIG MemberDialog BothHSC Startup Job ACS SLKJCL Sample ACS SLKJCL File ExampleSLSSYSXX Description of /FILE StatementNotes Configuration Mismatches Starting HSC ExecutionModifying LSMs Online Specifying CAP PreferencesMultiple Hosts Startup Considerations 164VM/HSC 6.0 System Programmer’s GuideStarting the HSC Initializing the HSC to the Full Service Level Syntax for Initializing HSC to Full Service LevelInitializing the HSC to the Base Service Level Syntax for Initializing HSC to Base Service Level168VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 -Chapter 4. Utility Functions Overview of Library UtilitiesUtility 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 EXECSCP Environment ACSUTIL SLKJCL fileJCL and Control Statements SCP Batch Job Control Language JCLJOB Statement jobnamePARM Statement parmsCOMM Statement commentsSubmitting Jobs fnameftype fmodeUtility Control Statements Control Statements vs. JCLUtility Administrator SLUADMIN How to Invoke SLUADMINHow to Invoke Utility Programs SLUADMIN Program Return CodesReturn Code DescriptionParameters Controlling Report Headings Reports Created by UtilitiesReport Headings Example of JCL Using Report Heading Options ExampleDATE=2YR DATE=4YRStand-AloneUtilities Activities Report Utility Activities ReportSLUACTV EXEC typeSLSSMF fname ftype fmode Activities ReportPARM MIXEDSyntax Utility NameParameters begin-dateend-date end-timeActivities Report TODAYInvoking the Activities Report Utility Control File ExampleOutput Description Control File to Produce an Activities ReportActivities Report TotalActivities Report % of allAve. time Ave. pass-thrusUsage Notes Activities ReportEarliest LatestActivities Report •LSM operating statistics record, subtype 1, andActivities Report ACS IDARM USE P-THRU196VM/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 AuditMedia Type Mismatch Conditions AuditAudit Actions Permitted During an AuditHow the AUDIt Utility Functions Concurrent Audits Auditacs-id AuditSyntax Utility Namelsm-list panel-listAudit PANelrow-list column-listAudit Notescap-id AuditAudit EMPTYCelDIAGScan NotesJCL Requirements Invoking the Audit UtilityACSUTIL SLKJCL File AuditJCL Examples JCL for Audit of Entire Library all ACSsJCL for Selective Audit 1 ACS, 2 LSMs, with CAPid AuditJCL for Selective Audit of Diagnostic Cells Only JCL for Selective Audit of Empty CellsAudit Output DescriptionAudit 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 PrerequisitesBackup How the BACKup Utility Functions Backup Backup Procedure Backup BACKupSyntax Utility NameBackup PrimarySecondary STandbyBackup RestartBackup JCL Requirements SLSPRINTSLSCNTL SLSCNTL2Backup Invoking the BACKup Utility ACSUTIL SLKJCL FileBackup 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 FunctionsBackup 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 PrerequisitesDatabase Decompile Syntax Utility NameParameters JCL RequirementsInvoking the Database Decompile Utility JCL ExampleJCL for Database Decompile Database DecompileDatabase Decompile Output Description DeviceLabel Description1st 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 FunctionsDirectory Rebuild Invoking the Database Decompile UtilitySLSCNTL, SLSCNTL2, SLSSTBY SLSINOutput Description Directory Rebuild JCL ExampleJCL for Directory Rebuild Syntax Eject Cartridge UtilityEject Cartridge Eject Cartridge Utility NameEJECt Eject Method 2 continuedEject Cartridge Parameters vol-listcount VOLserEject Cartridge •CST •MEDIA1 •STD •1 •3480Eject Cartridge Note: STK2P can be abbreviated to PEject Cartridge indicates a 3490E-image9840 transportcap-list Eject CartridgeInvoking the Eject Cartridge Utility Eject CartridgeJCL Requirements ACSUTIL SLKJCL FileJCL for Ejecting a Single Volume JCL to Eject One STD Scratch CartridgeJCL to Eject Five SD-3Scratch Cartridges Eject Cartridge248VM/HSC 6.0 System Programmer’s Guide Eject Cartridge Output DescriptionFigure 13. EJECt Cartridge Utility Sample Output Enter Cartridges Utility Enter CartridgesCAP Operating Instructions SyntaxInvoking the Enter Cartridges Utility Enter CartridgesJCL Requirements SCRatchJCL for Entering Cartridges in a CAP Enter CartridgesJCL Example Output DescriptionEnter 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 NameInvoking the Journal Offload Utility Journal OffloadSLSOFF02 SLSINOutput 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 Namepanel Moverow-list column-listACSUTIL 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 utilityPerformance Log Reblocker mvsnode Performance Log ReblockerJCL Requirements classReasons 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/OsRunning a Successful Reconfiguration Minimizing I/O TimeReconfiguration NotesReconfiguration 7.Log on to STKACSReconfiguration Comment out any AUTOJOB statementsReconfiguration e. Copy the updated SYSPROF to the RUN-diskReconfiguration q.Issue the following commandReconfiguration 17.Save ACS SYSPROF on the RUN-diskBRestore Utility RestoreReasons for Running the RESTore Utility How the RESTore Utility FunctionsRestore RESToreUtility Name ParametersRestore JCL RequirementsOnly ShortACSUTIL 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 GuideOutput 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 RestoreHow the Scratch Redistribution Utility Functions Scratch Redistribution UtilityScratch Redistribution Scratch Redistribution Syntax Utility NameSCREdist Chapter 4. Utility FunctionsScratch Redistribution Parameters tolerance-valueacs-id lsm-listScratch Redistribution expnumlsmScratch Redistribution indicates any Standard, ECART, or ZCART cartridgeScratch Redistribution indicates any T9840 cartridgeindicates a device using helical recording Scratch RedistributionScratch Redistribution indicates any T9940A transportScratch Redistribution JCL Requirements Invoking the Scratch Redistribution UtilityJCL Examples ACSUTIL SLKJCL FileJCL to Perform Scratch Redistribution Scratch RedistributionJCL to Perform Scratch Redistribution JCL to Perform Scratch RedistributionScratch Redistribution Output Description 294VM/HSC 6.0 System Programmer’s GuideScratch Update Utilities Scratch UpdateUtility Names SCRAtch utilityScratch Update Parameters Invoking the Scratch Update UtilitiesJCL Requirements vol-listJCL to Scratch, Unscratch, and Replace Scratch UpdateJCL Example Output DescriptionScratch 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 HSCsConsiderations Before Running the SET Utility Summary of SET Utility OptionsSET Option SET Utility Function and Location of DescriptionChapter 4. Utility Functions Set SyntaxNote: This syntax is continued on the next page SET ACS Esoteric esotericUtility Name ParametersSET Cleaning Prefix SET CLNPRFX PROCEDURESET HSC Command Prefix prefixCharacter DescriptionSET Eject Password SET Delete DispositionSCRTCH NOSCRTCHFREEZE oldpswdSET Freeze Panel SET Host ID newhostoldhost SET HSC LevelSET ENQ/DEQ/RESERVE QNAME qnameSET New Host model-hostSET Scratch Label Type SET Device Numbers for Drivesesoteric FORHOSTaddr0,...addr19 Running SET SLIDRIVS With the HSC Active FORLSMIDlsm-id FORPANELSET SLIDRIVS Procedure SET LMU Station Address Numbersstat1,...,stat16 SLISTATNSET Recovery Technique SET SMF Record Typelibtype FORACSSET TCHNIQE PROCEDURE JCL RequirementsSHADOW BOTHInvoking the Set Utility ACSUTIL SLKJCL FileSet JCL Examples JCL for Set UtilityJCL for Multiple SET Statements Output DescriptionSyntax Unselect UtilityUnselect Unselect Utility Name Invoking the Unselect UtilityParameters JCL RequirementsJCL to Unselect a Volume UnselectJCL Example Output DescriptionUnselect Figure 20. Unselect Utility Sample OutputChapter 4. Utility Functions 1st ed., 6/30/04 -Volume Report Utility Volume ReportMedia Type and Recording Technique Considerations Volume ReportVolume Report •change the VOLATTR statementsVolume Report Syntax Volume Report Utility Name volser or vol-range or vol-listParameters acs-idVolume Report SORTVolume Report INCLudeVolume Report MEDEQUALNONMEDEQ NOEXTernalVolume Report VOLISTVOLDATA CDSDATAJCL/Parameter File Requirements Volume ReportSLSCNTL, SLSCNTL2, SLSSTBY SLSPRINTJCL/Parameter File Syntax SLSCNTLvaddr control.set.namefn, ft, fm keywordsSLSCDATA CMS only SLSSCRPL CMS onlySLSVA CMS only PARMparameters JOB SCP onlyVolume Report Invoking the Volume Report Utility SLUVOLR EXEC CMSParameter File ACSUTIL SLKJCL FileJCL 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 ReportMedia Type Prefix Characters Errant, Scratch, Selected FieldsExternal Label Field Cartridge Usability CLN USE FieldVolume Report Totals Subpool ID FieldTimes Selected Field Totals ReportsVolume Report Flat Files Volume Report1st 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 MessagesCCWTRACE Software Trace FacilitiesCP Trace Table VM CP Debug Commands SCP SET TRACE CommandTRACE Command Syntax SCP Internal Trace TableMaster Trace Table Header Trace Table EntriesDSP Trace Entry Code QueryIPARML IUCV Parameter List TTEWORD1= IRT address TTEWORD2 = IPARML bytesIPARML for IUCV CONNECT to *BLOCKIO InputsIPARML for IUCV SEND to *BLOCKIO Inputs=target class 1=write; 2=read =flags type=2way =relative block number =data buffer addressIPARML for IUCV RECEIVE Inputs= target class = flagsIPARML for IUCV REPLY Inputs= IUCV message id = target classIPARML for IUCV SEVER Inputs= name of virtual machine connected to OutputsIPRCODE Interrupt Type IUCV Interrupt BufferIPTYPE IPARML for Pending Connection Interrupt IPARML for Connection Complete Interrupt IPPATHID = IUCV path idIPTYPE = 03=severed, 04=quiesced, 05=resumedIPARML for Incoming Message Interrupt IPARML for Message Complete Interrupt Diagnostic Capabilities Error Recording Data Set RecordsSCP Trace Facility Supervisor Call and Abnormal End DumpsSCP External Trace Facility SCP Trace Formatter Utility EXECSLUETRAC 368VM/HSC 6.0 System Programmer’s Guideinfn inftinfm outfn1st 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 RecordsDiagnostic Commands VM CP CommandsSCP Debug Mode Setting Initialization Sequence Break-Pointsoffset length=DEBUG SCP Diagnostic Subsystem CommandsEnabling the Diagnostic Subsystem fieldname =NODEBUG=DDICT =HPER epnameoffset lengthepname =WHEREaddress HSC Diagnostic Commands LIst CommandSyntax Parameters data-structureaddress 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 ProcessesControl Data Set Integrity During Restore Detecting Mismatch of Control Data SetsRecommended Recovery Actions Information Required for StorageTek DiagnosisType of Dumps Supported How to Request a DumpDump Processing What to do When a Dump Occurs Note Reason For DumpCall 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 structnameData Structures Data StructuresIHAASCB EX EXECUTE CMS COMMAND FINDTRB SAVE AREA TRACEBACK TTE TRACE TABLE ENTRYWA WHERE ADDRESS WN WHERE NAMESTAT STATUS TASK FIND TASKMajor SCP Data Relationships SLUIPCS PRINT OptionsCommand, Message, Trace Processing Figure 25. Command, Message and Trace Processing1st ed., 6/30/04 - NUCON X’10’ VECTPTR TRCTABSubsystem Data Relationships Diagnostic TechniquesSCP Task/Job Data Relationships Figure 26. SCP Task/Job Data Relationship NUCON JBLOK PSAAOLD JBLTASK TBLOK PSATOLDTKRBLIST RQBLOKFigure 27. Subsystem Data Relationships 404VM/HSC 6.0 System Programmer’s GuideNUCON CVT VECTPTR CVTJESCT JESCT JESSSCT SSCT SSCTSCTA SSCTSSVT SSCTCommon Dump Analysis Tasks Find a Module Plus Offset, Given an AddressFind a Module Address, Given a Name View an HSC or SCP Data AreaFind 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 EventGather Diagnostic Materials Diagnostic MaterialsExamine an SDWA Find IUCV Path Descriptorsdetails of problem circumstances •STKACS abend Tape Format Tape ReturnOverview 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 ReportRedistribute Scratch Volumes in the Library Maintain Quantities of Scratch CartridgesDefine CAP Preferences 414VM/HSC 6.0 System Programmer’s GuideUse SMF Records to Collect Performance Data Use PARMLIB to Define Static ParametersOperator Command Performance ParameterJournal Definition Define High Dispatching Priority for the HSC Set High-Performance Host-to-HostCommunications418VM/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 PerformanceAdvantages 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-ThrusUnavoidable Pass-Thrus Unnecessary Pass-ThrusScheduled Pass-Thrus Ways to Reduce Pass-ThruActivityReduce Operator Intervention Ensure adequate free cellsEject through the CAP closest to the cartridge Redistribute cartridges during off-peaktimesACSPROP EXEC Reduce Tape Transport ContentionPrefetch Enters Avoid Crashing Test SystemsReduce Scheduling Contention Usage RequirementsSyntax ParametersUse Performance Log Reblocker to Format Data Use the Audit Utility EffectivelyUse LSMs as Scratch Loaders in a Mixed ACS Commands Syntax Reference Syntax Flow DiagramsSpecifying Commands VariablesFlow Lines Single Required ChoiceDefaults Repeat SymbolSingle Optional Choice Default Value Value2 Value3Syntax 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,and00indicates one of the following Ranges And Lists 436VM/HSC 6.0 System Programmer’s GuideA00A0-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 Conventions440VM/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-idMount VOLATTR acs-id, lsm-id1st ed., 6/30/04 - LIBGEN Macros444VM/HSC 6.0 System Programmer’s Guide SLIACS macro SLIALIST macroSLIDLIST macro SLIDRIVS macros1st ed., 6/30/04 - SLILIBRY macro446VM/HSC 6.0 System Programmer’s Guide SLILSM macro SLIRCVRY macroSLISTATN macro SLIRCVRYHSC Control Statements EXECParm control statementJournal Definition JRNDEF control statement 448VM/HSC 6.0 System Programmer’s GuideLKEYDEF command and control statement LKEYINFO control statementLMUPATH control statement VOLumevolserOPTion 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 GuideUnit 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-idBACKup utility Database Decompile LIBGEN utilityDirectory Rebuild DIRBLD utility EJECt utilityEJECt utility continued Enter Cartridges utilityReconfiguration utility Journal OFFLoad utilityMOVe utility REPLace utilityRESTore utility SCRAtch utilityScratch Redistribution SCREdist utility 462VM/HSC 6.0 System Programmer’s GuideSET utility OptionsUNSCratch utility Unselect utilitySET utility continued 464VM/HSC 6.0 System Programmer’s GuideVolume Report VOLRpt utility Operator Commands CDs Enable/Disable commandCLean command 466VM/HSC 6.0 System Programmer’s GuideDISMount command Display command Display AcsDisplay ALl Display ALLOCDisplay Cmd Display COMMPathDisplay DRives CMd COmmandDisplay Drives continued 470VM/HSC 6.0 System Programmer’s GuideDisplay Exceptions Display LKEYDEFDisplay LMUPDEF Display LSMDisplay MONitor Display OPTionDisplay Requests 472VM/HSC 6.0 System Programmer’s GuideDisplay SCRatch Display SCRPDEF Display SRVlevDisplay Status 474VM/HSC 6.0 System Programmer’s GuideDisplay THReshld Display TREQDEFDRAin CAP command EJect commandDisplay Volume Display UNITDEFEject Command continued ENter command Journal commandMODify command MONITOR commandMount command volserdevaddr host-id480VM/HSC 6.0 System Programmer’s Guide MOVe command VolumeMOVe Flsmlsm-idOPTion command and control statement RECover Host commandRELease CAP command 482VM/HSC 6.0 System Programmer’s GuideSENter command SRVlev Service Level commandStop Monitoring STOPMN command SWitch commandTRace command TRACELKP commandVary Station command 484VM/HSC 6.0 System Programmer’s GuideVIew command Warn command 486VM/HSC 6.0 System Programmer’s GuideHSC Diagnostic Commands LIst commandTRace command 1st ed., 6/30/04 -SCP Operator Commands AUTHorize CommandCANCEL command CP CommandFILE Command HELP CommandModify Command SCP Query Command490VM/HSC 6.0 System Programmer’s Guide Reply CommandSET Command destination eventsSLK Command STArt CommandSTOP Command STOPSCP Command1st ed., 6/30/04 - GCS Component Server CommandsSLKGCS Command CMS Operator Commands ACS EXECCMS HELP 494VM/HSC 6.0 System Programmer’s GuideAppendix B. CP Commands and DIAGNOSE Codes CP CommandsCP Programming Services Overview1st ed., 6/30/04 - IUCV496VM/HSC 6.0 System Programmer’s Guide Appendix C. Record Formats OverviewMapping Macros for SMF Records Mapping Macros for LOGREC RecordsMapping Macros for Batch API Records TypeSMF Records SMF Mapping MacrosSMF Record Formats SLSDVARCross Reference TypeSLSSFHDR Table 33. SLSSFHDR Record FormatType LengthTable 33. SLSSFHDR Record Format Continued TypeLength LabelTable 33. SLSSFHDR Record Format Continued TypeLength LabelCross Reference 504VM/HSC 6.0 System Programmer’s GuideName OffsetValue Appendix C. Record FormatsSLSSBLOS Cross Reference SIGNED-FWORDSLSSCAPJ Cross ReferenceSLSSCAPN Cross ReferenceSLSSVSTA Appendix C. Record Formats Cross ReferenceSLSSVSTA SLSSMLSM Cross ReferenceSLSSLSB Cross Reference Table 39. SLSSLSB Record Format ContinuedType LengthSLSSMF07 1.1 X’05’ CHARACTER CHAR CONST LENGTH Cross Reference 520VM/HSC 6.0 System Programmer’s GuideSMF07MVU Appendix C. Record Formats522VM/HSC 6.0 System Programmer’s Guide SLSSMF08 Cross Reference 524VM/HSC 6.0 System Programmer’s GuideLOGREC Records LOGREC Mapping MacrosLOGREC Record Formats SLSSLHDROFFSET Table 43. SLSSLHDR Record Format Continued TypeLength LabelAppendix C. Record Formats Cross ReferenceLTYPAREA 530VM/HSC 6.0 System Programmer’s Guide SLSSVLG1 Cross Reference 532VM/HSC 6.0 System Programmer’s GuideSLSSBLOG Cross Reference 534VM/HSC 6.0 System Programmer’s GuideSLSSLLG1 CONST 1.. .... X’40’ Cross Reference 538VM/HSC 6.0 System Programmer’s GuideLLG1NWSN Appendix C. Record FormatsSLSSLLG2 Cross Reference HEXSTRINGSLSSLLG3 Cross ReferenceSLSSLLG4 Cross Reference 544VM/HSC 6.0 System Programmer’s GuideSLSSLLG5 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 CHARACTERSLSSPSWI Cross Reference 556VM/HSC 6.0 System Programmer’s GuideSLSSRL00 Cross ReferenceSLSSRL01 Cross ReferenceSLSSHLG1 1. .... X’20’ Appendix C. Record Formats Cross ReferenceHLG1FLG1 Volume Report and Batch API Records Volume Report and Batch API Mapping MacrosVolume Report and Batch API Record Formats SLUVADAT1.. .... X’40’ HEXSTRING 1 ..1. X’12’ Cross Reference X’80’568VM/HSC 6.0 System Programmer’s Guide LSMNADLS Appendix C. Record Formats570VM/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 GuideSLUVIDAT 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 Formats592VM/HSC 6.0 System Programmer’s Guide Batch API Records Batch API Mapping MacrosTable 64. Mapping macros for Batch API Records Appendix C. Record FormatsBatch API Record Formats SLUVDDATCross Reference F0F1596VM/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 GuideName OffsetValue UVPTWSTD602VM/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 Counts1st 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-HostEnvironmentLMU 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 0427LMU Logical Error Codes: 0601 - LSM Robotics Error Codes: 0701 - LSM Hardware Error Codes: 0801 - LSM Logical Error Codes: 0901 -0921 Drive Error Codes: 1001 - Undefined Response Code1012 Load Failure on Special UseAppendix 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 OverviewSLSUREQ VM Requirements Addresses and RegistersVM Requirement Parameters labelSyntax REQUESTThis parameter is required BUFFER QCDS Programming Considerations E,parmaddrNotes UCALADRReturn Codes Return Field NameDecimal Value and Description Invalid SLSUREQ RequestsSample 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|YESBatch API Mapping SLSUREQM Macro A-ADDR SIGNED-FWORD CONST CONST Cross Reference SLSUACSA652VM/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 Numerics8500 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 Index674VM/HSC 6.0 System Programmer’s Guide 377, 383, 676VM/HSC 6.0 System Programmer’s Guide Library Control Unit LCU, defined IndexACS 108, CAP 468, 478,cap-id 466, 476, 478, 482, 483 cap-list 466, 678VM/HSC 6.0 System Programmer’s Guide478, 680VM/HSC 6.0 System Programmer’s Guide RECover Host command recovery functions Index682VM/HSC 6.0 System Programmer’s Guide SRVlev command Index684VM/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