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
Index
Appendix E. Remote-linkedLibraries
Glossary
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
Automatic Functions of the HSC
Chapter 2. Host Software Component Functions
Overview of HSC Functions
Installation Functions
Initialization/Termination Functions
HSC Service Levels
Description of Base Service Level
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
1st ed., 6/30/04 -
Media Type and Recording Technique Processing
26VM/HSC 6.0 System Programmer’s Guide
RECORDING TECHNIQUES
MEDia and RECtech Parameters
MEDIA TYPES
Resulting RECtech
Model Parameter
MODel
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
Activating Automated Cleaning
Tape Transport Cleaning
Automated Tape Transport 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 Exception Processing
Ejecting Cartridges from the Library
CAP Mode Considerations
48VM/HSC 6.0 System Programmer’s Guide
Releasing an Allocated CAP
Near Continuous Operations
Using Multiple CDS Copies
Run-timeRecognition of 9740 CAP Configuration
Automatic Recognition of Configuration Changes
Automatic Update of LSM from 4410 to
Defining Planned ACSs with no Stations
Changing Panels
To remove cartridges from rows on panels to facilitate hardware e.g., cabling changes
Renaming a CDS Copy
Using CDS Rename/Relocate/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
Allocation of Control Data Sets
Control Data Set Recovery Techniques
User Control of Control Data Sets
Dynamic Enable/Disable of Control Data Sets
4. Issue the command
62VM/HSC 6.0 System Programmer’s Guide
Command Functions
Figure 5. HSC Command Functions Overview
Viewing the Interior Components of an LSM
Controlling LSM Operating Mode
Controlling CAP Operating Mode
•A VIew request is sent to the controlling LMU
Chapter 2. Host Software Component Functions
Utility Functions
Figure 6. Utility Functions Overview
If the Standby LMU Fails
LMU Server Functions
Dual LMU Functionality
If the Master LMU Fails
HSC/LMU Software Combinations
LMU Switchover Messages
After an LMU Switch Occurs
Notes for the Example
Adding New Stations to an ACS
JCL to Add New Stations to an ACS
Reconstructing a LIBGEN
HSC Port Number Assignments
Recovery Maintenance Requirements
Dynamic LMU Connection
Multiple TCP/IP Stack Implications
TCP/IP to
Transitioning Between 3270 and TCP/IP
3270 to TCP/IP
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
Defining PARMLIB Control Statements
Overview
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
LKEYINFO
license-key-string
Examples
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
Example
Other Methods of Controlling Scratch Subpools
SCRPOol
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
TAPEREQ
TAPEREQ
Syntax
122VM/HSC 6.0 System Programmer’s Guide
Syntax continued
TAPEREQ
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
4490
subpool-name
TAPEREQ
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
UNITATTR Usage
UNITATTR
Unit Attribute UNITATTR Control Statement
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 Usage
Volume Attribute VOLATTR Control Statement
VOLATTR
144VM/HSC 6.0 System Programmer’s Guide
Disabling a VOLATTR Definition
VOLATTR
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
STK1RC34
use-limit
VOLATTR
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
COLD
RESET
SSYS
Both
RECONFIG
Member
Dialog
HSC Startup Job ACS SLKJCL
Example
Sample ACS SLKJCL File
SLSSYSXX
Description of /FILE Statement
Notes
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
Utility to Use
Selecting a Utility
Function
Restore or recreate the library CDS
Typical Use of Utilities
Utility Environmental Requirements
Control Statement Syntax Conventions
Utility Syntax Conventions
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
Parameters Controlling Report Headings
Reports Created by Utilities
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
196VM/HSC 6.0 System Programmer’s Guide
Activities Report
Usage Notes
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
Audit
Actions Permitted During an Audit
How the AUDIt Utility Functions
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
•the following data sets
Backup
Output Description
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
224VM/HSC 6.0 System Programmer’s Guide
Backup How to Restart Backup
Related Utilities
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
1st ed., 6/30/04 -
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
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
Output Description
Directory Rebuild JCL Example
JCL for Directory Rebuild
Syntax
Eject Cartridge Utility
Eject Cartridge
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
248VM/HSC 6.0 System Programmer’s Guide
Eject Cartridge Output Description
Figure 13. EJECt Cartridge Utility Sample Output
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
Output Description
Journal Offload JCL Example
JCL for Offload of Journals
1st ed., 6/30/04 -
Journal Offload
Figure 15. Journal Offload Utility Sample Output
256VM/HSC 6.0 System Programmer’s Guide
MOVe Considerations
Move Utility
Move
Utility Name
lsm-id
Move
Syntax
column-list
panel
Move
row-list
ACSUTIL SLKJCL File
Move JCL Requirements
Invoking the Move Utility
Output Description
Move Several Volumes From an LSM to Another LSM
Move JCL Examples
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
Reasons for Running the Reconfiguration Utility
Reconfiguration Utility
Reconfiguration
Reconfiguration
Considerations Before Running Reconfiguration
DASD Considerations in a VM-onlyEnvironment
268VM/HSC 6.0 System Programmer’s Guide
How the Reconfiguration Utility Functions
Reconfiguration
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
ACSUTIL SLKJCL File
Restore Invoking the Restore Utility
JCL Examples
280VM/HSC 6.0 System Programmer’s Guide
JCL for RESTore with Journals Applied
JCL for RESTore with GENerate Only
Restore
Output Description
JCL for RESTore Journals and Output to SLSAUDIT
Restore
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
How the Scratch Redistribution Utility Functions
Scratch Redistribution Utility
Scratch Redistribution
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
Chapter 4. Utility Functions
Set Syntax
Note: This syntax is continued on the next page
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
FREEZE
oldpswd
SET Freeze Panel
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
Syntax
Unselect Utility
Unselect
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
JCL Example
JCL to Produce a Volume Report
Volume Report
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
1st ed., 6/30/04 -
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 -
346VM/HSC 6.0 System Programmer’s Guide
SCP Messages
Messages
Abend Codes
HSC Messages
CCWTRACE
Software Trace Facilities
CP Trace Table
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
Interrupt Type
IUCV Interrupt Buffer
IPTYPE
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
1st ed., 6/30/04 -
Supervisor Call SVC Functions
370VM/HSC 6.0 System Programmer’s Guide
Function
Refer to Table
Decimal
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
=DEBUG
SCP Diagnostic Subsystem Commands
Enabling the Diagnostic Subsystem
fieldname
=NODEBUG
=DDICT
length
=HPER
epname
offset
epname
=WHERE
address
data-structure
HSC Diagnostic Commands
LIst Command
Syntax Parameters
address
DISPLAY Command
size
Control Data Set Recovery
CDS Recovery Capabilities
Dynamic Recovery of the Control Data Set
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
Type of Dumps Supported
How to Request a Dump
Dump Processing
Note Reason For Dump
What to do When a Dump Occurs
Call StorageTek Software Support
Move Problem Materials to Tape
Load Dump and CONSLOG Onto Disk
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 -
Subsystem Data Relationships
Diagnostic Techniques
SCP Task/Job 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 Request Block
Identify the Failing Routine
Find the Failing Task
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
Overview
Chapter 6. Performance Considerations
How Library Activity Affects Library Performance
How Operators Control Library Performance
Using the Activities Report Utility
Monitoring Library Activity and 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
418VM/HSC 6.0 System Programmer’s Guide
Functioning of Host-to-HostCommunications
Designation of Communication parameters
Limit View Time to Maintain High Performance
Define Secondary and Standby Control Data Sets
Advantages of Using the VIew Command
Excessive Use of VIew Command Affects Performance
How to Monitor Usage of 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
440VM/HSC 6.0 System Programmer’s Guide
SCRPOOL NAME=STD36,RANGEAAA000AAA999
ZZZ000ZZZ999
acs-id, lsm-id
MEDia, RECtech, and MODel Parameters
MODel, and RECtech parameters
acs-id, lsm-id
Mount
acs-id, lsm-id
VOLATTR
1st ed., 6/30/04 -
LIBGEN Macros
444VM/HSC 6.0 System Programmer’s Guide
SLIDRIVS macros
SLIACS macro
SLIALIST macro
SLIDLIST macro
1st ed., 6/30/04 -
SLILIBRY macro
446VM/HSC 6.0 System Programmer’s Guide
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
1st ed., 6/30/04 -
Volume Attribute VOLATTR control statement
454VM/HSC 6.0 System Programmer’s Guide
STK1RA STK1RA34 STK1RA35 STK1RB STK1RB34 STK1RB35
1st ed., 6/30/04 -
456VM/HSC 6.0 System Programmer’s 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
490VM/HSC 6.0 System Programmer’s Guide
Reply Command
SET Command
events
destination
STOPSCP Command
SLK Command
STArt Command
STOP Command
1st ed., 6/30/04 -
GCS Component Server Commands
SLKGCS Command
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
1st ed., 6/30/04 -
IUCV
496VM/HSC 6.0 System Programmer’s Guide
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
Appendix C. Record Formats
Cross Reference
SLSSVSTA
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
Appendix C. Record Formats
Cross Reference
LTYPAREA
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’
Appendix C. Record Formats
Cross Reference
LLG5ACS
SLSSLLG6
1... X’08’
SIGNED-FWORD
Appendix C. Record Formats
Cross Reference
LLG6ACS
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’
Appendix C. Record Formats
Cross Reference
HLG1FLG1
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’
Appendix C. Record Formats
Cross Reference
CFGCCPFX
SLUVHDAT
1.. .... X’40’
576VM/HSC 6.0 System Programmer’s Guide
Cross Reference
SLUVIDAT
CHARACTER
Appendix C. Record Formats
Cross Reference
CDSALL
SLUVSDAT
Appendix C. Record Formats
Cross Reference
STNACS
SLUVVDAT
CHAR CONST
CHARACTER
CHARACTER
X’20’
HEXSTRING
HEXSTRING
Appendix C. Record Formats
Cross Reference
VOLDEST
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
1st ed., 6/30/04 -
Permanent Motion Errors
604VM/HSC 6.0 System Programmer’s Guide
Description of Field
How Information is Logged
BYTE #
46-46
152-155
Description of Field
Motion Hard Fail Software Error Record
BYTE #
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
622VM/HSC 6.0 System Programmer’s Guide
Configuration
Figure 29. Configuration
Appendix E. Remote-linkedLibraries
Configuration
MVS/CSC
624VM/HSC 6.0 System Programmer’s Guide
Configuration
Figure 30. Configuration
Appendix E. Remote-linkedLibraries
Configuration
Figure 31. Configuration
626VM/HSC 6.0 System Programmer’s Guide
Configuration
Figure 32. Configuration
Control Data Set Integrity
Resolving CDS Issues After a Remote-LinkFailure
Programming and Operational Considerations
•Prior to reestablishing the link
Overview
QCDS Request
How QCDS Functions
Invoking QCDS SLSUREQ Macro
SLSUREQ VM Requirements
Addresses and Registers
VM Requirement
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
Records Returned
Output Description
Request Entered
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
Index
Index
Numerics
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