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
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
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 -
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
Command
Service Level Execution
Base
Full
Service Level Execution
Utility
Base
Full
Displaying/Setting Service Level
Starting the HSC Subsystem at Base 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
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
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
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 Exception Processing
Ejecting Cartridges from the Library
CAP Mode Considerations
Releasing an Allocated CAP
48VM/HSC 6.0 System Programmer’s Guide
Using Multiple CDS Copies
Near Continuous Operations
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
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
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
LMU Server Functions
Dual LMU Functionality
If the Master LMU Fails
If the Standby 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
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
Defining PARMLIB Control Statements
Overview
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
LKEYINFO
license-key-string
Examples
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
Example
Other Methods of Controlling Scratch Subpools
SCRPOol
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
TAPEREQ
TAPEREQ
Syntax
122VM/HSC 6.0 System Programmer’s Guide
Syntax continued
TAPEREQ
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
4490
subpool-name
TAPEREQ
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
UNITATTR Usage
UNITATTR
Unit Attribute UNITATTR Control Statement
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 Usage
Volume Attribute VOLATTR Control Statement
VOLATTR
144VM/HSC 6.0 System Programmer’s Guide
Disabling a VOLATTR Definition
VOLATTR
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
STK1RC34
use-limit
VOLATTR
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
COLD
RESET
SSYS
RECONFIG
Member
Dialog
Both
HSC Startup Job ACS SLKJCL
Sample ACS SLKJCL File
Example
SLSSYSXX
Description of /FILE Statement
Notes
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
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
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
Parameters Controlling Report Headings
Reports Created by Utilities
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
196VM/HSC 6.0 System Programmer’s Guide
Activities Report
Usage Notes
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
Audit
Actions Permitted During an Audit
How the AUDIt Utility Functions
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
•the following data sets
Backup
Output Description
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 -
224VM/HSC 6.0 System Programmer’s Guide
Backup How to Restart Backup
Related Utilities
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
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
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
Output Description
Directory Rebuild JCL Example
JCL for Directory Rebuild
Syntax
Eject Cartridge Utility
Eject Cartridge
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
248VM/HSC 6.0 System Programmer’s Guide
Eject Cartridge Output Description
Figure 13. EJECt Cartridge Utility Sample Output
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
Output Description
Journal Offload JCL Example
JCL for Offload of Journals
Journal Offload
Figure 15. Journal Offload Utility Sample Output
256VM/HSC 6.0 System Programmer’s Guide
1st ed., 6/30/04 -
MOVe Considerations
Move Utility
Move
lsm-id
Move
Syntax
Utility Name
panel
Move
row-list
column-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
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
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
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
ACSUTIL SLKJCL File
Restore Invoking the Restore Utility
JCL Examples
JCL for RESTore with Journals Applied
JCL for RESTore with GENerate Only
Restore
280VM/HSC 6.0 System Programmer’s Guide
Output Description
JCL for RESTore Journals and Output to SLSAUDIT
Restore
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
How the Scratch Redistribution Utility Functions
Scratch Redistribution Utility
Scratch Redistribution
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
Chapter 4. Utility Functions
Set Syntax
Note: This syntax is continued on the next page
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
FREEZE
oldpswd
SET Freeze Panel
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
Syntax
Unselect Utility
Unselect
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
JCL Example
JCL to Produce a Volume Report
Volume Report
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
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
346VM/HSC 6.0 System Programmer’s Guide
1st ed., 6/30/04 -
Messages
Abend Codes
HSC Messages
SCP Messages
CCWTRACE
Software Trace Facilities
CP Trace Table
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
Interrupt Type
IUCV Interrupt Buffer
IPTYPE
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
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
HSC TRACE Command
Format of HSC GTRACE USR Records
Diagnostic Commands
VM CP Commands
Setting Initialization Sequence Break-Points
SCP Debug Mode
offset
length
=DEBUG
SCP Diagnostic Subsystem Commands
Enabling the Diagnostic Subsystem
fieldname
=NODEBUG
=DDICT
=HPER
epname
offset
length
epname
=WHERE
address
HSC Diagnostic Commands
LIst Command
Syntax Parameters
data-structure
address
DISPLAY Command
size
Control Data Set Recovery
CDS Recovery Capabilities
Dynamic Recovery of the Control Data Set
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
Type of Dumps Supported
How to Request a Dump
Dump Processing
What to do When a Dump Occurs
Note Reason For Dump
Call StorageTek Software Support
Move Problem Materials to Tape
Load Dump and CONSLOG Onto Disk
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
Subsystem Data Relationships
Diagnostic Techniques
SCP Task/Job 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 Request Block
Identify the Failing Routine
Find the Failing Task
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
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
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
418VM/HSC 6.0 System Programmer’s Guide
Functioning of Host-to-HostCommunications
Designation of Communication parameters
Define Secondary and Standby Control Data Sets
Limit View Time to Maintain High Performance
Advantages of Using the VIew Command
Excessive Use of VIew Command Affects Performance
How to Monitor Usage of 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
440VM/HSC 6.0 System Programmer’s Guide
SCRPOOL NAME=STD36,RANGEAAA000AAA999
ZZZ000ZZZ999
MEDia, RECtech, and MODel Parameters
MODel, and RECtech parameters
acs-id, lsm-id
acs-id, lsm-id
Mount
VOLATTR
acs-id, lsm-id
1st ed., 6/30/04 -
LIBGEN Macros
444VM/HSC 6.0 System Programmer’s Guide
SLIACS macro
SLIALIST macro
SLIDLIST macro
SLIDRIVS macros
1st ed., 6/30/04 -
SLILIBRY macro
446VM/HSC 6.0 System Programmer’s Guide
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
1st ed., 6/30/04 -
Volume Attribute VOLATTR control statement
454VM/HSC 6.0 System Programmer’s Guide
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
490VM/HSC 6.0 System Programmer’s Guide
Reply Command
SET Command
destination
events
SLK Command
STArt Command
STOP Command
STOPSCP Command
1st ed., 6/30/04 -
GCS Component Server Commands
SLKGCS Command
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
1st ed., 6/30/04 -
IUCV
496VM/HSC 6.0 System Programmer’s Guide
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
Appendix C. Record Formats
Cross Reference
SLSSVSTA
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
Appendix C. Record Formats
Cross Reference
LTYPAREA
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’
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
Cross Reference
CHARACTER
SLSSPSWI
Cross Reference
556VM/HSC 6.0 System Programmer’s Guide
SLSSRL00
Cross Reference
SLSSRL01
Cross Reference
SLSSHLG1
1. .... X’20’
Appendix C. Record Formats
Cross Reference
HLG1FLG1
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’
Appendix C. Record Formats
Cross Reference
CFGCCPFX
SLUVHDAT
1.. .... X’40’
Cross Reference
576VM/HSC 6.0 System Programmer’s Guide
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
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
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
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 -
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
QCDS Request
How QCDS Functions
Invoking QCDS SLSUREQ Macro
Overview
SLSUREQ VM Requirements
Addresses and Registers
VM Requirement
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
Records Returned
Output Description
Request Entered
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 -
Index
Index
Numerics
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