Manuals / StorageTek / Household Appliance / Water System

StorageTek 6 manual Volume Report Syntax

Models: 6

1 718

Download 718 pages 10.93 Kb

Page 357

Image 357

Volume Report

Syntax

Note: This utility can be run either under CMS or SCP. If the utility is running under SCP, architectural limitations restrict the parameters that can be specified to ACS, LSM, VOLser, and VOLume. Parameters relating to sorting and data filtering are not available.

If the utility is running under CMS, however, it is fully functional.

VOLRpt								VOL	ASCend
	ACS(acs-id)							VOL	ASCend
	ACS(acs-id)			,			SORT(	INS	)
				,			SORT(	INS	)
			LSM(	lsm-list		)		LOC	DEScend
	VOLser	(	volser		)			SEL
	VOLser	(	volser		)			USE
			vol-range					USE
			vol-range				NOSORT
			,				NOSORT
			,
			vol-list
	VOLume	(	volser		)
			vol-range
			,
			vol-list
	,							,
	*							,
	*					EXCLude(		SCR	)
INCLude(	SCR				)	EXCLude(		SCR	)
INCLude(	SCR				)			NONSCR
	NONSCR							NONSCR
	NONSCR							ERR
	ERR							NONERR
		NONERR						NONERR
		NONERR						SEL
	SEL							NONSEL
		NONSEL						NONSEL
		NONSEL						READable
	READable							UNREADable
		UNREADable						UNREADable
		UNREADable						MEDEQUAL
	MEDEQUAL							NONMEDEQ
		NONMEDEQ						NONMEDEQ
		NONMEDEQ						NOEXTernal
	NOEXTernal
VOLIST
VOLDATA			CDSDATA		SUMMary(		TOTal		)
							SUBpool
							TOTal,SUBpool

Chapter 4. Utility Functions 327

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

Page 357

Image 357

StorageTek 6 manual Volume Report Syntax

Contents

Release System Programmer’s Guide312579601 Host Software Component VM ImplementationRestricted Rights Export Destination Control StatementLimitations on Warranties and Liability Proprietary Information StatementDoc Kit Number Document EffectivityHost Software Component for Document Effectivity1st ed., 6/30/04 - ivVM/HSC 6.0 System Programmer’s GuideWhat’s New With This Release? ContentsPreface 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 C. Record Formats Appendix B. CP Commands and DIAGNOSE CodesAppendix D. Logging ACS Robotics Motion Appendix E. Remote-linkedLibraries GlossaryIndex Figures Figure Tables Table 28. Performance Parameters Controlled by PARMLIB Control Statements Table 67. Format for Total Motions and Temporary Error Counts 1st ed., 6/30/04 - xxivVM/HSC 6.0 System Programmer’s GuideInstallation Guide What’s New With This Release?Installation Guide Installation GuideSystem Programmer’s Guide Installation GuideSystem Programmer’s Guide System Programmer’s GuideScope PrefaceIntended Audience Organization of This GuideHow to Use This Guide Related Publications References to HSC Product ReleasesReader’s Comments StorageTek Product Support1st 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 ComponentsCOMMON APPLICATIONSCONTROL SERVERSVM Operating System CP and CMS VM EnvironmentStorage Management System Control Program SCPDevice Management File ManagementJob Management Task ManagementProcessor Management CommunicationTask Recovery/Termination Virtual Machine ConfigurationHost Software Component HSC Tape Management System TMS10VM/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 Macros User Control of HSC FunctionsUtilities PARMLIB Control StatementsCommands 1st ed., 6/30/04 - 18VM/HSC 6.0 System Programmer’s GuideChapter 2. Host Software Component Functions Overview of HSC FunctionsAutomatic Functions of the HSC Installation Functions HSC Service Levels Description of Base Service LevelInitialization/Termination Functions Description of Full Service Level Service Level Execution CommandBase FullUtility Service Level ExecutionBase FullStarting the HSC Subsystem at Base Service Level Displaying/Setting Service LevelMedia Type and Recording Technique Processing 26VM/HSC 6.0 System Programmer’s Guide1st ed., 6/30/04 - MEDia and RECtech Parameters MEDIA TYPESRECORDING TECHNIQUES Model Parameter MODelResulting RECtech Matching VOLATTR and TAPEREQ Statements Nonspecific Volume Requests Specific Volume RequestsPrecedence of VOLATTR and TAPEREQ Statements Scratch SelectionHow 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 Example of Mount Command with Readonly Operand HSC Mount Command SupportVirtual Thumbwheel VTW Tape Management InterfaceTape Transport Cleaning Automated Tape Transport CleaningActivating Automated Cleaning Identifying Cleaning Cartridges NotesNotes Over-use Over-limitand Spent Cleaning Cartridges Managing Over-useCleaning Cartridges Manual Tape Transport Cleaning Managing Cleaning 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 Mode Considerations Ejecting Cartridges from the LibraryCAP Exception Processing 48VM/HSC 6.0 System Programmer’s Guide Releasing an Allocated CAPNear Continuous Operations Using Multiple CDS CopiesAutomatic Recognition of Configuration Changes Automatic Update of LSM from 4410 toRun-timeRecognition of 9740 CAP Configuration Defining Planned ACSs with no Stations Changing Panels •To remove cartridges from rows on panels to facilitate hardware e.g., cabling changes CDs Command Using CDS Rename/Relocate/ExpandRenaming/Relocating a CDS - Scenarios Renaming a CDS CopyExpanding a CDS - Scenario Relocating an Uncataloged CDS CopyCDS ENABLE DSNACS.DBASENEW NEWLOC CDS EXPAND56VM/HSC 6.0 System Programmer’s Guide Swapping Library Transports - New Model Types Control Data Set Recovery Common Recovery FunctionsControl Data Set Recovery Techniques User Control of Control Data SetsAllocation of Control Data Sets Dynamic Enable/Disable of Control Data Sets 4. Issue the command Command Functions Figure 5. HSC Command Functions Overview62VM/HSC 6.0 System Programmer’s Guide Controlling LSM Operating Mode Controlling CAP Operating ModeViewing the Interior Components of an LSM •A VIew request is sent to the controlling LMU Utility Functions Figure 6. Utility Functions OverviewChapter 2. Host Software Component Functions Dual LMU Functionality LMU Server FunctionsIf the Master LMU Fails If the Standby LMU FailsLMU Switchover Messages After an LMU Switch OccursHSC/LMU Software Combinations Adding New Stations to an ACS JCL to Add New Stations to an ACSNotes for the Example Reconstructing a LIBGEN Recovery Maintenance Requirements Dynamic LMU ConnectionHSC Port Number Assignments Multiple TCP/IP Stack Implications Transitioning Between 3270 and TCP/IP 3270 to TCP/IPTCP/IP to Recovering TCP/IP Communications Operator Intervention - Dual LMU Configuration Operator Intervention - Single LMU ConfigurationCommunication Lost to Master LMU Communication Lost to Standby LMUSystem Definition File ACS SYSDEF Configuring VM for TCP/IP SupportSystem Profile File ACS SYSPROF HSC Startup Job File ACS SLKJCLCommands to Format OS Minidisk Initializing the LMUPATH Definition Data SetCommands to Format CMS Reserved Minidisk Minidisk Statement for the LMUPATH Data SetJOB SLSXUTIL SLUGENER /PARM RECCOPY LMUPATH Definition Data SetFILE SYSPRINT DEV PRNT CLASS A FILE SYSUT2 DEV <vaddr> DSN <dsname> /FILE SYSUT1Types of Communications Services Host-to-HostCommunications ServicesCommunication Functions Information Passed Between HostsChapter 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 APIOverview PARMLIB Control StatementsDefining PARMLIB Control Statements Options Offered by PARMLIB Control Statements Processing PARMLIB Control StatementsCAP Preference Definition Control Data Set DefinitionEXECPARM Control Definition Communications Path DefinitionJournal Data Set Definition License Key InformationReconfiguration CDS Definition Control Statement Continuation ConventionsOption Control Scratch Subpool ControlSyntax CDSDEF CDS Definition CDSDEF Control StatementControl Statement Name CDSDEFParameters DISABLEDSN3SLS.DSTBY,VOL3HSC103,UNIT3503,+ DISABLE ExampleCDSDEF CDSDEF DSN1SLS.DBASE,VOL1HSC101,UNIT1501,+Syntax EXECParm EXECParm Control StatementControl Statement Name EXECParmEXECParm EXECParm Control Statement - Command Prefix OffHOSTID ExampleJournal Definition JRNDEF Control Statement JRNDEFSyntax Control Statement NameUNITx JRNDEFFULL AbendCommand Name LKEYDEF LKEYDEF Command and Control StatementParameter Descriptions dataset-nameunitname LKEYDEFhost-id UNITproduct-identifier LKEYINFOcustomer-name nnnnnnnlicense-key-string ExamplesLKEYINFO Syntax RECDEFControl Statement Name RECDEFExample RECDEFRECDEF DSN1SLS.DBASE,VOL1HSC101,UNIT1501,+ DSN2SLS.DBSEC,VOL2HSC102,UNIT2502Syntax SCRPOol Scratch Subpool Control StatementControl Statement Name SCRPOolRANGE SCRPOolNotes LABELOther Methods of Controlling Scratch Subpools SCRPOolExample Definition Data Set Control Statements LMU Path OPTion TITLELMU Parameter Definition Scratch Subpool Parameter Statement DefinitionDefining Tape Request Attributes TAPEREQ Defining LMU Network ConnectionsVolume Attribute Volume Attribute DefinitionDefining Unit Attributes UNITATTR Defining Volume Attributes VOLATTRControl Statement Continuation Conventions Identifying the Definition Data Sets OPTION TITLELMUPATH Usage LMUPATH LMUPATH Control StatementSyntax Control Statement Namelmu_hostname LMUPATHnnn.nnn.nnn.nnn LMUADDR110VM/HSC 6.0 System Programmer’s Guide LMUPDEF LMUPDEF Command and Control Statementdataset.name LMUPDEFSyntax Control Statement NameLoad the LMUPATH Parameters From YOUR.DSNMEMBER LMUPDEFunitname host-ididentifying-string OPTion TITLE OPTion TITLE Control StatementSyntax Control Statement NameExample OPTion TITLE114VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 -SCRPDEF Syntax SCRPDEFControl Statement Name ParametersSCRPDEF Load the SCRPOol Parameters From YOUR.DSNMEMBERunitname host-idTAPEREQ Usage TAPEREQ Tape Request TAPEREQ Control StatementDisabling a TAPEREQ Definition TAPEREQ120VM/HSC 6.0 System Programmer’s Guide TAPEREQTAPEREQ SyntaxTAPEREQ Syntax continued TAPEREQ122VM/HSC 6.0 System Programmer’s Guide step-name job-nameTAPEREQ Control Statement NameDD-name program-nameTAPEREQ PROGram or PGMnameexpiration-date retention-periodTAPEREQ EXPDTLONGItud TAPEREQStandard ECARTZCART TAPEREQDD3A, DD3B, DD3C STK1RECtech TAPEREQNotes LONGItud36Atrack TAPEREQSTK1RC TAPEREQsubpool-name TAPEREQ4490 TAPEREQ Set Tape Request AttributesExample 132VM/HSC 6.0 System Programmer’s GuideTREQDEF Syntax TREQDEFControl Statement Name ParametersTREQDEF Load the TAPEREQ Parameters From YOUR.DSNMEMBERunitname host-idUNITATTR Unit Attribute UNITATTR Control StatementUNITATTR Usage unit-address UNITATTRSyntax Control Statement NameMODel UNITATTRUNITATTR Specify Unit Attribute StatementsT9940B35 IGNORE140VM/HSC 6.0 System Programmer’s Guide UNITDEFSyntax UNITDEFControl Statement Name Parametershost-id UNITDEFExamples Specify a Data Set Containing UNITATTR StatementsVolume Attribute VOLATTR Control Statement VOLATTRVOLATTR Usage Disabling a VOLATTR Definition VOLATTR144VM/HSC 6.0 System Programmer’s Guide VOLATTR This syntax diagram is continued on the next pageSyntax VOLATTR SERial volserSyntax continued VOLATTRControl Statement Name VOLATTRVOLATTR volser or vol-rangeor vol-listParameters SERialValid media types are VOLATTRZCART VOLATTRDD3A, DD3B, DD3C, DD3D STK1STK2P, STK2W VOLATTRRECtech LONGItudindicates a 9490 Timberline transport VOLATTRuse-limit VOLATTRSTK1RC34 VOLATTR Set Volume AttributesExample VOLATTR SERIALL*,AA9* MEDIAECART154VM/HSC 6.0 System Programmer’s Guide VOLDEFSyntax VOLDEFControl Statement Name ParametersVOLDEF Load the VOLATTR Parameters From YOUR.DSNMEMBERunitname host-idPARM Statement Creating an SLKJCL File for Starting the HSCPARM Statement Parameters SyntaxRESET SSYSCOLD Member RECONFIGDialog BothHSC Startup Job ACS SLKJCL Example Sample ACS SLKJCL FileDescription of /FILE Statement NotesSLSSYSXX Starting HSC Execution Configuration MismatchesModifying LSMs Online Specifying CAP Preferences164VM/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 FunctionsSelecting a Utility FunctionUtility to Use Restore or recreate the library CDS Typical Use of Utilities Control Statement Syntax Conventions Utility Syntax ConventionsUtility Environmental Requirements ACS UTIL Exec ACSCMS EXEC CMS EnvironmentACSUTIL SLKJCL file SCP EnvironmentSCP Batch Job Control Language JCL JCL and Control StatementsJOB Statement jobnameparms PARM StatementCOMM Statement commentsfname Submitting Jobsftype fmodeControl Statements vs. JCL Utility Control StatementsHow to Invoke SLUADMIN Utility Administrator SLUADMINSLUADMIN Program Return Codes How to Invoke Utility ProgramsReturn Code DescriptionReports Created by Utilities Report HeadingsParameters Controlling Report Headings Example Example of JCL Using Report Heading OptionsDATE=2YR DATE=4YRStand-AloneUtilities Activities Report Activities Report UtilitySLUACTV EXEC typeActivities Report SLSSMF fname ftype fmodePARM MIXEDUtility Name SyntaxParameters begin-dateend-time end-dateActivities Report TODAYControl File Example Invoking the Activities Report UtilityOutput Description Control File to Produce an Activities ReportTotal Activities Report% of all Activities ReportAve. time Ave. pass-thrusActivities Report Usage NotesEarliest Latest•LSM operating statistics record, subtype 1, and Activities ReportACS ID Activities ReportARM USE P-THRUActivities Report Usage Notes196VM/HSC 6.0 System Programmer’s Guide Figure 9. Activities Report Utility Sample Output Activities ReportChapter 4. Utility Functions 1st ed., 6/30/04 -Audit Audit UtilityAudit Media Type Mismatch ConditionsActions Permitted During an Audit How the AUDIt Utility FunctionsAudit Audit Concurrent AuditsAudit acs-idSyntax Utility Namepanel-list lsm-listAudit PANelcolumn-list row-listAudit NotesAudit cap-idEMPTYCel AuditDIAGScan NotesInvoking the Audit Utility JCL RequirementsACSUTIL SLKJCL File AuditJCL for Audit of Entire Library all ACSs JCL ExamplesJCL for Selective Audit 1 ACS, 2 LSMs, with CAPid AuditJCL for Selective Audit of Empty Cells JCL for Selective Audit of Diagnostic Cells OnlyAudit Output DescriptionFigure 10. AUDIt Utility Sample Output Audit210VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 -Backup Backup UtilityReasons for Running the BACKup Utility PrerequisitesBackup How the BACKup Utility Functions Backup Backup Procedure BACKup BackupSyntax Utility NamePrimary BackupSecondary STandbyRestart BackupSLSPRINT Backup JCL RequirementsSLSCNTL SLSCNTL2ACSUTIL SLKJCL File Backup Invoking the BACKup UtilityJCL for Running Backup Backup JCL ExamplesRun Backup Utility JCL for Running a Copy BackupBackup Output Description•the following data sets •a condition code from backup processing Backup4warning MESSAGES – Backup successful Chapter 4. Utility FunctionsFigure 11. BACKup Utility Sample Output 1 of Backup222VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 -Figure 11. BACKup Utility Sample Output 2 of BackupChapter 4. Utility Functions 1st ed., 6/30/04 -Backup How to Restart Backup Related Utilities224VM/HSC 6.0 System Programmer’s Guide Database Decompile Database Decompile LIBGEN UtilityHow the Database Decompile Utility Functions PrerequisitesUtility Name Database Decompile SyntaxParameters JCL RequirementsJCL Example Invoking the Database Decompile UtilityJCL for Database Decompile Database DecompileDevice Database Decompile Output DescriptionLabel DescriptionDatabase Decompile Chapter 4. Utility Functions1st ed., 6/30/04 - Database Decompile 230VM/HSC 6.0 System Programmer’s Guide1st ed., 6/30/04 - Database Decompile Chapter 4. Utility Functions1st ed., 6/30/04 - Database Decompile 232VM/HSC 6.0 System Programmer’s Guide1st ed., 6/30/04 - Database Decompile Chapter 4. Utility Functions1st ed., 6/30/04 - Database Decompile 234VM/HSC 6.0 System Programmer’s Guide1st ed., 6/30/04 - Database Decompile Chapter 4. Utility Functions1st ed., 6/30/04 - Directory Rebuild Directory Rebuild UtilityReasons for Running the Directory Rebuild Utility How the Directory Rebuild Utility FunctionsInvoking the Database Decompile Utility Directory RebuildSLSCNTL, SLSCNTL2, SLSSTBY SLSINDirectory Rebuild JCL Example JCL for Directory RebuildOutput Description Eject Cartridge Utility Eject CartridgeSyntax Utility Name Eject CartridgeEJECt Eject Method 2 continuedvol-list Eject Cartridge Parameterscount VOLser•CST •MEDIA1 •STD •1 •3480 Eject CartridgeNote: STK2P can be abbreviated to P Eject Cartridgeindicates a 3490E-image9840 transport Eject CartridgeEject Cartridge cap-listEject Cartridge Invoking the Eject Cartridge UtilityJCL Requirements ACSUTIL SLKJCL FileJCL to Eject One STD Scratch Cartridge JCL for Ejecting a Single VolumeJCL to Eject Five SD-3Scratch Cartridges Eject CartridgeEject Cartridge Output Description Figure 13. EJECt Cartridge Utility Sample Output248VM/HSC 6.0 System Programmer’s Guide Enter Cartridges Enter Cartridges UtilityCAP Operating Instructions SyntaxEnter Cartridges Invoking the Enter Cartridges UtilityJCL Requirements SCRatchEnter Cartridges JCL for Entering Cartridges in a CAPJCL Example Output DescriptionFigure 14. Enter Cartridge Utility Sample Output Enter Cartridges252VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 -Journal Offload Journal Offload UtilitySyntax Utility NameJournal Offload Invoking the Journal Offload UtilitySLSOFF02 SLSINJournal Offload JCL Example JCL for Offload of JournalsOutput Description Figure 15. Journal Offload Utility Sample Output Journal Offload256VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 -Move Utility MoveMOVe Considerations Move lsm-idSyntax Utility NameMove panelrow-list column-listMove JCL Requirements Invoking the Move UtilityACSUTIL SLKJCL File Move Several Volumes From an LSM to Another LSM Move JCL ExamplesOutput Description Figure 16. MOVe Utility Sample Output Move262VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 -Performance Log Reblocker Performance Log Reblocker UtilitySyntax CMS Statement Performance Log Reblocker utilityPerformance Log Reblocker Performance Log Reblocker mvsnodeJCL Requirements classReconfiguration Utility ReconfigurationReasons for Running the Reconfiguration Utility Considerations Before Running Reconfiguration DASD Considerations in a VM-onlyEnvironmentReconfiguration How the Reconfiguration Utility Functions Reconfiguration268VM/HSC 6.0 System Programmer’s Guide Reconfiguration I/O ConsiderationsCondition Number of I/OsMinimizing I/O Time Running a Successful ReconfigurationReconfiguration Notes7.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 ReconfigurationRestore Restore UtilityReasons for Running the RESTore Utility How the RESTore Utility FunctionsRESTore RestoreUtility Name ParametersJCL Requirements RestoreOnly ShortRestore Invoking the Restore Utility JCL ExamplesACSUTIL SLKJCL File JCL for RESTore with GENerate Only JCL for RESTore with Journals AppliedRestore 280VM/HSC 6.0 System Programmer’s GuideJCL for RESTore Journals and Output to SLSAUDIT RestoreOutput Description Figure 17. Restore Utility Sample Output Restore282VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 -Restore How to Handle BACKup/RESTore DiscrepanciesScratch Redistribution Utility Scratch RedistributionHow the Scratch Redistribution Utility Functions Utility Name Scratch Redistribution SyntaxSCREdist Chapter 4. Utility Functionstolerance-value Scratch Redistribution Parametersacs-id lsm-listexpnumlsm 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 RedistributionInvoking the Scratch Redistribution Utility Scratch Redistribution JCL RequirementsJCL Examples ACSUTIL SLKJCL FileScratch Redistribution JCL to Perform Scratch RedistributionJCL to Perform Scratch Redistribution JCL to Perform Scratch Redistribution294VM/HSC 6.0 System Programmer’s Guide Scratch Redistribution Output DescriptionScratch Update Scratch Update UtilitiesUtility Names SCRAtch utilityInvoking the Scratch Update Utilities Scratch Update ParametersJCL Requirements vol-listScratch Update JCL to Scratch, Unscratch, and ReplaceJCL Example Output DescriptionFigure 19. Scratch Update Utilities Sample Output Scratch Update298VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 -SET Utility SET Option How the SET Utility FunctionsAffected HSCs All Other HSCsSummary of SET Utility Options Considerations Before Running the SET UtilitySET Utility Function and Location of Description SET OptionSet Syntax Note: This syntax is continued on the next pageChapter 4. Utility Functions esoteric SET ACS EsotericUtility Name ParametersSET CLNPRFX PROCEDURE SET Cleaning PrefixSET HSC Command Prefix prefixDescription CharacterSET Delete Disposition SET Eject PasswordSCRTCH NOSCRTCHoldpswd SET Freeze PanelFREEZE newhost SET Host IDoldhost SET HSC Levelqname SET ENQ/DEQ/RESERVE QNAMESET New Host model-hostSET Device Numbers for Drives SET Scratch Label Typeesoteric FORHOSTaddr0,...addr19 FORLSMID Running SET SLIDRIVS With the HSC Activelsm-id FORPANELSET LMU Station Address Numbers SET SLIDRIVS Procedurestat1,...,stat16 SLISTATNSET SMF Record Type SET Recovery Techniquelibtype FORACSJCL Requirements SET TCHNIQE PROCEDURESHADOW BOTHACSUTIL SLKJCL File Invoking the Set UtilityJCL for Set Utility Set JCL ExamplesOutput Description JCL for Multiple SET StatementsUnselect Utility UnselectSyntax Invoking the Unselect Utility Unselect Utility NameParameters JCL RequirementsUnselect JCL to Unselect a VolumeJCL Example Output DescriptionFigure 20. Unselect Utility Sample Output UnselectChapter 4. Utility Functions 1st ed., 6/30/04 -Volume Report Volume Report UtilityVolume Report Media Type and Recording Technique Considerations•change the VOLATTR statements Volume ReportVolume Report Syntax volser or vol-range or vol-list Volume Report Utility NameParameters acs-idSORT Volume ReportINCLude Volume ReportMEDEQUAL Volume ReportNONMEDEQ NOEXTernalVOLIST Volume ReportVOLDATA CDSDATAVolume Report JCL/Parameter File RequirementsSLSCNTL, SLSCNTL2, SLSSTBY SLSPRINTSLSCNTL JCL/Parameter File Syntaxvaddr control.set.namekeywords fn, ft, fmSLSCDATA CMS only SLSSCRPL CMS onlyPARM SLSVA CMS onlyparameters JOB SCP onlySLUVOLR EXEC CMS Volume Report Invoking the Volume Report UtilityParameter File ACSUTIL SLKJCL FileJCL to Produce a Volume Report Volume ReportJCL Example Report Detail Lines JCL to Produce a Volume Report for an MVS PDSMedia and Recording Technique Origin Volume ReportErrant, Scratch, Selected Fields Media Type Prefix CharactersExternal Label Field Cartridge Usability CLN USE FieldSubpool ID Field Volume Report TotalsTimes Selected Field Totals ReportsVolume Report Volume Report Flat FilesVolume Report Chapter 4. Utility Functions1st ed., 6/30/04 - Volume Report 344VM/HSC 6.0 System Programmer’s Guide1st ed., 6/30/04 - Volume Report Chapter 4. Utility Functions1st ed., 6/30/04 - 1st ed., 6/30/04 - 346VM/HSC 6.0 System Programmer’s GuideAbend Codes MessagesHSC Messages SCP MessagesSoftware Trace Facilities CP Trace TableCCWTRACE SCP SET TRACE Command VM CP Debug CommandsTRACE Command Syntax SCP Internal Trace TableTrace Table Entries Master Trace Table HeaderDSP Trace Entry Query CodeTTEWORD1 IPARML IUCV Parameter List= IRT address TTEWORD2 = IPARML bytesInputs IPARML for IUCV CONNECT to *BLOCKIOInputs IPARML for IUCV SEND to *BLOCKIO=target class 1=write; 2=read =flags type=2way =relative block number =data buffer addressInputs IPARML for IUCV RECEIVE= target class = flagsInputs IPARML for IUCV REPLY= IUCV message id = target classInputs IPARML for IUCV SEVER= name of virtual machine connected to OutputsIPRCODE IUCV Interrupt Buffer IPTYPEInterrupt Type IPARML for Pending Connection Interrupt IPARML for Connection Complete Interrupt = IUCV path id IPPATHIDIPTYPE = 03=severed, 04=quiesced, 05=resumedIPARML for Incoming Message Interrupt IPARML for Message Complete Interrupt Error Recording Data Set Records Diagnostic CapabilitiesSCP Trace Facility Supervisor Call and Abnormal End DumpsSCP External Trace Facility EXEC SCP Trace Formatter UtilitySLUETRAC 368VM/HSC 6.0 System Programmer’s Guideinft infninfm outfnSupervisor Call SVC Functions 370VM/HSC 6.0 System Programmer’s Guide1st ed., 6/30/04 - Refer to Table DecimalFunction SCP GTRACE Emulation The valid EID ranges are HSC Internal Trace Table Figure 23. HSC Internal Trace Table Example Format of HSC GTRACE USR Records HSC TRACE CommandVM CP Commands Diagnostic CommandsSCP Debug Mode Setting Initialization Sequence Break-Pointslength offsetSCP Diagnostic Subsystem Commands Enabling the Diagnostic Subsystem=DEBUG =NODEBUG =DDICTfieldname epname =HPERoffset length=WHERE addressepname LIst Command HSC Diagnostic CommandsSyntax Parameters data-structureDISPLAY Command sizeaddress CDS Recovery Capabilities Dynamic Recovery of the Control Data SetControl Data Set Recovery 1st ed., 6/30/04 - 386VM/HSC 6.0 System Programmer’s 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 ActionsHow to Request a Dump Dump ProcessingType of Dumps Supported Note Reason For Dump What to do When a Dump OccursMove Problem Materials to Tape Load Dump and CONSLOG Onto DiskCall StorageTek Software Support Dump Analysis Using SLUIPCS VIEW SLUIPCS SCAN SubcommandsVIEW CVT VIEW CCVT VIEW NUCON VIEW MTT VIEW STORMAN VIEW LVT VIEW structnameData Structures Data StructuresIHAASCB FIND EX EXECUTE CMS COMMANDTRB SAVE AREA TRACEBACK TTE TRACE TABLE ENTRYWN WHERE NAME WA WHERE ADDRESSSTAT STATUS TASK FIND TASKSLUIPCS PRINT Options Major SCP Data RelationshipsFigure 25. Command, Message and Trace Processing Command, Message, Trace Processing1st ed., 6/30/04 - NUCON X’10’ VECTPTR TRCTABDiagnostic Techniques SCP Task/Job Data RelationshipsSubsystem Data Relationships NUCON JBLOK PSAAOLD JBLTASK TBLOK PSATOLD Figure 26. SCP Task/Job Data RelationshipTKRBLIST RQBLOK404VM/HSC 6.0 System Programmer’s Guide Figure 27. Subsystem Data RelationshipsNUCON CVT VECTPTR CVTJESCT JESCT JESSSCT SSCT SSCTSCTA SSCTSSVT SSCTFind a Module Plus Offset, Given an Address Common Dump Analysis TasksFind a Module Address, Given a Name View an HSC or SCP Data AreaIdentify the Failing Routine Find the Failing TaskFind the Failing Request Block Find the LVT Save Area Trace BackFind the LCT, LST, HST Identify the Last Interrupt EventDiagnostic Materials Gather Diagnostic MaterialsExamine an SDWA Find IUCV Path Descriptorsdetails of problem circumstances •STKACS abend Tape Return Tape FormatChapter 6. Performance Considerations How Library Activity Affects Library PerformanceOverview Using the Activities Report Utility Monitoring Library Activity and PerformanceHow Operators Control Library Performance ACS Daily Report Tape Volume ReportMaintain Quantities of Scratch Cartridges Redistribute Scratch Volumes in the LibraryDefine CAP Preferences 414VM/HSC 6.0 System Programmer’s GuideUse PARMLIB to Define Static Parameters Use SMF Records to Collect Performance DataOperator Command Performance ParameterJournal Definition Set High-Performance Host-to-HostCommunications Define High Dispatching Priority for the HSCFunctioning of Host-to-HostCommunications Designation of Communication parameters418VM/HSC 6.0 System Programmer’s Guide Limit View Time to Maintain High Performance Define Secondary and Standby Control Data SetsExcessive Use of VIew Command Affects Performance How to Monitor Usage of the VIew CommandAdvantages of Using the VIew Command 1st ed., 6/30/04 - Chapter 6. Performance ConsiderationsReduce Pass-Thrus Loading Cartridges Into the LibraryUnnecessary Pass-Thrus Unavoidable Pass-ThrusScheduled Pass-Thrus Ways to Reduce Pass-ThruActivityEnsure adequate free cells Reduce Operator InterventionEject through the CAP closest to the cartridge Redistribute cartridges during off-peaktimesReduce Tape Transport Contention ACSPROP EXECPrefetch Enters Avoid Crashing Test SystemsUsage Requirements Reduce Scheduling ContentionSyntax ParametersUse the Audit Utility Effectively Use Performance Log Reblocker to Format DataUse LSMs as Scratch Loaders in a Mixed ACS Syntax Flow Diagrams Commands Syntax ReferenceSpecifying Commands VariablesSingle Required Choice Flow LinesRepeat Symbol DefaultsSingle Optional Choice Default Value Value2 Value3Fragment Syntax Continuation Fragments432VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 -Library Identification CAPid Formats How to Specify a CAPidLSM Model 4410 and PowderHorn LSM Model WolfCreek LSM Models 9360-050, 9360-075,and00indicates 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 followsSCRPOOL NAME=STD36,RANGEAAA000AAA999 ZZZ000ZZZ999440VM/HSC 6.0 System Programmer’s Guide MODel, and RECtech parameters MEDia, RECtech, and MODel Parametersacs-id, lsm-id acs-id, lsm-idMount acs-id, lsm-id VOLATTRLIBGEN Macros 444VM/HSC 6.0 System Programmer’s Guide1st ed., 6/30/04 - SLIALIST macro SLIACS macroSLIDLIST macro SLIDRIVS macrosSLILIBRY macro 446VM/HSC 6.0 System Programmer’s Guide1st ed., 6/30/04 - SLIRCVRY macro SLILSM macroSLISTATN macro SLIRCVRYEXECParm control statement HSC Control StatementsJournal Definition JRNDEF control statement 448VM/HSC 6.0 System Programmer’s GuideLKEYINFO control statement LKEYDEF command and control statementLMUPATH control statement VOLumevolserScratch Subpool SCRPOol control statement OPTion control statement450VM/HSC 6.0 System Programmer’s Guide 1st ed., 6/30/04 -Tape Request TAPEREQ control statement 452VM/HSC 6.0 System Programmer’s Guide Tape Request TAPEREQ control statement continuedUnit Attribute UNITATTR control statement Volume Attribute VOLATTR control statement 454VM/HSC 6.0 System Programmer’s Guide1st ed., 6/30/04 - STK1RA STK1RA34 STK1RA35 STK1RB STK1RB34 STK1RB35 1st ed., 6/30/04 - 456VM/HSC 6.0 System Programmer’s GuideACTIvities Report utility UtilitiesAUDIt utility ACSacs-idDatabase Decompile LIBGEN utility BACKup utilityDirectory Rebuild DIRBLD utility EJECt utilityEnter Cartridges utility EJECt utility continuedJournal OFFLoad utility Reconfiguration utilityMOVe utility REPLace utilitySCRAtch utility RESTore utility462VM/HSC 6.0 System Programmer’s Guide Scratch Redistribution SCREdist utilityOptions SET utilityUnselect utility UNSCratch utilitySET utility continued 464VM/HSC 6.0 System Programmer’s GuideVolume Report VOLRpt utility CDs Enable/Disable command Operator CommandsCLean command 466VM/HSC 6.0 System Programmer’s GuideDISMount command Display Acs Display commandDisplay ALl Display ALLOCDisplay COMMPath Display CmdDisplay DRives CMd COmmand470VM/HSC 6.0 System Programmer’s Guide Display Drives continuedDisplay LKEYDEF Display ExceptionsDisplay LMUPDEF Display LSMDisplay OPTion Display MONitorDisplay Requests 472VM/HSC 6.0 System Programmer’s GuideDisplay SCRatch Display SRVlev Display SCRPDEFDisplay Status 474VM/HSC 6.0 System Programmer’s GuideDisplay TREQDEF Display THReshldEJect command DRAin CAP commandDisplay Volume Display UNITDEFEject Command continued Journal command ENter commandMODify command MONITOR commandvolser Mount commanddevaddr host-id480VM/HSC 6.0 System Programmer’s Guide Volume MOVe commandMOVe Flsmlsm-idRECover Host command OPTion command and control statementRELease CAP command 482VM/HSC 6.0 System Programmer’s GuideSRVlev Service Level command SENter commandStop Monitoring STOPMN command SWitch commandTRACELKP command TRace commandVary Station command 484VM/HSC 6.0 System Programmer’s GuideVIew command 486VM/HSC 6.0 System Programmer’s Guide Warn commandLIst command HSC Diagnostic CommandsTRace command 1st ed., 6/30/04 -AUTHorize Command SCP Operator CommandsCANCEL command CP CommandHELP Command FILE CommandModify Command SCP Query CommandReply Command SET Command490VM/HSC 6.0 System Programmer’s Guide events destinationSTArt Command SLK CommandSTOP Command STOPSCP CommandGCS Component Server Commands SLKGCS Command1st ed., 6/30/04 - ACS EXEC CMS Operator CommandsCMS HELP 494VM/HSC 6.0 System Programmer’s GuideCP Commands Appendix B. CP Commands and DIAGNOSE CodesCP Programming Services OverviewIUCV 496VM/HSC 6.0 System Programmer’s Guide1st ed., 6/30/04 - Overview Appendix C. Record FormatsMapping Macros for LOGREC Records Mapping Macros for SMF RecordsMapping Macros for Batch API Records TypeSMF Mapping Macros SMF RecordsSLSDVAR SMF Record FormatsCross Reference TypeTable 33. SLSSFHDR Record Format SLSSFHDRType LengthType Table 33. SLSSFHDR Record Format ContinuedLength LabelType Table 33. SLSSFHDR Record Format ContinuedLength Label504VM/HSC 6.0 System Programmer’s Guide Cross ReferenceOffset NameValue Appendix C. Record FormatsSLSSBLOS SIGNED-FWORD Cross ReferenceCross Reference SLSSCAPJCross Reference SLSSCAPNSLSSVSTA Cross Reference SLSSVSTAAppendix C. Record Formats Cross Reference SLSSMLSMSLSSLSB Table 39. SLSSLSB Record Format Continued Cross ReferenceType LengthSLSSMF07 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 Type Table 43. SLSSLHDR Record Format ContinuedLength LabelCross Reference LTYPAREAAppendix C. Record Formats 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’ Cross Reference LLG5ACSAppendix C. Record Formats SLSSLLG6 1... X’08’ SIGNED-FWORD Cross Reference LLG6ACSAppendix C. Record Formats 552VM/HSC 6.0 System Programmer’s Guide SLSSDJLR CHARACTER Cross ReferenceSLSSPSWI 556VM/HSC 6.0 System Programmer’s Guide Cross ReferenceCross Reference SLSSRL00Cross Reference SLSSRL01SLSSHLG1 1. .... X’20’ Cross Reference HLG1FLG1Appendix C. Record Formats 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’ Cross Reference CFGCCPFXAppendix C. Record Formats SLUVHDAT 1.. .... X’40’ 576VM/HSC 6.0 System Programmer’s Guide Cross ReferenceSLUVIDAT CHARACTER Cross Reference CDSALLAppendix C. Record Formats SLUVSDAT Cross Reference STNACSAppendix C. Record Formats SLUVVDAT CHAR CONST CHARACTER CHARACTER X’20’ HEXSTRING HEXSTRING Cross Reference VOLDESTAppendix C. Record Formats 590VM/HSC 6.0 System Programmer’s Guide Appendix C. Record Formats VOLRRCNL592VM/HSC 6.0 System Programmer’s Guide Batch API Mapping Macros Batch API RecordsTable 64. Mapping macros for Batch API Records Appendix C. Record FormatsSLUVDDAT Batch API Record FormatsF0F1 Cross Reference596VM/HSC 6.0 System Programmer’s Guide Appendix C. Record Formats UVD994B5‘CVAL’ 1st ed., 6/30/04 -SLUVPDAT SIGNED-HWORD 600VM/HSC 6.0 System Programmer’s Guide Cross ReferenceOffset NameValue UVPTWSTD1st ed., 6/30/04 - 602VM/HSC 6.0 System Programmer’s GuideAppendix D. Logging ACS Robotics Motion Temporary Motion Error CountsInformation Being Logged Robotics Motion Start CountsPermanent Motion Errors 604VM/HSC 6.0 System Programmer’s Guide1st ed., 6/30/04 - How Information is Logged BYTE #Description of Field 46-46 152-155 Motion Hard Fail Software Error Record BYTE #Description of Field Logging Interval Multi-HostEnvironment Single-HostEnvironmentLMU Response Codes Invalid Parameter Error Codes: 0101 - CAP Procedural Error Codes: 0301 - Configuration Error Codes: 0201 -General Procedural Error Codes: 0401 - 0426 LMU LAN Interface Error Codes: 0501 -Drive not rewound 0427LMU Logical Error Codes: 0601 - LSM Robotics Error Codes: 0701 - LSM Logical Error Codes: 0901 - LSM Hardware Error Codes: 0801 -0921 Undefined Response Code Drive Error Codes: 1001 -1012 Load Failure on Special UseOverview Appendix E. Remote-linkedLibrariesAppendix E. Remote-linkedLibraries 1st ed., 6/30/04 -Configuration Figure 29. Configuration622VM/HSC 6.0 System Programmer’s Guide Configuration MVS/CSCAppendix E. Remote-linkedLibraries Configuration Figure 30. Configuration624VM/HSC 6.0 System Programmer’s Guide Configuration Figure 31. ConfigurationAppendix E. Remote-linkedLibraries Configuration Figure 32. Configuration626VM/HSC 6.0 System Programmer’s Guide Resolving CDS Issues After a Remote-LinkFailure Programming and Operational ConsiderationsControl Data Set Integrity •Prior to reestablishing the link How QCDS Functions QCDS RequestInvoking QCDS SLSUREQ Macro OverviewAddresses and Registers VM RequirementSLSUREQ VM Requirements label ParametersSyntax REQUESTThis parameter is required BUFFER E,parmaddr QCDS Programming ConsiderationsNotes UCALADRReturn Field Name Return CodesDecimal 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 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 Output Description Request EnteredRecords Returned Syntax SLSUREQM MacroParameters PRO=NO|YESBatch 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 NumericsIndex 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, definedCAP 468, 478, ACS 108,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 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