Manuals / StorageTek / Household Appliance / Water System

StorageTek 6 manual How to Specify a CAPid

Models: 6

1 718

Page 14

How to Specify a CAPid	434
CAPid Formats	434
Ranges And Lists	436
Control Statement Syntax Conventions	439
MEDia, RECtech, and MODel Parameters	441
LIBGEN Macros	444
SLIACS macro	445
SLIALIST macro	445
SLIDLIST macro	445
SLIDRIVS macros	445
SLIENDGN macro	445
SLILIBRY macro	446
SLILSM macro	447
SLIRCVRY macro	447
SLISTATN macro	447
HSC Control Statements	448
Control Data Set Definition (CDSDEF) control statement	448
EXECParm control statement	448
Journal Definition (JRNDEF) control statement	448
LKEYDEF command and control statement	449
LKEYINFO control statement	449
LMUPATH control statement	449
LMU Path Definition (LMUPDEF) command and control statement	449
OPTion control statement	450
Reconfiguration Definition (RECDEF) control statement	450
Scratch Subpool (SCRPOol) control statement	450
Scratch Subpool Definition (SCRPDEF) command and control statement	451
Tape Request (TAPEREQ) control statement	451
Tape Request (TAPEREQ) control statement (continued)	452
Tape Request Definition (TREQDEF) command/control statement	453
Unit Attribute (UNITATTR) control statement	453
Unit Attribute Definition (UNITDEF) command/control statement	454
Volume Attribute (VOLATTR) control statement	454
Volume Attribute (VOLATTR) control statement (continued)	455
Volume Attribute Definition (VOLDEF) command/control statement	456
Utilities	457
ACTIvities Report utility	457
AUDIt utility	457
BACKup utility	458
Database Decompile (LIBGEN) utility	458
Directory Rebuild (DIRBLD) utility	458
EJECt utility	458
EJECt utility (continued)	459
Enter Cartridges utility	459
Journal OFFLoad utility	460
MOVe utility	460

xivVM/HSC 6.0 System Programmer’s Guide

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

Page 14

Image 14

StorageTek 6 manual How to Specify a CAPid

Contents

312579601 System Programmer’s GuideRelease Host Software Component VM ImplementationLimitations on Warranties and Liability Export Destination Control StatementRestricted Rights Proprietary Information StatementHost Software Component for Document EffectivityDoc Kit Number Document EffectivityivVM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 -Preface ContentsWhat’s New With This Release? 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 -Installation Guide What’s New With This Release?Installation Guide Installation GuideSystem Programmer’s Guide Installation GuideSystem Programmer’s Guide System Programmer’s GuideIntended Audience PrefaceScope Organization of This GuideHow to Use This Guide Reader’s Comments References to HSC Product ReleasesRelated Publications 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 ArchitectureCONTROL APPLICATIONSCOMMON SERVERSVM Environment VM Operating System CP and CMSDevice Management System Control Program SCPStorage Management File ManagementProcessor Management Task ManagementJob Management CommunicationHost Software Component HSC Virtual Machine ConfigurationTask Recovery/Termination 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 Utilities User Control of HSC FunctionsMacros 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 Base CommandService Level Execution FullBase Service Level ExecutionUtility 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 Precedence of VOLATTR and TAPEREQ Statements Specific Volume RequestsNonspecific Volume Requests 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 Virtual Thumbwheel VTW HSC Mount Command SupportExample of Mount Command with Readonly Operand 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 Renaming/Relocating a CDS - Scenarios Using CDS Rename/Relocate/ExpandCDs Command Renaming a CDS CopyCDS ENABLE DSNACS.DBASENEW NEWLOC Relocating an Uncataloged CDS CopyExpanding a CDS - Scenario 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 If the Master LMU Fails LMU Server FunctionsDual LMU Functionality 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 Communication Lost to Master LMU Operator Intervention - Single LMU ConfigurationOperator Intervention - Dual LMU Configuration Communication Lost to Standby LMUSystem Profile File ACS SYSPROF Configuring VM for TCP/IP SupportSystem Definition File ACS SYSDEF HSC Startup Job File ACS SLKJCLCommands to Format CMS Reserved Minidisk Initializing the LMUPATH Definition Data SetCommands to Format OS Minidisk Minidisk Statement for the LMUPATH Data SetFILE SYSPRINT DEV PRNT CLASS A LMUPATH Definition Data SetJOB SLSXUTIL SLUGENER /PARM RECCOPY FILE SYSUT2 DEV <vaddr> DSN <dsname> /FILE SYSUT1Communication Functions Host-to-HostCommunications ServicesTypes of Communications Services 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 CAP Preference Definition Processing PARMLIB Control StatementsOptions Offered by PARMLIB Control Statements Control Data Set DefinitionJournal Data Set Definition Communications Path DefinitionEXECPARM Control Definition License Key InformationOption Control Control Statement Continuation ConventionsReconfiguration CDS Definition Scratch Subpool ControlCDSDEF CDS Definition CDSDEF Control Statement SyntaxParameters CDSDEFControl Statement Name DISABLECDSDEF ExampleDSN3SLS.DSTBY,VOL3HSC103,UNIT3503,+ DISABLE CDSDEF DSN1SLS.DBASE,VOL1HSC101,UNIT1501,+Control Statement Name EXECParm EXECParm Control StatementSyntax EXECParmHOSTID EXECParm Control Statement - Command Prefix OffEXECParm ExampleSyntax JRNDEFJournal Definition JRNDEF Control Statement Control Statement NameFULL JRNDEFUNITx AbendParameter Descriptions LKEYDEF LKEYDEF Command and Control StatementCommand Name dataset-namehost-id LKEYDEFunitname UNITcustomer-name LKEYINFOproduct-identifier nnnnnnnLKEYINFO license-key-stringExamples Control Statement Name RECDEFSyntax RECDEFRECDEF DSN1SLS.DBASE,VOL1HSC101,UNIT1501,+ RECDEFExample DSN2SLS.DBSEC,VOL2HSC102,UNIT2502Control Statement Name SCRPOol Scratch Subpool Control StatementSyntax SCRPOolNotes SCRPOolRANGE LABELExample Other Methods of Controlling Scratch SubpoolsSCRPOol Definition Data Set Control Statements LMU Parameter Definition OPTion TITLELMU Path Scratch Subpool Parameter Statement DefinitionVolume Attribute Defining LMU Network ConnectionsDefining Tape Request Attributes TAPEREQ Volume Attribute DefinitionDefining Volume Attributes VOLATTR Defining Unit Attributes UNITATTRIdentifying the Definition Data Sets OPTION TITLE Control Statement Continuation ConventionsSyntax LMUPATH LMUPATH Control StatementLMUPATH Usage Control Statement Namennn.nnn.nnn.nnn LMUPATHlmu_hostname LMUADDRLMUPDEF LMUPDEF Command and Control Statement 110VM/HSC 6.0 System Programmer’s GuideSyntax LMUPDEFdataset.name Control Statement Nameunitname LMUPDEFLoad the LMUPATH Parameters From YOUR.DSNMEMBER host-idSyntax OPTion TITLE OPTion TITLE Control Statementidentifying-string Control Statement Name114VM/HSC 6.0 System Programmer’s Guide OPTion TITLEExample 1st ed., 6/30/04 -SCRPDEF Control Statement Name SCRPDEFSyntax Parametersunitname Load the SCRPOol Parameters From YOUR.DSNMEMBERSCRPDEF 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 TAPEREQ job-namestep-name Control Statement NameTAPEREQ program-nameDD-name PROGram or PGMnameTAPEREQ retention-periodexpiration-date EXPDTStandard TAPEREQLONGItud ECARTDD3A, DD3B, DD3C TAPEREQZCART STK1Notes TAPEREQRECtech LONGItudTAPEREQ 36AtrackTAPEREQ STK1RC4490 subpool-nameTAPEREQ Example Set Tape Request AttributesTAPEREQ 132VM/HSC 6.0 System Programmer’s GuideTREQDEF Control Statement Name TREQDEFSyntax Parametersunitname Load the TAPEREQ Parameters From YOUR.DSNMEMBERTREQDEF host-idUNITATTR Usage UNITATTRUnit Attribute UNITATTR Control Statement Syntax UNITATTRunit-address Control Statement NameUNITATTR MODelT9940B35 Specify Unit Attribute StatementsUNITATTR IGNOREUNITDEF 140VM/HSC 6.0 System Programmer’s GuideControl Statement Name UNITDEFSyntax ParametersExamples UNITDEFhost-id 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 Syntax This syntax diagram is continued on the next pageVOLATTR VOLATTR SERial volserControl Statement Name VOLATTRSyntax continued VOLATTRParameters volser or vol-rangeor vol-listVOLATTR SERialVOLATTR Valid media types areDD3A, DD3B, DD3C, DD3D VOLATTRZCART STK1RECtech VOLATTRSTK2P, STK2W LONGItudVOLATTR indicates a 9490 Timberline transportSTK1RC34 use-limitVOLATTR Example Set Volume AttributesVOLATTR VOLATTR SERIALL*,AA9* MEDIAECARTVOLDEF 154VM/HSC 6.0 System Programmer’s GuideControl Statement Name VOLDEFSyntax Parametersunitname Load the VOLATTR Parameters From YOUR.DSNMEMBERVOLDEF host-idPARM Statement Parameters Creating an SLKJCL File for Starting the HSCPARM Statement SyntaxCOLD RESETSSYS Dialog RECONFIGMember BothHSC Startup Job ACS SLKJCL Sample ACS SLKJCL File ExampleSLSSYSXX Description of /FILE StatementNotes Modifying LSMs Online Configuration MismatchesStarting HSC Execution 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 fileJOB Statement JCL and Control StatementsSCP Batch Job Control Language JCL jobnameCOMM Statement PARM Statementparms commentsftype Submitting Jobsfname fmodeUtility Control Statements Control Statements vs. JCLUtility Administrator SLUADMIN How to Invoke SLUADMINReturn Code How to Invoke Utility ProgramsSLUADMIN Program Return Codes DescriptionParameters Controlling Report Headings Reports Created by UtilitiesReport Headings DATE=2YR Example of JCL Using Report Heading OptionsExample DATE=4YRStand-AloneUtilities SLUACTV EXEC Activities Report UtilityActivities Report typePARM SLSSMF fname ftype fmodeActivities Report MIXEDParameters SyntaxUtility Name begin-dateActivities Report end-dateend-time TODAYOutput Description Invoking the Activities Report UtilityControl File Example Control File to Produce an Activities ReportActivities Report TotalAve. time Activities Report% of all Ave. pass-thrusEarliest Usage NotesActivities Report LatestActivities Report •LSM operating statistics record, subtype 1, andARM USE Activities ReportACS ID P-THRU196VM/HSC 6.0 System Programmer’s Guide Activities ReportUsage Notes Chapter 4. Utility Functions Activities ReportFigure 9. Activities Report Utility Sample Output 1st ed., 6/30/04 -Audit Utility AuditMedia Type Mismatch Conditions AuditAudit Actions Permitted During an AuditHow the AUDIt Utility Functions Concurrent Audits AuditSyntax acs-idAudit Utility NameAudit lsm-listpanel-list PANelAudit row-listcolumn-list Notescap-id AuditDIAGScan AuditEMPTYCel NotesACSUTIL SLKJCL File JCL RequirementsInvoking the Audit Utility AuditJCL for Selective Audit 1 ACS, 2 LSMs, with CAPid JCL ExamplesJCL for Audit of Entire Library all ACSs AuditAudit JCL for Selective Audit of Diagnostic Cells OnlyJCL for Selective Audit of Empty Cells Output Description210VM/HSC 6.0 System Programmer’s Guide AuditFigure 10. AUDIt Utility Sample Output 1st ed., 6/30/04 -Reasons for Running the BACKup Utility Backup UtilityBackup PrerequisitesBackup How the BACKup Utility Functions Backup Backup Procedure Syntax BackupBACKup Utility NameSecondary BackupPrimary STandbyBackup RestartSLSCNTL Backup JCL RequirementsSLSPRINT SLSCNTL2Backup Invoking the BACKup Utility ACSUTIL SLKJCL FileRun Backup Utility Backup JCL ExamplesJCL for Running Backup JCL for Running a Copy Backup•the following data sets BackupOutput Description 4warning MESSAGES – Backup successful Backup•a condition code from backup processing Chapter 4. Utility Functions222VM/HSC 6.0 System Programmer’s Guide BackupFigure 11. BACKup Utility Sample Output 1 of 1st ed., 6/30/04 -Chapter 4. Utility Functions BackupFigure 11. BACKup Utility Sample Output 2 of 1st ed., 6/30/04 -224VM/HSC 6.0 System Programmer’s Guide Backup How to Restart BackupRelated Utilities How the Database Decompile Utility Functions Database Decompile LIBGEN UtilityDatabase Decompile PrerequisitesParameters Database Decompile SyntaxUtility Name JCL RequirementsJCL for Database Decompile Invoking the Database Decompile UtilityJCL Example Database DecompileLabel Database Decompile Output DescriptionDevice 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 Reasons for Running the Directory Rebuild Utility Directory Rebuild UtilityDirectory Rebuild How the Directory Rebuild Utility FunctionsSLSCNTL, SLSCNTL2, SLSSTBY Directory RebuildInvoking the Database Decompile Utility SLSINOutput Description Directory Rebuild JCL ExampleJCL for Directory Rebuild Syntax Eject Cartridge UtilityEject Cartridge EJECt Eject CartridgeUtility Name Eject Method 2 continuedcount Eject Cartridge Parametersvol-list VOLserEject Cartridge •CST •MEDIA1 •STD •1 •3480Eject Cartridge Note: STK2P can be abbreviated to PEject Cartridge indicates a 3490E-image9840 transportcap-list Eject CartridgeJCL Requirements Invoking the Eject Cartridge UtilityEject Cartridge ACSUTIL SLKJCL FileJCL to Eject Five SD-3Scratch Cartridges JCL for Ejecting a Single VolumeJCL to Eject One STD Scratch Cartridge Eject Cartridge248VM/HSC 6.0 System Programmer’s Guide Eject Cartridge Output DescriptionFigure 13. EJECt Cartridge Utility Sample Output CAP Operating Instructions Enter Cartridges UtilityEnter Cartridges SyntaxJCL Requirements Invoking the Enter Cartridges UtilityEnter Cartridges SCRatchJCL Example JCL for Entering Cartridges in a CAPEnter Cartridges Output Description252VM/HSC 6.0 System Programmer’s Guide Enter CartridgesFigure 14. Enter Cartridge Utility Sample Output 1st ed., 6/30/04 -Syntax Journal Offload UtilityJournal Offload Utility NameSLSOFF02 Invoking the Journal Offload UtilityJournal Offload SLSINOutput Description Journal Offload JCL ExampleJCL for Offload of Journals 256VM/HSC 6.0 System Programmer’s Guide Journal OffloadFigure 15. Journal Offload Utility Sample Output 1st ed., 6/30/04 -MOVe Considerations Move UtilityMove Syntax lsm-idMove Utility Namerow-list panelMove column-listACSUTIL SLKJCL File Move JCL RequirementsInvoking the Move Utility Output Description Move Several Volumes From an LSM to Another LSMMove JCL Examples 262VM/HSC 6.0 System Programmer’s Guide MoveFigure 16. MOVe Utility Sample Output 1st ed., 6/30/04 -Syntax CMS Statement Performance Log Reblocker UtilityPerformance Log Reblocker Performance Log Reblocker utilityPerformance Log Reblocker JCL Requirements mvsnodePerformance Log Reblocker 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 Condition I/O ConsiderationsReconfiguration Number of I/OsReconfiguration Running a Successful ReconfigurationMinimizing I/O Time 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-diskBReasons for Running the RESTore Utility Restore UtilityRestore How the RESTore Utility FunctionsUtility Name RestoreRESTore ParametersOnly RestoreJCL Requirements ShortACSUTIL SLKJCL File Restore Invoking the Restore UtilityJCL Examples Restore JCL for RESTore with Journals AppliedJCL for RESTore with GENerate Only 280VM/HSC 6.0 System Programmer’s GuideOutput Description JCL for RESTore Journals and Output to SLSAUDITRestore 282VM/HSC 6.0 System Programmer’s Guide RestoreFigure 17. Restore Utility Sample Output 1st ed., 6/30/04 -How to Handle BACKup/RESTore Discrepancies RestoreHow the Scratch Redistribution Utility Functions Scratch Redistribution UtilityScratch Redistribution SCREdist Scratch Redistribution SyntaxUtility Name Chapter 4. Utility Functionsacs-id Scratch Redistribution Parameterstolerance-value 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 transportJCL Examples Scratch Redistribution JCL RequirementsInvoking the Scratch Redistribution Utility ACSUTIL SLKJCL FileJCL to Perform Scratch Redistribution JCL to Perform Scratch RedistributionScratch Redistribution JCL to Perform Scratch RedistributionScratch Redistribution Output Description 294VM/HSC 6.0 System Programmer’s GuideUtility Names Scratch Update UtilitiesScratch Update SCRAtch utilityJCL Requirements Scratch Update ParametersInvoking the Scratch Update Utilities vol-listJCL Example JCL to Scratch, Unscratch, and ReplaceScratch Update Output Description298VM/HSC 6.0 System Programmer’s Guide Scratch UpdateFigure 19. Scratch Update Utilities Sample Output 1st ed., 6/30/04 -SET Utility Affected HSCs How the SET Utility FunctionsSET Option 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 Utility Name SET ACS Esotericesoteric ParametersSET HSC Command Prefix SET Cleaning PrefixSET CLNPRFX PROCEDURE prefixCharacter DescriptionSCRTCH SET Eject PasswordSET Delete Disposition NOSCRTCHFREEZE oldpswdSET Freeze Panel oldhost SET Host IDnewhost SET HSC LevelSET New Host SET ENQ/DEQ/RESERVE QNAMEqname model-hostesoteric SET Scratch Label TypeSET Device Numbers for Drives FORHOSTaddr0,...addr19 lsm-id Running SET SLIDRIVS With the HSC ActiveFORLSMID FORPANELstat1,...,stat16 SET SLIDRIVS ProcedureSET LMU Station Address Numbers SLISTATNlibtype SET Recovery TechniqueSET SMF Record Type FORACSSHADOW SET TCHNIQE PROCEDUREJCL Requirements BOTHInvoking the Set Utility ACSUTIL SLKJCL FileSet JCL Examples JCL for Set UtilityJCL for Multiple SET Statements Output DescriptionSyntax Unselect UtilityUnselect Parameters Unselect Utility NameInvoking the Unselect Utility JCL RequirementsJCL Example JCL to Unselect a VolumeUnselect Output DescriptionChapter 4. Utility Functions UnselectFigure 20. Unselect Utility Sample Output 1st ed., 6/30/04 -Volume Report Utility Volume ReportMedia Type and Recording Technique Considerations Volume ReportVolume Report •change the VOLATTR statementsVolume Report Syntax Parameters Volume Report Utility Namevolser or vol-range or vol-list acs-idVolume Report SORTVolume Report INCLudeNONMEDEQ Volume ReportMEDEQUAL NOEXTernalVOLDATA Volume ReportVOLIST CDSDATASLSCNTL, SLSCNTL2, SLSSTBY JCL/Parameter File RequirementsVolume Report SLSPRINTvaddr JCL/Parameter File SyntaxSLSCNTL control.set.nameSLSCDATA CMS only fn, ft, fmkeywords SLSSCRPL CMS onlyparameters SLSVA CMS onlyPARM JOB SCP onlyParameter File Volume Report Invoking the Volume Report UtilitySLUVOLR EXEC CMS ACSUTIL SLKJCL FileJCL Example JCL to Produce a Volume ReportVolume Report Media and Recording Technique Origin JCL to Produce a Volume Report for an MVS PDSReport Detail Lines Volume ReportExternal Label Field Media Type Prefix CharactersErrant, Scratch, Selected Fields Cartridge Usability CLN USE FieldTimes Selected Field Volume Report TotalsSubpool ID 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 -HSC Messages MessagesAbend Codes SCP MessagesCCWTRACE Software Trace FacilitiesCP Trace Table TRACE Command Syntax VM CP Debug CommandsSCP SET TRACE Command SCP Internal Trace TableMaster Trace Table Header Trace Table EntriesDSP Trace Entry Code Query= IRT address IPARML IUCV Parameter ListTTEWORD1 TTEWORD2 = IPARML bytesIPARML for IUCV CONNECT to *BLOCKIO Inputs=target class 1=write; 2=read =flags type=2way IPARML for IUCV SEND to *BLOCKIOInputs =relative block number =data buffer address= target class IPARML for IUCV RECEIVEInputs = flags= IUCV message id IPARML for IUCV REPLYInputs = target class= name of virtual machine connected to IPARML for IUCV SEVERInputs OutputsIPRCODE Interrupt Type IUCV Interrupt BufferIPTYPE IPARML for Pending Connection Interrupt IPARML for Connection Complete Interrupt IPTYPE IPPATHID= IUCV path id = 03=severed, 04=quiesced, 05=resumedIPARML for Incoming Message Interrupt IPARML for Message Complete Interrupt SCP Trace Facility Diagnostic CapabilitiesError Recording Data Set Records Supervisor Call and Abnormal End DumpsSCP External Trace Facility SLUETRAC SCP Trace Formatter UtilityEXEC 368VM/HSC 6.0 System Programmer’s Guideinfm infninft 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 RecordsSCP Debug Mode Diagnostic CommandsVM CP Commands Setting Initialization Sequence Break-Pointsoffset length=DEBUG SCP Diagnostic Subsystem CommandsEnabling the Diagnostic Subsystem fieldname =NODEBUG=DDICT offset =HPERepname lengthepname =WHEREaddress Syntax Parameters HSC Diagnostic CommandsLIst Command 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 VIEW CVT VIEW CCVT VIEW NUCON VIEW MTT SLUIPCS SCAN SubcommandsVIEW VIEW STORMAN VIEW LVT VIEW structnameData Structures Data StructuresIHAASCB TRB SAVE AREA TRACEBACK EX EXECUTE CMS COMMANDFIND TTE TRACE TABLE ENTRYSTAT STATUS WA WHERE ADDRESSWN WHERE NAME TASK FIND TASKMajor SCP Data Relationships SLUIPCS PRINT Options1st ed., 6/30/04 - Command, Message, Trace ProcessingFigure 25. Command, Message and Trace Processing NUCON X’10’ VECTPTR TRCTABSubsystem Data Relationships Diagnostic TechniquesSCP Task/Job Data Relationships TKRBLIST Figure 26. SCP Task/Job Data RelationshipNUCON JBLOK PSAAOLD JBLTASK TBLOK PSATOLD RQBLOKNUCON CVT VECTPTR CVTJESCT Figure 27. Subsystem Data Relationships404VM/HSC 6.0 System Programmer’s Guide JESCT JESSSCT SSCT SSCTSCTA SSCTSSVT SSCTFind a Module Address, Given a Name Common Dump Analysis TasksFind a Module Plus Offset, Given an Address View an HSC or SCP Data AreaFind the Failing Request Block Identify the Failing RoutineFind the Failing Task Find the LCT, LST, HST Save Area Trace BackFind the LVT Identify the Last Interrupt EventExamine an SDWA Gather Diagnostic MaterialsDiagnostic Materials 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 ReportDefine CAP Preferences Redistribute Scratch Volumes in the LibraryMaintain Quantities of Scratch Cartridges 414VM/HSC 6.0 System Programmer’s GuideOperator Command Use SMF Records to Collect Performance DataUse PARMLIB to Define Static Parameters 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-ThrusScheduled Pass-Thrus Unavoidable Pass-ThrusUnnecessary Pass-Thrus Ways to Reduce Pass-ThruActivityEject through the CAP closest to the cartridge Reduce Operator InterventionEnsure adequate free cells Redistribute cartridges during off-peaktimesPrefetch Enters ACSPROP EXECReduce Tape Transport Contention Avoid Crashing Test SystemsSyntax Reduce Scheduling ContentionUsage Requirements ParametersUse Performance Log Reblocker to Format Data Use the Audit Utility EffectivelyUse LSMs as Scratch Loaders in a Mixed ACS Specifying Commands Commands Syntax ReferenceSyntax Flow Diagrams VariablesFlow Lines Single Required ChoiceSingle Optional Choice DefaultsRepeat Symbol Default Value Value2 Value3432VM/HSC 6.0 System Programmer’s Guide Syntax Continuation FragmentsFragment 1st ed., 6/30/04 -Library Identification LSM Model 4410 and PowderHorn LSM Model How to Specify a CAPidCAPid Formats 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 acs-id, lsm-id MEDia, RECtech, and MODel ParametersMODel, and RECtech parameters acs-id, lsm-idMount VOLATTR acs-id, lsm-id1st ed., 6/30/04 - LIBGEN Macros444VM/HSC 6.0 System Programmer’s Guide SLIDLIST macro SLIACS macroSLIALIST macro SLIDRIVS macros1st ed., 6/30/04 - SLILIBRY macro446VM/HSC 6.0 System Programmer’s Guide SLISTATN macro SLILSM macroSLIRCVRY macro SLIRCVRYJournal Definition JRNDEF control statement HSC Control StatementsEXECParm control statement 448VM/HSC 6.0 System Programmer’s GuideLMUPATH control statement LKEYDEF command and control statementLKEYINFO control statement VOLumevolser450VM/HSC 6.0 System Programmer’s Guide OPTion control statementScratch Subpool SCRPOol control statement 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 -AUDIt utility UtilitiesACTIvities Report utility ACSacs-idDirectory Rebuild DIRBLD utility BACKup utilityDatabase Decompile LIBGEN utility EJECt utilityEJECt utility continued Enter Cartridges utilityMOVe utility Reconfiguration utilityJournal OFFLoad utility REPLace utilityRESTore utility SCRAtch utilityScratch Redistribution SCREdist utility 462VM/HSC 6.0 System Programmer’s GuideSET utility OptionsSET utility continued UNSCratch utilityUnselect utility 464VM/HSC 6.0 System Programmer’s GuideVolume Report VOLRpt utility CLean command Operator CommandsCDs Enable/Disable command 466VM/HSC 6.0 System Programmer’s GuideDISMount command Display ALl Display commandDisplay Acs Display ALLOCDisplay DRives Display CmdDisplay COMMPath CMd COmmandDisplay Drives continued 470VM/HSC 6.0 System Programmer’s GuideDisplay LMUPDEF Display ExceptionsDisplay LKEYDEF Display LSMDisplay Requests Display MONitorDisplay OPTion 472VM/HSC 6.0 System Programmer’s GuideDisplay SCRatch Display Status Display SCRPDEFDisplay SRVlev 474VM/HSC 6.0 System Programmer’s GuideDisplay THReshld Display TREQDEFDisplay Volume DRAin CAP commandEJect command Display UNITDEFEject Command continued MODify command ENter commandJournal command MONITOR commanddevaddr Mount commandvolser host-id480VM/HSC 6.0 System Programmer’s Guide MOVe MOVe commandVolume Flsmlsm-idRELease CAP command OPTion command and control statementRECover Host command 482VM/HSC 6.0 System Programmer’s GuideStop Monitoring STOPMN command SENter commandSRVlev Service Level command SWitch commandVary Station command TRace commandTRACELKP command 484VM/HSC 6.0 System Programmer’s GuideVIew command Warn command 486VM/HSC 6.0 System Programmer’s GuideTRace command HSC Diagnostic CommandsLIst command 1st ed., 6/30/04 -CANCEL command SCP Operator CommandsAUTHorize Command CP CommandModify Command SCP FILE CommandHELP Command Query Command490VM/HSC 6.0 System Programmer’s Guide Reply CommandSET Command destination eventsSTOP Command SLK CommandSTArt Command STOPSCP Command1st ed., 6/30/04 - GCS Component Server CommandsSLKGCS Command CMS HELP CMS Operator CommandsACS EXEC 494VM/HSC 6.0 System Programmer’s GuideCP Programming Services Appendix B. CP Commands and DIAGNOSE CodesCP Commands Overview1st ed., 6/30/04 - IUCV496VM/HSC 6.0 System Programmer’s Guide Appendix C. Record Formats OverviewMapping Macros for Batch API Records Mapping Macros for SMF RecordsMapping Macros for LOGREC Records TypeSMF Records SMF Mapping MacrosCross Reference SMF Record FormatsSLSDVAR TypeType SLSSFHDRTable 33. SLSSFHDR Record Format LengthLength Table 33. SLSSFHDR Record Format ContinuedType LabelLength Table 33. SLSSFHDR Record Format ContinuedType LabelCross Reference 504VM/HSC 6.0 System Programmer’s GuideValue NameOffset Appendix C. Record FormatsSLSSBLOS Cross Reference SIGNED-FWORDSLSSCAPJ Cross ReferenceSLSSCAPN Cross ReferenceSLSSVSTA Appendix C. Record Formats Cross ReferenceSLSSVSTA SLSSMLSM Cross ReferenceSLSSLSB Type Cross ReferenceTable 39. SLSSLSB Record Format Continued 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 Length Table 43. SLSSLHDR Record Format ContinuedType 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 Table 64. Mapping macros for Batch API Records Batch API RecordsBatch API Mapping Macros Appendix C. Record FormatsBatch API Record Formats SLUVDDATCross Reference F0F1596VM/HSC 6.0 System Programmer’s Guide ‘CVAL’ UVD994B5Appendix C. Record Formats 1st ed., 6/30/04 -SLUVPDAT SIGNED-HWORD Cross Reference 600VM/HSC 6.0 System Programmer’s GuideValue NameOffset UVPTWSTD602VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 -Information Being Logged Temporary Motion Error CountsAppendix D. Logging ACS Robotics Motion 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 - Drive not rewound LMU LAN Interface Error Codes: 0501 -0426 0427LMU Logical Error Codes: 0601 - LSM Robotics Error Codes: 0701 - LSM Hardware Error Codes: 0801 - LSM Logical Error Codes: 0901 -0921 1012 Drive Error Codes: 1001 -Undefined Response Code Load Failure on Special UseAppendix E. Remote-linkedLibraries Appendix E. Remote-linkedLibrariesOverview 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 Invoking QCDS SLSUREQ Macro QCDS RequestHow QCDS Functions OverviewSLSUREQ VM Requirements Addresses and RegistersVM Requirement Syntax Parameterslabel REQUESTThis parameter is required BUFFER Notes QCDS Programming ConsiderationsE,parmaddr UCALADRDecimal Value and Description Return CodesReturn Field Name 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 Parameters SLSUREQM MacroSyntax 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 Indexcap-id 466, 476, 478, 482, 483 cap-list 466, ACS 108,CAP 468, 478, 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