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