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