Release
System Programmer’s Guide
312579601
Host Software Component VM Implementation
Restricted Rights
Export Destination Control Statement
Limitations on Warranties and Liability
Proprietary Information Statement
Doc Kit Number
Document Effectivity
Host Software Component for
Document Effectivity
1st ed., 6/30/04 -
ivVM/HSC 6.0 System Programmer’s Guide
What’s New With This Release?
Contents
Preface
xxvii
Matching VOLATTR and TAPEREQ Statements
Chapter 4. Utility Functions
SCP Environment
Invoking the BACKup Utility
Utility Name
Page
Chapter 6. Performance Considerations
Page
How to Specify a CAPid
Reconfiguration utility
Appendix C. Record Formats
Appendix B. CP Commands and DIAGNOSE Codes
Appendix D. Logging ACS Robotics Motion
Appendix E. Remote-linkedLibraries
Glossary
Index
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 Guide
Installation Guide
What’s New With This Release?
Installation Guide
Installation Guide
System Programmer’s Guide
Installation Guide
System Programmer’s Guide
System Programmer’s Guide
Scope
Preface
Intended Audience
Organization of This Guide
How to Use This Guide
Related Publications
References to HSC Product Releases
Reader’s Comments
StorageTek Product Support
1st ed., 6/30/04 -
xxxVM/HSC 6.0 System Programmer’s Guide
Automated Cartridge System Overview
Chapter 1. System Description
TimberWolf 9740 10-cellremovable magazine or 14-cellpermanent rack
Host Software Component Overview
HSC Architecture
HSC Subsystem Components
COMMON
APPLICATIONS
CONTROL
SERVERS
VM Operating System CP and CMS
VM Environment
Storage Management
System Control Program SCP
Device Management
File Management
Job Management
Task Management
Processor Management
Communication
Task Recovery/Termination
Virtual Machine Configuration
Host Software Component HSC
Tape Management System TMS
10VM/HSC 6.0 System Programmer’s Guide
HSC and Automated Cartridge System Interaction
Chapter 1. System Description
Figure 2. Virtual Machine Relationships
12VM/HSC 6.0 System Programmer’s Guide
Figure 3. Shared Library Data Sets
Automated Dismount
Automated Mount
14VM/HSC 6.0 System Programmer’s Guide
Dual LMU Environment
Macros
User Control of HSC Functions
Utilities
PARMLIB Control Statements
Commands
1st ed., 6/30/04 -
18VM/HSC 6.0 System Programmer’s Guide
Chapter 2. Host Software Component Functions
Overview of HSC Functions
Automatic Functions of the HSC
Installation Functions
HSC Service Levels
Description of Base Service Level
Initialization/Termination Functions
Description of Full Service Level
Service Level Execution
Command
Base
Full
Utility
Service Level Execution
Base
Full
Starting the HSC Subsystem at Base Service Level
Displaying/Setting Service Level
Media Type and Recording Technique Processing
26VM/HSC 6.0 System Programmer’s Guide
1st ed., 6/30/04 -
MEDia and RECtech Parameters
MEDIA TYPES
RECORDING TECHNIQUES
Model Parameter
MODel
Resulting RECtech
Matching VOLATTR and TAPEREQ Statements
Nonspecific Volume Requests
Specific Volume Requests
Precedence of VOLATTR and TAPEREQ Statements
Scratch Selection
How To Resolve Scratch Shortages
•Standard and 36track •Long and 36track
Mount/Dismount Functions
Mount Processing for Specific Volumes
Dismount Processing for Library Volumes
Mount Processing for Scratch Volumes
Abnormal Mounts/Dismounts
Example of Mount Command with Readonly Operand
HSC Mount Command Support
Virtual Thumbwheel VTW
Tape Management Interface
Tape Transport Cleaning
Automated Tape Transport Cleaning
Activating Automated Cleaning
Identifying Cleaning Cartridges
Notes
Notes
Over-use Over-limitand Spent Cleaning Cartridges
Managing Over-useCleaning Cartridges
Manual Tape Transport Cleaning
Managing Cleaning Cartridges
1st ed., 6/30/04 -
42VM/HSC 6.0 System Programmer’s Guide
Moving Volumes within the Library
Volume/Cell Control Functions
Scratch Subpool Management
Scratch Threshold Task Restart
Entering Cartridges into the Library
Cartridge Access Port CAP Processing Functions
Ejecting Cartridges from the Library
CAP Mode Considerations
CAP Exception Processing
48VM/HSC 6.0 System Programmer’s Guide
Releasing an Allocated CAP
Near Continuous Operations
Using Multiple CDS Copies
Automatic Recognition of Configuration Changes
Automatic Update of LSM from 4410 to
Run-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/Expand
Renaming/Relocating a CDS - Scenarios
Renaming a CDS Copy
Expanding a CDS - Scenario
Relocating an Uncataloged CDS Copy
CDS ENABLE DSNACS.DBASENEW NEWLOC
CDS EXPAND
56VM/HSC 6.0 System Programmer’s Guide
Swapping Library Transports - New Model Types
Control Data Set Recovery
Common Recovery Functions
Control Data Set Recovery Techniques
User Control of Control Data Sets
Allocation of Control Data Sets
Dynamic Enable/Disable of Control Data Sets
4. Issue the command
Command Functions
Figure 5. HSC Command Functions Overview
62VM/HSC 6.0 System Programmer’s Guide
Controlling LSM Operating Mode
Controlling CAP Operating Mode
Viewing the Interior Components of an LSM
•A VIew request is sent to the controlling LMU
Utility Functions
Figure 6. Utility Functions Overview
Chapter 2. Host Software Component Functions
Dual LMU Functionality
LMU Server Functions
If the Master LMU Fails
If the Standby LMU Fails
LMU Switchover Messages
After an LMU Switch Occurs
HSC/LMU Software Combinations
Adding New Stations to an ACS
JCL to Add New Stations to an ACS
Notes for the Example
Reconstructing a LIBGEN
Recovery Maintenance Requirements
Dynamic LMU Connection
HSC Port Number Assignments
Multiple TCP/IP Stack Implications
Transitioning Between 3270 and TCP/IP
3270 to TCP/IP
TCP/IP to
Recovering TCP/IP Communications
Operator Intervention - Dual LMU Configuration
Operator Intervention - Single LMU Configuration
Communication Lost to Master LMU
Communication Lost to Standby LMU
System Definition File ACS SYSDEF
Configuring VM for TCP/IP Support
System Profile File ACS SYSPROF
HSC Startup Job File ACS SLKJCL
Commands to Format OS Minidisk
Initializing the LMUPATH Definition Data Set
Commands to Format CMS Reserved Minidisk
Minidisk Statement for the LMUPATH Data Set
JOB SLSXUTIL SLUGENER /PARM RECCOPY
LMUPATH Definition Data Set
FILE SYSPRINT DEV PRNT CLASS A
FILE SYSUT2 DEV <vaddr> DSN <dsname> /FILE SYSUT1
Types of Communications Services
Host-to-HostCommunications Services
Communication Functions
Information Passed Between Hosts
Chapter 2. Host Software Component Functions
How Communications Services are Set or Changed
Switching Communications Paths
Software Requirements
Tape Management Interface
82VM/HSC 6.0 System Programmer’s Guide
Batch Application Program Interface API
Overview
PARMLIB Control Statements
Defining PARMLIB Control Statements
Options Offered by PARMLIB Control Statements
Processing PARMLIB Control Statements
CAP Preference Definition
Control Data Set Definition
EXECPARM Control Definition
Communications Path Definition
Journal Data Set Definition
License Key Information
Reconfiguration CDS Definition
Control Statement Continuation Conventions
Option Control
Scratch Subpool Control
Syntax
CDSDEF CDS Definition CDSDEF Control Statement
Control Statement Name
CDSDEF
Parameters
DISABLE
DSN3SLS.DSTBY,VOL3HSC103,UNIT3503,+ DISABLE
Example
CDSDEF
CDSDEF DSN1SLS.DBASE,VOL1HSC101,UNIT1501,+
Syntax
EXECParm EXECParm Control Statement
Control Statement Name
EXECParm
EXECParm
EXECParm Control Statement - Command Prefix Off
HOSTID
Example
Journal Definition JRNDEF Control Statement
JRNDEF
Syntax
Control Statement Name
UNITx
JRNDEF
FULL
Abend
Command Name
LKEYDEF LKEYDEF Command and Control Statement
Parameter Descriptions
dataset-name
unitname
LKEYDEF
host-id
UNIT
product-identifier
LKEYINFO
customer-name
nnnnnnn
license-key-string
Examples
LKEYINFO
Syntax
RECDEF
Control Statement Name
RECDEF
Example
RECDEF
RECDEF DSN1SLS.DBASE,VOL1HSC101,UNIT1501,+
DSN2SLS.DBSEC,VOL2HSC102,UNIT2502
Syntax
SCRPOol Scratch Subpool Control Statement
Control Statement Name
SCRPOol
RANGE
SCRPOol
Notes
LABEL
Other Methods of Controlling Scratch Subpools
SCRPOol
Example
Definition Data Set Control Statements
LMU Path
OPTion TITLE
LMU Parameter Definition
Scratch Subpool Parameter Statement Definition
Defining Tape Request Attributes TAPEREQ
Defining LMU Network Connections
Volume Attribute
Volume Attribute Definition
Defining Unit Attributes UNITATTR
Defining Volume Attributes VOLATTR
Control Statement Continuation Conventions
Identifying the Definition Data Sets OPTION TITLE
LMUPATH Usage
LMUPATH LMUPATH Control Statement
Syntax
Control Statement Name
lmu_hostname
LMUPATH
nnn.nnn.nnn.nnn
LMUADDR
110VM/HSC 6.0 System Programmer’s Guide
LMUPDEF LMUPDEF Command and Control Statement
dataset.name
LMUPDEF
Syntax
Control Statement Name
Load the LMUPATH Parameters From YOUR.DSNMEMBER
LMUPDEF
unitname
host-id
identifying-string
OPTion TITLE OPTion TITLE Control Statement
Syntax
Control Statement Name
Example
OPTion TITLE
114VM/HSC 6.0 System Programmer’s Guide
1st ed., 6/30/04 -
SCRPDEF
Syntax
SCRPDEF
Control Statement Name
Parameters
SCRPDEF
Load the SCRPOol Parameters From YOUR.DSNMEMBER
unitname
host-id
TAPEREQ Usage
TAPEREQ Tape Request TAPEREQ Control Statement
Disabling a TAPEREQ Definition
TAPEREQ
120VM/HSC 6.0 System Programmer’s Guide
TAPEREQ
TAPEREQ
Syntax
TAPEREQ
Syntax continued
TAPEREQ
122VM/HSC 6.0 System Programmer’s Guide
step-name
job-name
TAPEREQ
Control Statement Name
DD-name
program-name
TAPEREQ
PROGram or PGMname
expiration-date
retention-period
TAPEREQ
EXPDT
LONGItud
TAPEREQ
Standard
ECART
ZCART
TAPEREQ
DD3A, DD3B, DD3C
STK1
RECtech
TAPEREQ
Notes
LONGItud
36Atrack
TAPEREQ
STK1RC
TAPEREQ
subpool-name
TAPEREQ
4490
TAPEREQ
Set Tape Request Attributes
Example
132VM/HSC 6.0 System Programmer’s Guide
TREQDEF
Syntax
TREQDEF
Control Statement Name
Parameters
TREQDEF
Load the TAPEREQ Parameters From YOUR.DSNMEMBER
unitname
host-id
UNITATTR
Unit Attribute UNITATTR Control Statement
UNITATTR Usage
unit-address
UNITATTR
Syntax
Control Statement Name
MODel
UNITATTR
UNITATTR
Specify Unit Attribute Statements
T9940B35
IGNORE
140VM/HSC 6.0 System Programmer’s Guide
UNITDEF
Syntax
UNITDEF
Control Statement Name
Parameters
host-id
UNITDEF
Examples
Specify a Data Set Containing UNITATTR Statements
Volume Attribute VOLATTR Control Statement
VOLATTR
VOLATTR Usage
Disabling a VOLATTR Definition
VOLATTR
144VM/HSC 6.0 System Programmer’s Guide
VOLATTR
This syntax diagram is continued on the next page
Syntax
VOLATTR SERial volser
Syntax continued
VOLATTR
Control Statement Name
VOLATTR
VOLATTR
volser or vol-rangeor vol-list
Parameters
SERial
Valid media types are
VOLATTR
ZCART
VOLATTR
DD3A, DD3B, DD3C, DD3D
STK1
STK2P, STK2W
VOLATTR
RECtech
LONGItud
indicates a 9490 Timberline transport
VOLATTR
use-limit
VOLATTR
STK1RC34
VOLATTR
Set Volume Attributes
Example
VOLATTR SERIALL*,AA9* MEDIAECART
154VM/HSC 6.0 System Programmer’s Guide
VOLDEF
Syntax
VOLDEF
Control Statement Name
Parameters
VOLDEF
Load the VOLATTR Parameters From YOUR.DSNMEMBER
unitname
host-id
PARM Statement
Creating an SLKJCL File for Starting the HSC
PARM Statement Parameters
Syntax
RESET
SSYS
COLD
Member
RECONFIG
Dialog
Both
HSC Startup Job ACS SLKJCL
Example
Sample ACS SLKJCL File
Description of /FILE Statement
Notes
SLSSYSXX
Starting HSC Execution
Configuration Mismatches
Modifying LSMs Online
Specifying CAP Preferences
164VM/HSC 6.0 System Programmer’s Guide
Multiple Hosts Startup Considerations
Starting the HSC
Syntax for Initializing HSC to Full Service Level
Initializing the HSC to the Full Service Level
Syntax for Initializing HSC to Base Service Level
Initializing the HSC to the Base Service Level
1st ed., 6/30/04 -
168VM/HSC 6.0 System Programmer’s Guide
Overview of Library Utilities
Chapter 4. Utility Functions
Selecting a Utility
Function
Utility to Use
Restore or recreate the library CDS
Typical Use of Utilities
Control Statement Syntax Conventions
Utility Syntax Conventions
Utility Environmental Requirements
ACS UTIL Exec
ACSCMS EXEC
CMS Environment
ACSUTIL SLKJCL file
SCP Environment
SCP Batch Job Control Language JCL
JCL and Control Statements
JOB Statement
jobname
parms
PARM Statement
COMM Statement
comments
fname
Submitting Jobs
ftype
fmode
Control Statements vs. JCL
Utility Control Statements
How to Invoke SLUADMIN
Utility Administrator SLUADMIN
SLUADMIN Program Return Codes
How to Invoke Utility Programs
Return Code
Description
Reports Created by Utilities
Report Headings
Parameters Controlling Report Headings
Example
Example of JCL Using Report Heading Options
DATE=2YR
DATE=4YR
Stand-AloneUtilities
Activities Report
Activities Report Utility
SLUACTV EXEC
type
Activities Report
SLSSMF fname ftype fmode
PARM
MIXED
Utility Name
Syntax
Parameters
begin-date
end-time
end-date
Activities Report
TODAY
Control File Example
Invoking the Activities Report Utility
Output Description
Control File to Produce an Activities Report
Total
Activities Report
% of all
Activities Report
Ave. time
Ave. pass-thrus
Activities Report
Usage Notes
Earliest
Latest
•LSM operating statistics record, subtype 1, and
Activities Report
ACS ID
Activities Report
ARM USE
P-THRU
Activities Report
Usage Notes
196VM/HSC 6.0 System Programmer’s Guide
Figure 9. Activities Report Utility Sample Output
Activities Report
Chapter 4. Utility Functions
1st ed., 6/30/04 -
Audit
Audit Utility
Audit
Media Type Mismatch Conditions
Actions Permitted During an Audit
How the AUDIt Utility Functions
Audit
Audit
Concurrent Audits
Audit
acs-id
Syntax
Utility Name
panel-list
lsm-list
Audit
PANel
column-list
row-list
Audit
Notes
Audit
cap-id
EMPTYCel
Audit
DIAGScan
Notes
Invoking the Audit Utility
JCL Requirements
ACSUTIL SLKJCL File
Audit
JCL for Audit of Entire Library all ACSs
JCL Examples
JCL for Selective Audit 1 ACS, 2 LSMs, with CAPid
Audit
JCL for Selective Audit of Empty Cells
JCL for Selective Audit of Diagnostic Cells Only
Audit
Output Description
Figure 10. AUDIt Utility Sample Output
Audit
210VM/HSC 6.0 System Programmer’s Guide
1st ed., 6/30/04 -
Backup
Backup Utility
Reasons for Running the BACKup Utility
Prerequisites
Backup How the BACKup Utility Functions
Backup Backup Procedure
BACKup
Backup
Syntax
Utility Name
Primary
Backup
Secondary
STandby
Restart
Backup
SLSPRINT
Backup JCL Requirements
SLSCNTL
SLSCNTL2
ACSUTIL SLKJCL File
Backup Invoking the BACKup Utility
JCL for Running Backup
Backup JCL Examples
Run Backup Utility
JCL for Running a Copy Backup
Backup
Output Description
•the following data sets
•a condition code from backup processing
Backup
4warning MESSAGES – Backup successful
Chapter 4. Utility Functions
Figure 11. BACKup Utility Sample Output 1 of
Backup
222VM/HSC 6.0 System Programmer’s Guide
1st ed., 6/30/04 -
Figure 11. BACKup Utility Sample Output 2 of
Backup
Chapter 4. Utility Functions
1st ed., 6/30/04 -
Backup How to Restart Backup
Related Utilities
224VM/HSC 6.0 System Programmer’s Guide
Database Decompile
Database Decompile LIBGEN Utility
How the Database Decompile Utility Functions
Prerequisites
Utility Name
Database Decompile Syntax
Parameters
JCL Requirements
JCL Example
Invoking the Database Decompile Utility
JCL for Database Decompile
Database Decompile
Device
Database Decompile Output Description
Label
Description
Database Decompile
Chapter 4. Utility Functions
1st ed., 6/30/04 -
Database Decompile
230VM/HSC 6.0 System Programmer’s Guide
1st ed., 6/30/04 -
Database Decompile
Chapter 4. Utility Functions
1st ed., 6/30/04 -
Database Decompile
232VM/HSC 6.0 System Programmer’s Guide
1st ed., 6/30/04 -
Database Decompile
Chapter 4. Utility Functions
1st ed., 6/30/04 -
Database Decompile
234VM/HSC 6.0 System Programmer’s Guide
1st ed., 6/30/04 -
Database Decompile
Chapter 4. Utility Functions
1st ed., 6/30/04 -
Directory Rebuild
Directory Rebuild Utility
Reasons for Running the Directory Rebuild Utility
How the Directory Rebuild Utility Functions
Invoking the Database Decompile Utility
Directory Rebuild
SLSCNTL, SLSCNTL2, SLSSTBY
SLSIN
Directory Rebuild JCL Example
JCL for Directory Rebuild
Output Description
Eject Cartridge Utility
Eject Cartridge
Syntax
Utility Name
Eject Cartridge
EJECt
Eject Method 2 continued
vol-list
Eject Cartridge Parameters
count
VOLser
•CST •MEDIA1 •STD •1 •3480
Eject Cartridge
Note: STK2P can be abbreviated to P
Eject Cartridge
indicates a 3490E-image9840 transport
Eject Cartridge
Eject Cartridge
cap-list
Eject Cartridge
Invoking the Eject Cartridge Utility
JCL Requirements
ACSUTIL SLKJCL File
JCL to Eject One STD Scratch Cartridge
JCL for Ejecting a Single Volume
JCL to Eject Five SD-3Scratch Cartridges
Eject Cartridge
Eject Cartridge Output Description
Figure 13. EJECt Cartridge Utility Sample Output
248VM/HSC 6.0 System Programmer’s Guide
Enter Cartridges
Enter Cartridges Utility
CAP Operating Instructions
Syntax
Enter Cartridges
Invoking the Enter Cartridges Utility
JCL Requirements
SCRatch
Enter Cartridges
JCL for Entering Cartridges in a CAP
JCL Example
Output Description
Figure 14. Enter Cartridge Utility Sample Output
Enter Cartridges
252VM/HSC 6.0 System Programmer’s Guide
1st ed., 6/30/04 -
Journal Offload
Journal Offload Utility
Syntax
Utility Name
Journal Offload
Invoking the Journal Offload Utility
SLSOFF02
SLSIN
Journal Offload JCL Example
JCL for Offload of Journals
Output Description
Figure 15. Journal Offload Utility Sample Output
Journal Offload
256VM/HSC 6.0 System Programmer’s Guide
1st ed., 6/30/04 -
Move Utility
Move
MOVe Considerations
Move
lsm-id
Syntax
Utility Name
Move
panel
row-list
column-list
Move JCL Requirements
Invoking the Move Utility
ACSUTIL SLKJCL File
Move Several Volumes From an LSM to Another LSM
Move JCL Examples
Output Description
Figure 16. MOVe Utility Sample Output
Move
262VM/HSC 6.0 System Programmer’s Guide
1st ed., 6/30/04 -
Performance Log Reblocker
Performance Log Reblocker Utility
Syntax CMS Statement
Performance Log Reblocker utility
Performance Log Reblocker
Performance Log Reblocker
mvsnode
JCL Requirements
class
Reconfiguration Utility
Reconfiguration
Reasons for Running the Reconfiguration Utility
Considerations Before Running Reconfiguration
DASD Considerations in a VM-onlyEnvironment
Reconfiguration
How the Reconfiguration Utility Functions
Reconfiguration
268VM/HSC 6.0 System Programmer’s Guide
Reconfiguration
I/O Considerations
Condition
Number of I/Os
Minimizing I/O Time
Running a Successful Reconfiguration
Reconfiguration
Notes
7.Log on to STKACS
Reconfiguration
Comment out any AUTOJOB statements
Reconfiguration
e. Copy the updated SYSPROF to the RUN-disk
Reconfiguration
q.Issue the following command
Reconfiguration
17.Save ACS SYSPROF on the RUN-diskB
Reconfiguration
Restore
Restore Utility
Reasons for Running the RESTore Utility
How the RESTore Utility Functions
RESTore
Restore
Utility Name
Parameters
JCL Requirements
Restore
Only
Short
Restore Invoking the Restore Utility
JCL Examples
ACSUTIL SLKJCL File
JCL for RESTore with GENerate Only
JCL for RESTore with Journals Applied
Restore
280VM/HSC 6.0 System Programmer’s Guide
JCL for RESTore Journals and Output to SLSAUDIT
Restore
Output Description
Figure 17. Restore Utility Sample Output
Restore
282VM/HSC 6.0 System Programmer’s Guide
1st ed., 6/30/04 -
Restore
How to Handle BACKup/RESTore Discrepancies
Scratch Redistribution Utility
Scratch Redistribution
How the Scratch Redistribution Utility Functions
Utility Name
Scratch Redistribution Syntax
SCREdist
Chapter 4. Utility Functions
tolerance-value
Scratch Redistribution Parameters
acs-id
lsm-list
expnumlsm
Scratch Redistribution
indicates any Standard, ECART, or ZCART cartridge
Scratch Redistribution
indicates any T9840 cartridge
Scratch Redistribution
Scratch Redistribution
indicates a device using helical recording
indicates any T9940A transport
Scratch Redistribution
Invoking the Scratch Redistribution Utility
Scratch Redistribution JCL Requirements
JCL Examples
ACSUTIL SLKJCL File
Scratch Redistribution
JCL to Perform Scratch Redistribution
JCL to Perform Scratch Redistribution
JCL to Perform Scratch Redistribution
294VM/HSC 6.0 System Programmer’s Guide
Scratch Redistribution Output Description
Scratch Update
Scratch Update Utilities
Utility Names
SCRAtch utility
Invoking the Scratch Update Utilities
Scratch Update Parameters
JCL Requirements
vol-list
Scratch Update
JCL to Scratch, Unscratch, and Replace
JCL Example
Output Description
Figure 19. Scratch Update Utilities Sample Output
Scratch Update
298VM/HSC 6.0 System Programmer’s Guide
1st ed., 6/30/04 -
SET Utility
SET Option
How the SET Utility Functions
Affected HSCs
All Other HSCs
Summary of SET Utility Options
Considerations Before Running the SET Utility
SET Utility Function and Location of Description
SET Option
Set Syntax
Note: This syntax is continued on the next page
Chapter 4. Utility Functions
esoteric
SET ACS Esoteric
Utility Name
Parameters
SET CLNPRFX PROCEDURE
SET Cleaning Prefix
SET HSC Command Prefix
prefix
Description
Character
SET Delete Disposition
SET Eject Password
SCRTCH
NOSCRTCH
oldpswd
SET Freeze Panel
FREEZE
newhost
SET Host ID
oldhost
SET HSC Level
qname
SET ENQ/DEQ/RESERVE QNAME
SET New Host
model-host
SET Device Numbers for Drives
SET Scratch Label Type
esoteric
FORHOST
addr0,...addr19
FORLSMID
Running SET SLIDRIVS With the HSC Active
lsm-id
FORPANEL
SET LMU Station Address Numbers
SET SLIDRIVS Procedure
stat1,...,stat16
SLISTATN
SET SMF Record Type
SET Recovery Technique
libtype
FORACS
JCL Requirements
SET TCHNIQE PROCEDURE
SHADOW
BOTH
ACSUTIL SLKJCL File
Invoking the Set Utility
JCL for Set Utility
Set JCL Examples
Output Description
JCL for Multiple SET Statements
Unselect Utility
Unselect
Syntax
Invoking the Unselect Utility
Unselect Utility Name
Parameters
JCL Requirements
Unselect
JCL to Unselect a Volume
JCL Example
Output Description
Figure 20. Unselect Utility Sample Output
Unselect
Chapter 4. Utility Functions
1st ed., 6/30/04
Volume Report
Volume Report Utility
Volume Report
Media Type and Recording Technique Considerations
•change the VOLATTR statements
Volume Report
Volume Report Syntax
volser or vol-range or vol-list
Volume Report Utility Name
Parameters
acs-id
SORT
Volume Report
INCLude
Volume Report
MEDEQUAL
Volume Report
NONMEDEQ
NOEXTernal
VOLIST
Volume Report
VOLDATA
CDSDATA
Volume Report
JCL/Parameter File Requirements
SLSCNTL, SLSCNTL2, SLSSTBY
SLSPRINT
SLSCNTL
JCL/Parameter File Syntax
vaddr
control.set.name
keywords
fn, ft, fm
SLSCDATA CMS only
SLSSCRPL CMS only
PARM
SLSVA CMS only
parameters
JOB SCP only
SLUVOLR EXEC CMS
Volume Report Invoking the Volume Report Utility
Parameter File
ACSUTIL SLKJCL File
JCL to Produce a Volume Report
Volume Report
JCL Example
Report Detail Lines
JCL to Produce a Volume Report for an MVS PDS
Media and Recording Technique Origin
Volume Report
Errant, Scratch, Selected Fields
Media Type Prefix Characters
External Label Field
Cartridge Usability CLN USE Field
Subpool ID Field
Volume Report Totals
Times Selected Field
Totals Reports
Volume Report
Volume Report Flat Files
Volume Report
Chapter 4. Utility Functions
1st ed., 6/30/04 -
Volume Report
344VM/HSC 6.0 System Programmer’s Guide
1st ed., 6/30/04 -
Volume Report
Chapter 4. Utility Functions
1st ed., 6/30/04 -
1st ed., 6/30/04 -
346VM/HSC 6.0 System Programmer’s Guide
Abend Codes
Messages
HSC Messages
SCP Messages
Software Trace Facilities
CP Trace Table
CCWTRACE
SCP SET TRACE Command
VM CP Debug Commands
TRACE Command Syntax
SCP Internal Trace Table
Trace Table Entries
Master Trace Table Header
DSP Trace Entry
Query
Code
TTEWORD1
IPARML IUCV Parameter List
= IRT address
TTEWORD2 = IPARML bytes
Inputs
IPARML for IUCV CONNECT to *BLOCKIO
Inputs
IPARML for IUCV SEND to *BLOCKIO
=target class 1=write; 2=read =flags type=2way
=relative block number =data buffer address
Inputs
IPARML for IUCV RECEIVE
= target class
= flags
Inputs
IPARML for IUCV REPLY
= IUCV message id
= target class
Inputs
IPARML for IUCV SEVER
= name of virtual machine connected to
Outputs
IPRCODE
IUCV Interrupt Buffer
IPTYPE
Interrupt Type
IPARML for Pending Connection Interrupt
IPARML for Connection Complete Interrupt
= IUCV path id
IPPATHID
IPTYPE
= 03=severed, 04=quiesced, 05=resumed
IPARML for Incoming Message Interrupt
IPARML for Message Complete Interrupt
Error Recording Data Set Records
Diagnostic Capabilities
SCP Trace Facility
Supervisor Call and Abnormal End Dumps
SCP External Trace Facility
EXEC
SCP Trace Formatter Utility
SLUETRAC
368VM/HSC 6.0 System Programmer’s Guide
inft
infn
infm
outfn
Supervisor Call SVC Functions
370VM/HSC 6.0 System Programmer’s Guide
1st ed., 6/30/04 -
Refer to Table
Decimal
Function
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 Command
VM CP Commands
Diagnostic Commands
Setting Initialization Sequence Break-Points
SCP Debug Mode
length
offset
SCP Diagnostic Subsystem Commands
Enabling the Diagnostic Subsystem
=DEBUG
=NODEBUG
=DDICT
fieldname
epname
=HPER
offset
length
=WHERE
address
epname
LIst Command
HSC Diagnostic Commands
Syntax Parameters
data-structure
DISPLAY Command
size
address
CDS Recovery Capabilities
Dynamic Recovery of the Control Data Set
Control Data Set Recovery
1st ed., 6/30/04 -
386VM/HSC 6.0 System Programmer’s Guide
Figure 24. Control Data Set Recovery Scheme
Control Data Set Processes
Control Data Set Error Diagnostics
Detecting Mismatch of Control Data Sets
Control Data Set Integrity During Restore
Information Required for StorageTek Diagnosis
Recommended Recovery Actions
How to Request a Dump
Dump Processing
Type of Dumps Supported
Note Reason For Dump
What to do When a Dump Occurs
Move Problem Materials to Tape
Load Dump and CONSLOG Onto Disk
Call StorageTek Software Support
Dump Analysis Using SLUIPCS
VIEW
SLUIPCS SCAN Subcommands
VIEW CVT VIEW CCVT VIEW NUCON VIEW MTT
VIEW STORMAN VIEW LVT VIEW structname
Data Structures
Data Structures
IHAASCB
FIND
EX EXECUTE CMS COMMAND
TRB SAVE AREA TRACEBACK
TTE TRACE TABLE ENTRY
WN WHERE NAME
WA WHERE ADDRESS
STAT STATUS
TASK FIND TASK
SLUIPCS PRINT Options
Major SCP Data Relationships
Figure 25. Command, Message and Trace Processing
Command, Message, Trace Processing
1st ed., 6/30/04 -
NUCON X’10’ VECTPTR TRCTAB
Diagnostic Techniques
SCP Task/Job Data Relationships
Subsystem Data Relationships
NUCON JBLOK PSAAOLD JBLTASK TBLOK PSATOLD
Figure 26. SCP Task/Job Data Relationship
TKRBLIST
RQBLOK
404VM/HSC 6.0 System Programmer’s Guide
Figure 27. Subsystem Data Relationships
NUCON CVT VECTPTR CVTJESCT
JESCT JESSSCT SSCT SSCTSCTA SSCTSSVT SSCT
Find a Module Plus Offset, Given an Address
Common Dump Analysis Tasks
Find a Module Address, Given a Name
View an HSC or SCP Data Area
Identify the Failing Routine
Find the Failing Task
Find the Failing Request Block
Find the LVT
Save Area Trace Back
Find the LCT, LST, HST
Identify the Last Interrupt Event
Diagnostic Materials
Gather Diagnostic Materials
Examine an SDWA
Find IUCV Path Descriptors
details of problem circumstances •STKACS abend
Tape Return
Tape Format
Chapter 6. Performance Considerations
How Library Activity Affects Library Performance
Overview
Using the Activities Report Utility
Monitoring Library Activity and Performance
How Operators Control Library Performance
ACS Daily Report
Tape Volume Report
Maintain Quantities of Scratch Cartridges
Redistribute Scratch Volumes in the Library
Define CAP Preferences
414VM/HSC 6.0 System Programmer’s Guide
Use PARMLIB to Define Static Parameters
Use SMF Records to Collect Performance Data
Operator Command
Performance Parameter
Journal Definition
Set High-Performance Host-to-HostCommunications
Define High Dispatching Priority for the HSC
Functioning of Host-to-HostCommunications
Designation of Communication parameters
418VM/HSC 6.0 System Programmer’s Guide
Limit View Time to Maintain High Performance
Define Secondary and Standby Control Data Sets
Excessive Use of VIew Command Affects Performance
How to Monitor Usage of the VIew Command
Advantages of Using the VIew Command
1st ed., 6/30/04 -
Chapter 6. Performance Considerations
Reduce Pass-Thrus
Loading Cartridges Into the Library
Unnecessary Pass-Thrus
Unavoidable Pass-Thrus
Scheduled Pass-Thrus
Ways to Reduce Pass-ThruActivity
Ensure adequate free cells
Reduce Operator Intervention
Eject through the CAP closest to the cartridge
Redistribute cartridges during off-peaktimes
Reduce Tape Transport Contention
ACSPROP EXEC
Prefetch Enters
Avoid Crashing Test Systems
Usage Requirements
Reduce Scheduling Contention
Syntax
Parameters
Use the Audit Utility Effectively
Use Performance Log Reblocker to Format Data
Use LSMs as Scratch Loaders in a Mixed ACS
Syntax Flow Diagrams
Commands Syntax Reference
Specifying Commands
Variables
Single Required Choice
Flow Lines
Repeat Symbol
Defaults
Single Optional Choice
Default Value Value2 Value3
Fragment
Syntax Continuation Fragments
432VM/HSC 6.0 System Programmer’s Guide
1st ed., 6/30/04 -
Library Identification
CAPid Formats
How to Specify a CAPid
LSM Model 4410 and PowderHorn LSM Model
WolfCreek LSM Models 9360-050, 9360-075,and
00indicates one of the following
436VM/HSC 6.0 System Programmer’s Guide
Ranges And Lists
A00A0-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 follows
SCRPOOL NAME=STD36,RANGEAAA000AAA999
ZZZ000ZZZ999
440VM/HSC 6.0 System Programmer’s Guide
MODel, and RECtech parameters
MEDia, RECtech, and MODel Parameters
acs-id, lsm-id
acs-id, lsm-id
Mount
acs-id, lsm-id
VOLATTR
LIBGEN Macros
444VM/HSC 6.0 System Programmer’s Guide
1st ed., 6/30/04 -
SLIALIST macro
SLIACS macro
SLIDLIST macro
SLIDRIVS macros
SLILIBRY macro
446VM/HSC 6.0 System Programmer’s Guide
1st ed., 6/30/04 -
SLIRCVRY macro
SLILSM macro
SLISTATN macro
SLIRCVRY
EXECParm control statement
HSC Control Statements
Journal Definition JRNDEF control statement
448VM/HSC 6.0 System Programmer’s Guide
LKEYINFO control statement
LKEYDEF command and control statement
LMUPATH control statement
VOLumevolser
Scratch Subpool SCRPOol control statement
OPTion control statement
450VM/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 continued
Unit Attribute UNITATTR control statement
Volume Attribute VOLATTR control statement
454VM/HSC 6.0 System Programmer’s Guide
1st ed., 6/30/04 -
STK1RA STK1RA34 STK1RA35 STK1RB STK1RB34 STK1RB35
1st ed., 6/30/04 -
456VM/HSC 6.0 System Programmer’s Guide
ACTIvities Report utility
Utilities
AUDIt utility
ACSacs-id
Database Decompile LIBGEN utility
BACKup utility
Directory Rebuild DIRBLD utility
EJECt utility
Enter Cartridges utility
EJECt utility continued
Journal OFFLoad utility
Reconfiguration utility
MOVe utility
REPLace utility
SCRAtch utility
RESTore utility
462VM/HSC 6.0 System Programmer’s Guide
Scratch Redistribution SCREdist utility
Options
SET utility
Unselect utility
UNSCratch utility
SET utility continued
464VM/HSC 6.0 System Programmer’s Guide
Volume Report VOLRpt utility
CDs Enable/Disable command
Operator Commands
CLean command
466VM/HSC 6.0 System Programmer’s Guide
DISMount command
Display Acs
Display command
Display ALl
Display ALLOC
Display COMMPath
Display Cmd
Display DRives
CMd COmmand
470VM/HSC 6.0 System Programmer’s Guide
Display Drives continued
Display LKEYDEF
Display Exceptions
Display LMUPDEF
Display LSM
Display OPTion
Display MONitor
Display Requests
472VM/HSC 6.0 System Programmer’s Guide
Display SCRatch
Display SRVlev
Display SCRPDEF
Display Status
474VM/HSC 6.0 System Programmer’s Guide
Display TREQDEF
Display THReshld
EJect command
DRAin CAP command
Display Volume
Display UNITDEF
Eject Command continued
Journal command
ENter command
MODify command
MONITOR command
volser
Mount command
devaddr
host-id
480VM/HSC 6.0 System Programmer’s Guide
Volume
MOVe command
MOVe
Flsmlsm-id
RECover Host command
OPTion command and control statement
RELease CAP command
482VM/HSC 6.0 System Programmer’s Guide
SRVlev Service Level command
SENter command
Stop Monitoring STOPMN command
SWitch command
TRACELKP command
TRace command
Vary Station command
484VM/HSC 6.0 System Programmer’s Guide
VIew command
486VM/HSC 6.0 System Programmer’s Guide
Warn command
LIst command
HSC Diagnostic Commands
TRace command
1st ed., 6/30/04
AUTHorize Command
SCP Operator Commands
CANCEL command
CP Command
HELP Command
FILE Command
Modify Command SCP
Query Command
Reply Command
SET Command
490VM/HSC 6.0 System Programmer’s Guide
events
destination
STArt Command
SLK Command
STOP Command
STOPSCP Command
GCS Component Server Commands
SLKGCS Command
1st ed., 6/30/04 -
ACS EXEC
CMS Operator Commands
CMS HELP
494VM/HSC 6.0 System Programmer’s Guide
CP Commands
Appendix B. CP Commands and DIAGNOSE Codes
CP Programming Services
Overview
IUCV
496VM/HSC 6.0 System Programmer’s Guide
1st ed., 6/30/04 -
Overview
Appendix C. Record Formats
Mapping Macros for LOGREC Records
Mapping Macros for SMF Records
Mapping Macros for Batch API Records
Type
SMF Mapping Macros
SMF Records
SLSDVAR
SMF Record Formats
Cross Reference
Type
Table 33. SLSSFHDR Record Format
SLSSFHDR
Type
Length
Type
Table 33. SLSSFHDR Record Format Continued
Length
Label
Type
Table 33. SLSSFHDR Record Format Continued
Length
Label
504VM/HSC 6.0 System Programmer’s Guide
Cross Reference
Offset
Name
Value
Appendix C. Record Formats
SLSSBLOS
SIGNED-FWORD
Cross Reference
Cross Reference
SLSSCAPJ
Cross Reference
SLSSCAPN
SLSSVSTA
Cross Reference
SLSSVSTA
Appendix C. Record Formats
Cross Reference
SLSSMLSM
SLSSLSB
Table 39. SLSSLSB Record Format Continued
Cross Reference
Type
Length
SLSSMF07
1.1 X’05’
CHARACTER
CHAR CONST
LENGTH
520VM/HSC 6.0 System Programmer’s Guide
Cross Reference
Appendix C. Record Formats
SMF07MVU
522VM/HSC 6.0 System Programmer’s Guide
SLSSMF08
524VM/HSC 6.0 System Programmer’s Guide
Cross Reference
LOGREC Mapping Macros
LOGREC Records
SLSSLHDR
LOGREC Record Formats
OFFSET
Type
Table 43. SLSSLHDR Record Format Continued
Length
Label
Cross Reference
LTYPAREA
Appendix C. Record Formats
530VM/HSC 6.0 System Programmer’s Guide
SLSSVLG1
532VM/HSC 6.0 System Programmer’s Guide
Cross Reference
SLSSBLOG
534VM/HSC 6.0 System Programmer’s Guide
Cross Reference
SLSSLLG1
CONST
1.. .... X’40’
538VM/HSC 6.0 System Programmer’s Guide
Cross Reference
Appendix C. Record Formats
LLG1NWSN
SLSSLLG2
HEXSTRING
Cross Reference
Cross Reference
SLSSLLG3
SLSSLLG4
544VM/HSC 6.0 System Programmer’s Guide
Cross Reference
SLSSLLG5
1... .... X’80’
Cross Reference
LLG5ACS
Appendix C. Record Formats
SLSSLLG6
1... X’08’
SIGNED-FWORD
Cross Reference
LLG6ACS
Appendix C. Record Formats
552VM/HSC 6.0 System Programmer’s Guide
SLSSDJLR
CHARACTER
Cross Reference
SLSSPSWI
556VM/HSC 6.0 System Programmer’s Guide
Cross Reference
Cross Reference
SLSSRL00
Cross Reference
SLSSRL01
SLSSHLG1
1. .... X’20’
Cross Reference
HLG1FLG1
Appendix C. Record Formats
Volume Report and Batch API Mapping Macros
Volume Report and Batch API Records
SLUVADAT
Volume Report and Batch API Record Formats
1.. .... X’40’
HEXSTRING
1 ..1. X’12’
X’80’
Cross Reference
568VM/HSC 6.0 System Programmer’s Guide
Appendix C. Record Formats
LSMNADLS
570VM/HSC 6.0 System Programmer’s Guide
SLUVCDAT
1 X’01’
Cross Reference
CFGCCPFX
Appendix C. Record Formats
SLUVHDAT
1.. .... X’40’
576VM/HSC 6.0 System Programmer’s Guide
Cross Reference
SLUVIDAT
CHARACTER
Cross Reference
CDSALL
Appendix C. Record Formats
SLUVSDAT
Cross Reference
STNACS
Appendix C. Record Formats
SLUVVDAT
CHAR CONST
CHARACTER
CHARACTER
X’20’
HEXSTRING
HEXSTRING
Cross Reference
VOLDEST
Appendix C. Record Formats
590VM/HSC 6.0 System Programmer’s Guide
Appendix C. Record Formats
VOLRRCNL
592VM/HSC 6.0 System Programmer’s Guide
Batch API Mapping Macros
Batch API Records
Table 64. Mapping macros for Batch API Records
Appendix C. Record Formats
SLUVDDAT
Batch API Record Formats
F0F1
Cross Reference
596VM/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 Reference
Offset
Name
Value
UVPTWSTD
1st ed., 6/30/04 -
602VM/HSC 6.0 System Programmer’s Guide
Appendix D. Logging ACS Robotics Motion
Temporary Motion Error Counts
Information Being Logged
Robotics Motion Start Counts
Permanent Motion Errors
604VM/HSC 6.0 System Programmer’s Guide
1st 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-HostEnvironment
LMU 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
0427
LMU 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
1012
Load Failure on Special Use
Overview
Appendix E. Remote-linkedLibraries
Appendix E. Remote-linkedLibraries
1st ed., 6/30/04 -
Configuration
Figure 29. Configuration
622VM/HSC 6.0 System Programmer’s Guide
Configuration
MVS/CSC
Appendix E. Remote-linkedLibraries
Configuration
Figure 30. Configuration
624VM/HSC 6.0 System Programmer’s Guide
Configuration
Figure 31. Configuration
Appendix E. Remote-linkedLibraries
Configuration
Figure 32. Configuration
626VM/HSC 6.0 System Programmer’s Guide
Resolving CDS Issues After a Remote-LinkFailure
Programming and Operational Considerations
Control Data Set Integrity
•Prior to reestablishing the link
How QCDS Functions
QCDS Request
Invoking QCDS SLSUREQ Macro
Overview
Addresses and Registers
VM Requirement
SLSUREQ VM Requirements
label
Parameters
Syntax
REQUEST
This parameter is required BUFFER
E,parmaddr
QCDS Programming Considerations
Notes
UCALADR
Return Field Name
Return Codes
Decimal Value and Description
Invalid SLSUREQ Requests
Sample QCDS Requests
636VM/HSC 6.0 System Programmer’s Guide
WKFLATDDKFLATDDL,KFLATDD Initialize the working
638VM/HSC 6.0 System Programmer’s Guide
Constants
1st ed., 6/30/04 -
640VM/HSC 6.0 System Programmer’s Guide
RECORD AREAS IN AN ALTERNATING FASHION
642VM/HSC 6.0 System Programmer’s Guide
PROCESS
Output Description
Request Entered
Records Returned
Syntax
SLSUREQM Macro
Parameters
PRO=NO|YES
Batch API Mapping SLSUREQM Macro
A-ADDR
SIGNED-FWORD
CONST
CONST
SLSUACSA
Cross Reference
652VM/HSC 6.0 System Programmer’s Guide
1st ed., 6/30/04 -
1st ed., 6/30/04 -
654VM/HSC 6.0 System Programmer’s Guide
Glossary
Central Support Remote Center CSRC— See
Page
directed allocation— See drive prioritization
device separation— See drive exclusion
Page
Page
Page
Page
Page
Page
Silverton— See 4490 Cartridge Subsystem
Page
Page
Numerics
Symbols
8500 library— See StreamLine SL8500 library
1st ed., 6/30/04 -
670VM/HSC 6.0 System Programmer’s Guide
Index
Numerics
Index
672VM/HSC 6.0 System Programmer’s Guide
Index
control data set definition control statement
674VM/HSC 6.0 System Programmer’s Guide
377, 383,
676VM/HSC 6.0 System Programmer’s Guide
Index
Library Control Unit LCU, defined
CAP 468, 478,
ACS 108,
cap-id 466, 476, 478, 482, 483 cap-list 466,
678VM/HSC 6.0 System Programmer’s Guide
478,
680VM/HSC 6.0 System Programmer’s Guide
Index
RECover Host command recovery functions
682VM/HSC 6.0 System Programmer’s Guide
Index
SRVlev command
684VM/HSC 6.0 System Programmer’s Guide
Index
1st ed., 6/30/04 -
686VM/HSC 6.0 System Programmer’s Guide
Page
Printed in U.S.A