Manuals / StorageTek / Household Appliance / Water System

StorageTek 6 manual Utility Functions Overview, Host Software Component Functions

Models: 6

1 718

Page 95

Utility Functions

Utility functions provide control and recovery of library resources. In addition, reporting of library and volume activity can be invoked using various HSC utilities.

Figure 7 illustrates the control concept provided by the various HSC utilities.

Figure 6. Utility Functions Overview

Refer to Chapter 4, “Utility Functions” on page 131 for detailed descriptive information about all HSC utilities, including description, syntax and parameters, JCL requirements and examples, and samples of output.

Chapter 2. Host Software Component Functions 65

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

Page 95

Image 95

StorageTek 6 manual Utility Functions Overview, Host Software Component Functions

Contents

Host Software Component VM Implementation System Programmer’s GuideRelease 312579601Proprietary Information Statement Export Destination Control StatementRestricted Rights Limitations on Warranties and LiabilityDocument Effectivity Document EffectivityDoc Kit Number Host Software Component for1st ed., 6/30/04 - ivVM/HSC 6.0 System Programmer’s Guidexxvii ContentsWhat’s New With This Release? PrefaceMatching 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 CodesAppendix D. Logging ACS Robotics Motion Index Appendix E. Remote-linkedLibrariesGlossary Figures Figure Tables Table 28. Performance Parameters Controlled by PARMLIB Control Statements Table 67. Format for Total Motions and Temporary Error Counts 1st ed., 6/30/04 - xxivVM/HSC 6.0 System Programmer’s GuideInstallation Guide What’s New With This Release?Installation Guide Installation GuideSystem Programmer’s Guide Installation GuideSystem Programmer’s Guide System Programmer’s GuideOrganization of This Guide PrefaceScope Intended AudienceHow to Use This Guide StorageTek Product Support References to HSC Product ReleasesRelated Publications Reader’s Comments1st ed., 6/30/04 - xxxVM/HSC 6.0 System Programmer’s GuideAutomated Cartridge System Overview Chapter 1. System DescriptionTimberWolf 9740 10-cellremovable magazine or 14-cellpermanent rack Host Software Component Overview HSC Architecture HSC Subsystem ComponentsSERVERS APPLICATIONSCOMMON CONTROLVM Operating System CP and CMS VM EnvironmentFile Management System Control Program SCPStorage Management Device ManagementCommunication Task ManagementJob Management Processor ManagementTape Management System TMS Virtual Machine ConfigurationTask Recovery/Termination Host Software Component HSC10VM/HSC 6.0 System Programmer’s Guide HSC and Automated Cartridge System InteractionChapter 1. System Description Figure 2. Virtual Machine Relationships12VM/HSC 6.0 System Programmer’s Guide Figure 3. Shared Library Data SetsAutomated Dismount Automated Mount14VM/HSC 6.0 System Programmer’s Guide Dual LMU Environment PARMLIB Control Statements User Control of HSC FunctionsMacros UtilitiesCommands 1st ed., 6/30/04 - 18VM/HSC 6.0 System Programmer’s GuideAutomatic 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 Full CommandService Level Execution BaseFull Service Level ExecutionUtility BaseStarting the HSC Subsystem at Base Service Level Displaying/Setting 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 Scratch Selection Specific Volume RequestsNonspecific Volume Requests Precedence of VOLATTR and TAPEREQ StatementsHow To Resolve Scratch Shortages •Standard and 36track •Long and 36track Mount/Dismount Functions Mount Processing for Specific VolumesDismount Processing for Library Volumes Mount Processing for Scratch VolumesAbnormal Mounts/Dismounts Tape Management Interface HSC Mount Command SupportExample of Mount Command with Readonly Operand Virtual Thumbwheel VTWActivating Automated Cleaning Tape Transport CleaningAutomated Tape Transport Cleaning Notes Identifying Cleaning CartridgesNotes Over-use Over-limitand Spent Cleaning Cartridges Managing Over-useCleaning Cartridges Manual Tape Transport Cleaning Managing Cleaning Cartridges1st ed., 6/30/04 - 42VM/HSC 6.0 System Programmer’s GuideMoving Volumes within the Library Volume/Cell Control FunctionsScratch Subpool Management Scratch Threshold Task Restart Entering Cartridges into the Library Cartridge Access Port CAP Processing FunctionsCAP Exception Processing CAP Mode ConsiderationsEjecting Cartridges from the Library 48VM/HSC 6.0 System Programmer’s Guide Releasing an Allocated CAPNear Continuous Operations Using Multiple CDS CopiesRun-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 Renaming a CDS Copy Using CDS Rename/Relocate/ExpandCDs Command Renaming/Relocating a CDS - ScenariosCDS EXPAND Relocating an Uncataloged CDS CopyExpanding a CDS - Scenario CDS ENABLE DSNACS.DBASENEW NEWLOC56VM/HSC 6.0 System Programmer’s Guide Swapping Library Transports - New Model Types Control Data Set Recovery Common Recovery FunctionsAllocation 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 If the Standby LMU Fails LMU Server FunctionsDual LMU Functionality If the Master 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 Communication Lost to Standby LMU Operator Intervention - Single LMU ConfigurationOperator Intervention - Dual LMU Configuration Communication Lost to Master LMUHSC Startup Job File ACS SLKJCL Configuring VM for TCP/IP SupportSystem Definition File ACS SYSDEF System Profile File ACS SYSPROFMinidisk Statement for the LMUPATH Data Set Initializing the LMUPATH Definition Data SetCommands to Format OS Minidisk Commands to Format CMS Reserved MinidiskFILE SYSUT2 DEV <vaddr> DSN <dsname> /FILE SYSUT1 LMUPATH Definition Data SetJOB SLSXUTIL SLUGENER /PARM RECCOPY FILE SYSPRINT DEV PRNT CLASS AInformation Passed Between Hosts Host-to-HostCommunications ServicesTypes of Communications Services Communication FunctionsChapter 2. Host Software Component Functions How Communications Services are Set or ChangedSwitching Communications Paths Software Requirements Tape Management Interface82VM/HSC 6.0 System Programmer’s Guide Batch Application Program Interface APIDefining PARMLIB Control Statements OverviewPARMLIB Control Statements Control Data Set Definition Processing PARMLIB Control StatementsOptions Offered by PARMLIB Control Statements CAP Preference DefinitionLicense Key Information Communications Path DefinitionEXECPARM Control Definition Journal Data Set DefinitionScratch Subpool Control Control Statement Continuation ConventionsReconfiguration CDS Definition Option ControlSyntax CDSDEF CDS Definition CDSDEF Control StatementDISABLE CDSDEFControl Statement Name ParametersCDSDEF DSN1SLS.DBASE,VOL1HSC101,UNIT1501,+ ExampleDSN3SLS.DSTBY,VOL3HSC103,UNIT3503,+ DISABLE CDSDEFEXECParm EXECParm EXECParm Control StatementSyntax Control Statement NameExample EXECParm Control Statement - Command Prefix OffEXECParm HOSTIDControl Statement Name JRNDEFJournal Definition JRNDEF Control Statement SyntaxAbend JRNDEFUNITx FULLdataset-name LKEYDEF LKEYDEF Command and Control StatementCommand Name Parameter DescriptionsUNIT LKEYDEFunitname host-idnnnnnnn LKEYINFOproduct-identifier customer-nameLKEYINFO license-key-stringExamples RECDEF RECDEFSyntax Control Statement NameDSN2SLS.DBSEC,VOL2HSC102,UNIT2502 RECDEFExample RECDEF DSN1SLS.DBASE,VOL1HSC101,UNIT1501,+SCRPOol SCRPOol Scratch Subpool Control StatementSyntax Control Statement NameLABEL SCRPOolRANGE NotesExample Other Methods of Controlling Scratch SubpoolsSCRPOol Definition Data Set Control Statements Scratch Subpool Parameter Statement Definition OPTion TITLELMU Path LMU Parameter DefinitionVolume Attribute Definition Defining LMU Network ConnectionsDefining Tape Request Attributes TAPEREQ Volume AttributeDefining Unit Attributes UNITATTR Defining Volume Attributes VOLATTRControl Statement Continuation Conventions Identifying the Definition Data Sets OPTION TITLEControl Statement Name LMUPATH LMUPATH Control StatementLMUPATH Usage SyntaxLMUADDR LMUPATHlmu_hostname nnn.nnn.nnn.nnn110VM/HSC 6.0 System Programmer’s Guide LMUPDEF LMUPDEF Command and Control StatementControl Statement Name LMUPDEFdataset.name Syntaxhost-id LMUPDEFLoad the LMUPATH Parameters From YOUR.DSNMEMBER unitnameControl Statement Name OPTion TITLE OPTion TITLE Control Statementidentifying-string Syntax1st ed., 6/30/04 - OPTion TITLEExample 114VM/HSC 6.0 System Programmer’s GuideSCRPDEF Parameters SCRPDEFSyntax Control Statement Namehost-id Load the SCRPOol Parameters From YOUR.DSNMEMBERSCRPDEF unitnameTAPEREQ Usage TAPEREQ Tape Request TAPEREQ Control StatementDisabling a TAPEREQ Definition TAPEREQ120VM/HSC 6.0 System Programmer’s Guide TAPEREQTAPEREQ TAPEREQSyntax 122VM/HSC 6.0 System Programmer’s Guide Syntax continuedTAPEREQ Control Statement Name job-namestep-name TAPEREQPROGram or PGMname program-nameDD-name TAPEREQEXPDT retention-periodexpiration-date TAPEREQECART TAPEREQLONGItud StandardSTK1 TAPEREQZCART DD3A, DD3B, DD3CLONGItud TAPEREQRECtech Notes36Atrack TAPEREQSTK1RC TAPEREQ4490 subpool-nameTAPEREQ 132VM/HSC 6.0 System Programmer’s Guide Set Tape Request AttributesTAPEREQ ExampleTREQDEF Parameters TREQDEFSyntax Control Statement Namehost-id Load the TAPEREQ Parameters From YOUR.DSNMEMBERTREQDEF unitnameUNITATTR Usage UNITATTRUnit Attribute UNITATTR Control Statement Control Statement Name UNITATTRunit-address SyntaxMODel UNITATTRIGNORE Specify Unit Attribute StatementsUNITATTR T9940B35140VM/HSC 6.0 System Programmer’s Guide UNITDEFParameters UNITDEFSyntax Control Statement NameSpecify a Data Set Containing UNITATTR Statements UNITDEFhost-id ExamplesVOLATTR Usage Volume Attribute VOLATTR Control StatementVOLATTR 144VM/HSC 6.0 System Programmer’s Guide Disabling a VOLATTR DefinitionVOLATTR VOLATTR SERial volser This syntax diagram is continued on the next pageVOLATTR SyntaxVOLATTR VOLATTRSyntax continued Control Statement NameSERial volser or vol-rangeor vol-listVOLATTR ParametersValid media types are VOLATTRSTK1 VOLATTRZCART DD3A, DD3B, DD3C, DD3DLONGItud VOLATTRSTK2P, STK2W RECtechindicates a 9490 Timberline transport VOLATTRSTK1RC34 use-limitVOLATTR VOLATTR SERIALL*,AA9* MEDIAECART Set Volume AttributesVOLATTR Example154VM/HSC 6.0 System Programmer’s Guide VOLDEFParameters VOLDEFSyntax Control Statement Namehost-id Load the VOLATTR Parameters From YOUR.DSNMEMBERVOLDEF unitnameSyntax Creating an SLKJCL File for Starting the HSCPARM Statement PARM Statement ParametersCOLD RESETSSYS Both RECONFIGMember DialogHSC Startup Job ACS SLKJCL Example Sample ACS SLKJCL FileSLSSYSXX Description of /FILE StatementNotes Specifying CAP Preferences Configuration MismatchesStarting HSC Execution Modifying LSMs Online164VM/HSC 6.0 System Programmer’s Guide Multiple Hosts Startup ConsiderationsStarting the HSC Syntax for Initializing HSC to Full Service Level Initializing the HSC to the Full Service LevelSyntax for Initializing HSC to Base Service Level Initializing the HSC to the Base Service Level1st ed., 6/30/04 - 168VM/HSC 6.0 System Programmer’s GuideOverview of Library Utilities Chapter 4. Utility FunctionsUtility to Use Selecting a UtilityFunction Restore or recreate the library CDS Typical Use of Utilities Utility Environmental Requirements Control Statement Syntax ConventionsUtility Syntax Conventions ACS UTIL Exec ACSCMS EXEC CMS EnvironmentACSUTIL SLKJCL file SCP Environmentjobname JCL and Control StatementsSCP Batch Job Control Language JCL JOB Statementcomments PARM Statementparms COMM Statementfmode Submitting Jobsfname ftypeControl Statements vs. JCL Utility Control StatementsHow to Invoke SLUADMIN Utility Administrator SLUADMINDescription How to Invoke Utility ProgramsSLUADMIN Program Return Codes Return CodeParameters Controlling Report Headings Reports Created by UtilitiesReport Headings DATE=4YR Example of JCL Using Report Heading OptionsExample DATE=2YRStand-AloneUtilities type Activities Report UtilityActivities Report SLUACTV EXECMIXED SLSSMF fname ftype fmodeActivities Report PARMbegin-date SyntaxUtility Name ParametersTODAY end-dateend-time Activities ReportControl File to Produce an Activities Report Invoking the Activities Report UtilityControl File Example Output DescriptionTotal Activities ReportAve. pass-thrus Activities Report% of all Ave. timeLatest Usage NotesActivities Report Earliest•LSM operating statistics record, subtype 1, and Activities ReportP-THRU Activities ReportACS ID ARM USE196VM/HSC 6.0 System Programmer’s Guide Activities ReportUsage Notes 1st ed., 6/30/04 - Activities ReportFigure 9. Activities Report Utility Sample Output Chapter 4. Utility FunctionsAudit Audit UtilityAudit Media Type Mismatch ConditionsAudit Actions Permitted During an AuditHow the AUDIt Utility Functions Audit Concurrent AuditsUtility Name acs-idAudit SyntaxPANel lsm-listpanel-list AuditNotes row-listcolumn-list AuditAudit cap-idNotes AuditEMPTYCel DIAGScanAudit JCL RequirementsInvoking the Audit Utility ACSUTIL SLKJCL FileAudit JCL ExamplesJCL for Audit of Entire Library all ACSs JCL for Selective Audit 1 ACS, 2 LSMs, with CAPidOutput Description JCL for Selective Audit of Diagnostic Cells OnlyJCL for Selective Audit of Empty Cells Audit1st ed., 6/30/04 - AuditFigure 10. AUDIt Utility Sample Output 210VM/HSC 6.0 System Programmer’s GuidePrerequisites Backup UtilityBackup Reasons for Running the BACKup UtilityBackup How the BACKup Utility Functions Backup Backup Procedure Utility Name BackupBACKup SyntaxSTandby BackupPrimary SecondaryRestart BackupSLSCNTL2 Backup JCL RequirementsSLSPRINT SLSCNTLACSUTIL SLKJCL File Backup Invoking the BACKup UtilityJCL for Running a Copy Backup Backup JCL ExamplesJCL for Running Backup Run Backup Utility•the following data sets BackupOutput Description Chapter 4. Utility Functions Backup•a condition code from backup processing 4warning MESSAGES – Backup successful1st ed., 6/30/04 - BackupFigure 11. BACKup Utility Sample Output 1 of 222VM/HSC 6.0 System Programmer’s Guide1st ed., 6/30/04 - BackupFigure 11. BACKup Utility Sample Output 2 of Chapter 4. Utility Functions224VM/HSC 6.0 System Programmer’s Guide Backup How to Restart BackupRelated Utilities Prerequisites Database Decompile LIBGEN UtilityDatabase Decompile How the Database Decompile Utility FunctionsJCL Requirements Database Decompile SyntaxUtility Name ParametersDatabase Decompile Invoking the Database Decompile UtilityJCL Example JCL for Database DecompileDescription Database Decompile Output DescriptionDevice Label1st 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 How the Directory Rebuild Utility Functions Directory Rebuild UtilityDirectory Rebuild Reasons for Running the Directory Rebuild UtilitySLSIN Directory RebuildInvoking the Database Decompile Utility SLSCNTL, SLSCNTL2, SLSSTBYOutput Description Directory Rebuild JCL ExampleJCL for Directory Rebuild Syntax Eject Cartridge UtilityEject Cartridge Eject Method 2 continued Eject CartridgeUtility Name EJECtVOLser Eject Cartridge Parametersvol-list count•CST •MEDIA1 •STD •1 •3480 Eject CartridgeNote: STK2P can be abbreviated to P Eject Cartridgeindicates a 3490E-image9840 transport Eject CartridgeEject Cartridge cap-listACSUTIL SLKJCL File Invoking the Eject Cartridge UtilityEject Cartridge JCL RequirementsEject Cartridge JCL for Ejecting a Single VolumeJCL to Eject One STD Scratch Cartridge JCL to Eject Five SD-3Scratch Cartridges248VM/HSC 6.0 System Programmer’s Guide Eject Cartridge Output DescriptionFigure 13. EJECt Cartridge Utility Sample Output Syntax Enter Cartridges UtilityEnter Cartridges CAP Operating InstructionsSCRatch Invoking the Enter Cartridges UtilityEnter Cartridges JCL RequirementsOutput Description JCL for Entering Cartridges in a CAPEnter Cartridges JCL Example1st ed., 6/30/04 - Enter CartridgesFigure 14. Enter Cartridge Utility Sample Output 252VM/HSC 6.0 System Programmer’s GuideUtility Name Journal Offload UtilityJournal Offload SyntaxSLSIN Invoking the Journal Offload UtilityJournal Offload SLSOFF02Output Description Journal Offload JCL ExampleJCL for Offload of Journals 1st ed., 6/30/04 - Journal OffloadFigure 15. Journal Offload Utility Sample Output 256VM/HSC 6.0 System Programmer’s GuideMOVe Considerations Move UtilityMove Utility Name lsm-idMove Syntaxcolumn-list panelMove row-listACSUTIL SLKJCL File Move JCL RequirementsInvoking the Move Utility Output Description Move Several Volumes From an LSM to Another LSMMove JCL Examples 1st ed., 6/30/04 - MoveFigure 16. MOVe Utility Sample Output 262VM/HSC 6.0 System Programmer’s GuidePerformance Log Reblocker utility Performance Log Reblocker UtilityPerformance Log Reblocker Syntax CMS StatementPerformance Log Reblocker class mvsnodePerformance Log Reblocker JCL RequirementsReasons 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 Number of I/Os I/O ConsiderationsReconfiguration ConditionNotes Running a Successful ReconfigurationMinimizing I/O Time Reconfiguration7.Log on to STKACS ReconfigurationComment out any AUTOJOB statements Reconfiguratione. Copy the updated SYSPROF to the RUN-disk Reconfigurationq.Issue the following command Reconfiguration17.Save ACS SYSPROF on the RUN-diskB ReconfigurationHow the RESTore Utility Functions Restore UtilityRestore Reasons for Running the RESTore UtilityParameters RestoreRESTore Utility NameShort RestoreJCL Requirements OnlyACSUTIL SLKJCL File Restore Invoking the Restore UtilityJCL Examples 280VM/HSC 6.0 System Programmer’s Guide JCL for RESTore with Journals AppliedJCL for RESTore with GENerate Only RestoreOutput Description JCL for RESTore Journals and Output to SLSAUDITRestore 1st ed., 6/30/04 - RestoreFigure 17. Restore Utility Sample Output 282VM/HSC 6.0 System Programmer’s GuideRestore How to Handle BACKup/RESTore DiscrepanciesHow the Scratch Redistribution Utility Functions Scratch Redistribution UtilityScratch Redistribution Chapter 4. Utility Functions Scratch Redistribution SyntaxUtility Name SCREdistlsm-list Scratch Redistribution Parameterstolerance-value acs-idexpnumlsm Scratch Redistributionindicates any Standard, ECART, or ZCART cartridge Scratch Redistributionindicates any T9840 cartridge Scratch RedistributionScratch Redistribution indicates a device using helical recordingindicates any T9940A transport Scratch RedistributionACSUTIL SLKJCL File Scratch Redistribution JCL RequirementsInvoking the Scratch Redistribution Utility JCL ExamplesJCL to Perform Scratch Redistribution JCL to Perform Scratch RedistributionScratch Redistribution JCL to Perform Scratch Redistribution294VM/HSC 6.0 System Programmer’s Guide Scratch Redistribution Output DescriptionSCRAtch utility Scratch Update UtilitiesScratch Update Utility Namesvol-list Scratch Update ParametersInvoking the Scratch Update Utilities JCL RequirementsOutput Description JCL to Scratch, Unscratch, and ReplaceScratch Update JCL Example1st ed., 6/30/04 - Scratch UpdateFigure 19. Scratch Update Utilities Sample Output 298VM/HSC 6.0 System Programmer’s GuideSET Utility All Other HSCs How the SET Utility FunctionsSET Option Affected HSCsSummary of SET Utility Options Considerations Before Running the SET UtilitySET Utility Function and Location of Description SET OptionChapter 4. Utility Functions Set SyntaxNote: This syntax is continued on the next page Parameters SET ACS Esotericesoteric Utility Nameprefix SET Cleaning PrefixSET CLNPRFX PROCEDURE SET HSC Command PrefixDescription CharacterNOSCRTCH SET Eject PasswordSET Delete Disposition SCRTCHFREEZE oldpswdSET Freeze Panel SET HSC Level SET Host IDnewhost oldhostmodel-host SET ENQ/DEQ/RESERVE QNAMEqname SET New HostFORHOST SET Scratch Label TypeSET Device Numbers for Drives esotericaddr0,...addr19 FORPANEL Running SET SLIDRIVS With the HSC ActiveFORLSMID lsm-idSLISTATN SET SLIDRIVS ProcedureSET LMU Station Address Numbers stat1,...,stat16FORACS SET Recovery TechniqueSET SMF Record Type libtypeBOTH SET TCHNIQE PROCEDUREJCL Requirements SHADOWACSUTIL SLKJCL File Invoking the Set UtilityJCL for Set Utility Set JCL ExamplesOutput Description JCL for Multiple SET StatementsSyntax Unselect UtilityUnselect JCL Requirements Unselect Utility NameInvoking the Unselect Utility ParametersOutput Description JCL to Unselect a VolumeUnselect JCL Example1st ed., 6/30/04 - UnselectFigure 20. Unselect Utility Sample Output Chapter 4. Utility FunctionsVolume Report Volume Report UtilityVolume Report Media Type and Recording Technique Considerations•change the VOLATTR statements Volume ReportVolume Report Syntax acs-id Volume Report Utility Namevolser or vol-range or vol-list ParametersSORT Volume ReportINCLude Volume ReportNOEXTernal Volume ReportMEDEQUAL NONMEDEQCDSDATA Volume ReportVOLIST VOLDATASLSPRINT JCL/Parameter File RequirementsVolume Report SLSCNTL, SLSCNTL2, SLSSTBYcontrol.set.name JCL/Parameter File SyntaxSLSCNTL vaddrSLSSCRPL CMS only fn, ft, fmkeywords SLSCDATA CMS onlyJOB SCP only SLSVA CMS onlyPARM parametersACSUTIL SLKJCL File Volume Report Invoking the Volume Report UtilitySLUVOLR EXEC CMS Parameter FileJCL Example JCL to Produce a Volume ReportVolume Report Volume Report JCL to Produce a Volume Report for an MVS PDSReport Detail Lines Media and Recording Technique OriginCartridge Usability CLN USE Field Media Type Prefix CharactersErrant, Scratch, Selected Fields External Label FieldTotals Reports Volume Report TotalsSubpool ID Field Times Selected FieldVolume Report Volume Report Flat Files1st ed., 6/30/04 - Volume ReportChapter 4. Utility Functions 1st ed., 6/30/04 - Volume Report344VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - Volume ReportChapter 4. Utility Functions 1st ed., 6/30/04 - 346VM/HSC 6.0 System Programmer’s GuideSCP Messages MessagesAbend Codes HSC MessagesCCWTRACE Software Trace FacilitiesCP Trace Table SCP Internal Trace Table VM CP Debug CommandsSCP SET TRACE Command TRACE Command SyntaxTrace Table Entries Master Trace Table HeaderDSP Trace Entry Query CodeTTEWORD2 = IPARML bytes IPARML IUCV Parameter ListTTEWORD1 = IRT addressInputs 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 idOutputs IPARML for IUCV SEVERInputs = name of virtual machine connected toIPRCODE Interrupt Type IUCV Interrupt BufferIPTYPE IPARML for Pending Connection Interrupt IPARML for Connection Complete Interrupt = 03=severed, 04=quiesced, 05=resumed IPPATHID= IUCV path id IPTYPEIPARML for Incoming Message Interrupt IPARML for Message Complete Interrupt Supervisor Call and Abnormal End Dumps Diagnostic CapabilitiesError Recording Data Set Records SCP Trace FacilitySCP External Trace Facility 368VM/HSC 6.0 System Programmer’s Guide SCP Trace Formatter UtilityEXEC SLUETRACoutfn infninft infm1st ed., 6/30/04 - Supervisor Call SVC Functions370VM/HSC 6.0 System Programmer’s Guide Function Refer to TableDecimal SCP GTRACE Emulation The valid EID ranges are HSC Internal Trace Table Figure 23. HSC Internal Trace Table Example Format of HSC GTRACE USR Records HSC TRACE CommandSetting Initialization Sequence Break-Points Diagnostic CommandsVM CP Commands SCP Debug Modelength offset=DEBUG SCP Diagnostic Subsystem CommandsEnabling the Diagnostic Subsystem fieldname =NODEBUG=DDICT length =HPERepname offsetepname =WHEREaddress data-structure HSC Diagnostic CommandsLIst Command Syntax Parametersaddress DISPLAY Commandsize Control Data Set Recovery CDS Recovery CapabilitiesDynamic Recovery of the Control Data Set 1st ed., 6/30/04 - 386VM/HSC 6.0 System Programmer’s GuideFigure 24. Control Data Set Recovery Scheme Control Data Set Processes Control Data Set Error DiagnosticsDetecting Mismatch of Control Data Sets Control Data Set Integrity During RestoreInformation Required for StorageTek Diagnosis Recommended Recovery ActionsType of Dumps Supported How to Request a DumpDump Processing Note Reason For Dump What to do When a Dump OccursCall StorageTek Software Support Move Problem Materials to TapeLoad Dump and CONSLOG Onto Disk Dump Analysis Using SLUIPCS VIEW STORMAN VIEW LVT VIEW structname SLUIPCS SCAN SubcommandsVIEW VIEW CVT VIEW CCVT VIEW NUCON VIEW MTTData Structures Data StructuresIHAASCB TTE TRACE TABLE ENTRY EX EXECUTE CMS COMMANDFIND TRB SAVE AREA TRACEBACKTASK FIND TASK WA WHERE ADDRESSWN WHERE NAME STAT STATUSSLUIPCS PRINT Options Major SCP Data RelationshipsNUCON X’10’ VECTPTR TRCTAB Command, Message, Trace ProcessingFigure 25. Command, Message and Trace Processing 1st ed., 6/30/04 -Subsystem Data Relationships Diagnostic TechniquesSCP Task/Job Data Relationships RQBLOK Figure 26. SCP Task/Job Data RelationshipNUCON JBLOK PSAAOLD JBLTASK TBLOK PSATOLD TKRBLISTJESCT JESSSCT SSCT SSCTSCTA SSCTSSVT SSCT Figure 27. Subsystem Data Relationships404VM/HSC 6.0 System Programmer’s Guide NUCON CVT VECTPTR CVTJESCTView an HSC or SCP Data Area Common Dump Analysis TasksFind a Module Plus Offset, Given an Address Find a Module Address, Given a NameFind the Failing Request Block Identify the Failing RoutineFind the Failing Task Identify the Last Interrupt Event Save Area Trace BackFind the LVT Find the LCT, LST, HSTFind IUCV Path Descriptors Gather Diagnostic MaterialsDiagnostic Materials Examine an SDWAdetails of problem circumstances •STKACS abend Tape Return Tape FormatOverview Chapter 6. Performance ConsiderationsHow Library Activity Affects Library Performance How Operators Control Library Performance Using the Activities Report UtilityMonitoring Library Activity and Performance ACS Daily Report Tape Volume Report414VM/HSC 6.0 System Programmer’s Guide Redistribute Scratch Volumes in the LibraryMaintain Quantities of Scratch Cartridges Define CAP PreferencesPerformance Parameter Use SMF Records to Collect Performance DataUse PARMLIB to Define Static Parameters Operator CommandJournal Definition Set High-Performance Host-to-HostCommunications Define High Dispatching Priority for the HSC418VM/HSC 6.0 System Programmer’s Guide Functioning of Host-to-HostCommunicationsDesignation of Communication parameters Limit View Time to Maintain High Performance Define Secondary and Standby Control Data SetsAdvantages of Using the VIew Command Excessive Use of VIew Command Affects PerformanceHow to Monitor Usage of the VIew Command 1st ed., 6/30/04 - Chapter 6. Performance ConsiderationsReduce Pass-Thrus Loading Cartridges Into the LibraryWays to Reduce Pass-ThruActivity Unavoidable Pass-ThrusUnnecessary Pass-Thrus Scheduled Pass-ThrusRedistribute cartridges during off-peaktimes Reduce Operator InterventionEnsure adequate free cells Eject through the CAP closest to the cartridgeAvoid Crashing Test Systems ACSPROP EXECReduce Tape Transport Contention Prefetch EntersParameters Reduce Scheduling ContentionUsage Requirements SyntaxUse the Audit Utility Effectively Use Performance Log Reblocker to Format DataUse LSMs as Scratch Loaders in a Mixed ACS Variables Commands Syntax ReferenceSyntax Flow Diagrams Specifying CommandsSingle Required Choice Flow LinesDefault Value Value2 Value3 DefaultsRepeat Symbol Single Optional Choice1st ed., 6/30/04 - Syntax Continuation FragmentsFragment 432VM/HSC 6.0 System Programmer’s GuideLibrary Identification WolfCreek LSM Models 9360-050, 9360-075,and How to Specify a CAPidCAPid Formats LSM Model 4410 and PowderHorn LSM Model00indicates one of the following 436VM/HSC 6.0 System Programmer’s Guide Ranges And ListsA00A0-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 follows440VM/HSC 6.0 System Programmer’s Guide SCRPOOL NAME=STD36,RANGEAAA000AAA999ZZZ000ZZZ999 acs-id, lsm-id MEDia, RECtech, and MODel ParametersMODel, and RECtech parameters acs-id, lsm-idMount acs-id, lsm-id VOLATTR1st ed., 6/30/04 - LIBGEN Macros444VM/HSC 6.0 System Programmer’s Guide SLIDRIVS macros SLIACS macroSLIALIST macro SLIDLIST macro1st ed., 6/30/04 - SLILIBRY macro446VM/HSC 6.0 System Programmer’s Guide SLIRCVRY SLILSM macroSLIRCVRY macro SLISTATN macro448VM/HSC 6.0 System Programmer’s Guide HSC Control StatementsEXECParm control statement Journal Definition JRNDEF control statementVOLumevolser LKEYDEF command and control statementLKEYINFO control statement LMUPATH control statement1st ed., 6/30/04 - OPTion control statementScratch Subpool SCRPOol control statement 450VM/HSC 6.0 System Programmer’s GuideTape Request TAPEREQ control statement 452VM/HSC 6.0 System Programmer’s Guide Tape Request TAPEREQ control statement continuedUnit Attribute UNITATTR control statement 1st ed., 6/30/04 - Volume Attribute VOLATTR control statement454VM/HSC 6.0 System Programmer’s Guide STK1RA STK1RA34 STK1RA35 STK1RB STK1RB34 STK1RB35 1st ed., 6/30/04 - 456VM/HSC 6.0 System Programmer’s GuideACSacs-id UtilitiesACTIvities Report utility AUDIt utilityEJECt utility BACKup utilityDatabase Decompile LIBGEN utility Directory Rebuild DIRBLD utilityEnter Cartridges utility EJECt utility continuedREPLace utility Reconfiguration utilityJournal OFFLoad utility MOVe utilitySCRAtch utility RESTore utility462VM/HSC 6.0 System Programmer’s Guide Scratch Redistribution SCREdist utilityOptions SET utility464VM/HSC 6.0 System Programmer’s Guide UNSCratch utilityUnselect utility SET utility continuedVolume Report VOLRpt utility 466VM/HSC 6.0 System Programmer’s Guide Operator CommandsCDs Enable/Disable command CLean commandDISMount command Display ALLOC Display commandDisplay Acs Display ALlCMd COmmand Display CmdDisplay COMMPath Display DRives470VM/HSC 6.0 System Programmer’s Guide Display Drives continuedDisplay LSM Display ExceptionsDisplay LKEYDEF Display LMUPDEF472VM/HSC 6.0 System Programmer’s Guide Display MONitorDisplay OPTion Display RequestsDisplay SCRatch 474VM/HSC 6.0 System Programmer’s Guide Display SCRPDEFDisplay SRVlev Display StatusDisplay TREQDEF Display THReshldDisplay UNITDEF DRAin CAP commandEJect command Display VolumeEject Command continued MONITOR command ENter commandJournal command MODify commandhost-id Mount commandvolser devaddr480VM/HSC 6.0 System Programmer’s Guide Flsmlsm-id MOVe commandVolume MOVe482VM/HSC 6.0 System Programmer’s Guide OPTion command and control statementRECover Host command RELease CAP commandSWitch command SENter commandSRVlev Service Level command Stop Monitoring STOPMN command484VM/HSC 6.0 System Programmer’s Guide TRace commandTRACELKP command Vary Station commandVIew command 486VM/HSC 6.0 System Programmer’s Guide Warn command1st ed., 6/30/04 - HSC Diagnostic CommandsLIst command TRace commandCP Command SCP Operator CommandsAUTHorize Command CANCEL commandQuery Command FILE CommandHELP Command Modify Command SCP490VM/HSC 6.0 System Programmer’s Guide Reply CommandSET Command events destinationSTOPSCP Command SLK CommandSTArt Command STOP Command1st ed., 6/30/04 - GCS Component Server CommandsSLKGCS Command 494VM/HSC 6.0 System Programmer’s Guide CMS Operator CommandsACS EXEC CMS HELPOverview Appendix B. CP Commands and DIAGNOSE CodesCP Commands CP Programming Services1st ed., 6/30/04 - IUCV496VM/HSC 6.0 System Programmer’s Guide Overview Appendix C. Record FormatsType Mapping Macros for SMF RecordsMapping Macros for LOGREC Records Mapping Macros for Batch API RecordsSMF Mapping Macros SMF RecordsType SMF Record FormatsSLSDVAR Cross ReferenceLength SLSSFHDRTable 33. SLSSFHDR Record Format TypeLabel Table 33. SLSSFHDR Record Format ContinuedType LengthLabel Table 33. SLSSFHDR Record Format ContinuedType Length504VM/HSC 6.0 System Programmer’s Guide Cross ReferenceAppendix C. Record Formats NameOffset ValueSLSSBLOS SIGNED-FWORD Cross ReferenceCross Reference SLSSCAPJCross Reference SLSSCAPNSLSSVSTA Appendix C. Record Formats Cross ReferenceSLSSVSTA Cross Reference SLSSMLSMSLSSLSB Length Cross ReferenceTable 39. SLSSLSB Record Format Continued TypeSLSSMF07 1.1 X’05’ CHARACTER CHAR CONST LENGTH 520VM/HSC 6.0 System Programmer’s Guide Cross ReferenceAppendix C. Record Formats SMF07MVU522VM/HSC 6.0 System Programmer’s Guide SLSSMF08 524VM/HSC 6.0 System Programmer’s Guide Cross ReferenceLOGREC Mapping Macros LOGREC RecordsSLSSLHDR LOGREC Record FormatsOFFSET Label Table 43. SLSSLHDR Record Format ContinuedType LengthAppendix C. Record Formats Cross ReferenceLTYPAREA 530VM/HSC 6.0 System Programmer’s Guide SLSSVLG1 532VM/HSC 6.0 System Programmer’s Guide Cross ReferenceSLSSBLOG 534VM/HSC 6.0 System Programmer’s Guide Cross ReferenceSLSSLLG1 CONST 1.. .... X’40’ 538VM/HSC 6.0 System Programmer’s Guide Cross ReferenceAppendix C. Record Formats LLG1NWSNSLSSLLG2 HEXSTRING Cross ReferenceCross Reference SLSSLLG3SLSSLLG4 544VM/HSC 6.0 System Programmer’s Guide Cross ReferenceSLSSLLG5 1... .... X’80’ Appendix C. Record Formats Cross ReferenceLLG5ACS SLSSLLG6 1... X’08’ SIGNED-FWORD Appendix C. Record Formats Cross ReferenceLLG6ACS 552VM/HSC 6.0 System Programmer’s Guide SLSSDJLR CHARACTER Cross ReferenceSLSSPSWI 556VM/HSC 6.0 System Programmer’s Guide Cross ReferenceCross Reference SLSSRL00Cross Reference SLSSRL01SLSSHLG1 1. .... X’20’ Appendix C. Record Formats Cross ReferenceHLG1FLG1 Volume Report and Batch API Mapping Macros Volume Report and Batch API RecordsSLUVADAT Volume Report and Batch API Record Formats1.. .... X’40’ HEXSTRING 1 ..1. X’12’ X’80’ Cross Reference568VM/HSC 6.0 System Programmer’s Guide Appendix C. Record Formats LSMNADLS570VM/HSC 6.0 System Programmer’s Guide SLUVCDAT 1 X’01’ Appendix C. Record Formats Cross ReferenceCFGCCPFX SLUVHDAT 1.. .... X’40’ 576VM/HSC 6.0 System Programmer’s Guide Cross ReferenceSLUVIDAT CHARACTER Appendix C. Record Formats Cross ReferenceCDSALL SLUVSDAT Appendix C. Record Formats Cross ReferenceSTNACS SLUVVDAT CHAR CONST CHARACTER CHARACTER X’20’ HEXSTRING HEXSTRING Appendix C. Record Formats Cross ReferenceVOLDEST 590VM/HSC 6.0 System Programmer’s Guide Appendix C. Record Formats VOLRRCNL592VM/HSC 6.0 System Programmer’s Guide Appendix C. Record Formats Batch API RecordsBatch API Mapping Macros Table 64. Mapping macros for Batch API RecordsSLUVDDAT Batch API Record FormatsF0F1 Cross Reference596VM/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 ReferenceUVPTWSTD NameOffset Value1st ed., 6/30/04 - 602VM/HSC 6.0 System Programmer’s GuideRobotics Motion Start Counts Temporary Motion Error CountsAppendix D. Logging ACS Robotics Motion Information Being Logged1st ed., 6/30/04 - Permanent Motion Errors604VM/HSC 6.0 System Programmer’s Guide Description of Field How Information is LoggedBYTE # 46-46 152-155 Description of Field Motion Hard Fail Software Error RecordBYTE # Logging Interval Multi-HostEnvironment Single-HostEnvironmentLMU 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 rewoundLMU 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 Codes: 1001 -Undefined Response Code 10121st ed., 6/30/04 - Appendix E. Remote-linkedLibrariesOverview Appendix E. Remote-linkedLibraries622VM/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 Overview QCDS RequestHow QCDS Functions Invoking QCDS SLSUREQ MacroSLSUREQ VM Requirements Addresses and RegistersVM Requirement REQUEST Parameterslabel SyntaxThis parameter is required BUFFER UCALADR QCDS Programming ConsiderationsE,parmaddr NotesInvalid SLSUREQ Requests Return CodesReturn Field Name Decimal Value and DescriptionSample 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 GuideRECORD AREAS IN AN ALTERNATING FASHION 642VM/HSC 6.0 System Programmer’s Guide PROCESS Records Returned Output DescriptionRequest Entered PRO=NO|YES SLSUREQM MacroSyntax ParametersBatch API Mapping SLSUREQM Macro A-ADDR SIGNED-FWORD CONST CONST SLSUACSA Cross Reference652VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 - 1st ed., 6/30/04 - 654VM/HSC 6.0 System Programmer’s GuideGlossary 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 Symbols8500 library— See StreamLine SL8500 library 1st ed., 6/30/04 - 670VM/HSC 6.0 System Programmer’s GuideIndex IndexNumerics 672VM/HSC 6.0 System Programmer’s Guide Index control data set definition control statement674VM/HSC 6.0 System Programmer’s Guide 377, 383, 676VM/HSC 6.0 System Programmer’s Guide Index Library Control Unit LCU, defined678VM/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 functions682VM/HSC 6.0 System Programmer’s Guide Index SRVlev command684VM/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