background image

292   VM/HSC 6.0 System Programmer’s Guide

1st ed., 6/30/04 - 312579601

JCL Requirements 

The following definitions apply to Scratch Redistribution utility JCL: 

SLSPRINT 

output messages from the utility. 

SLSIN 

input to the utility in the form of control statement card images. 

Invoking the Scratch Redistribution Utility 

The easiest way to run utilities is to execute the ACS UTIL exec by entering the following 
command: 

EXEC ACS UTIL SCREDIST 

Execution of the statement results in the ACSUTIL SLKJCL file: 

ACSUTIL SLKJCL File

To execute the utility: 

 1. Delete the lines in the template that are not required, or leave the comment indicator 

(*) in column one. 

 2. Remove the comment indicator from the desired lines. 

 3. Specify values for the desired parameters. 

 4. Delete the parameters that are not desired. 

 5. Enter the command ‘‘FILE.’’ 

The job file is then submitted to the ACS service machine for execution. 

JCL Examples 

The following example shows JCL for redistributing scratch volumes within all LSMs in 
an ACS.

/JOB  jobname SLUADMIN 

/PARM MIXED 

/FILE SLSPRINT DEV PRNT CLASS A 

/FILE SLSIN    * 

* SCREDIST ACS(acsid) LSM(lsm

­

list) 

Scratch Redistribution

Summary of Contents for Host Software Component 6.0

Page 1: ...Host Software Component VM Implementation System Programmer s Guide Release 6 0 312579601...

Page 2: ...ted software program You are responsible for backing up your data You should be careful to ensure that your use of the information complies with all applicable laws rules and regulations of the jurisd...

Page 3: ...tivity iii Document Effectivity 1st ed 6 30 04 312579601 EC Number Date Doc Kit Number Type Effectivity 128976 June 2004 First Edition This document applies to the Host Software Component for VM VM HS...

Page 4: ...iv VM HSC 6 0 System Programmer s Guide 1st ed 6 30 04 312579601...

Page 5: ...m Overview 1 Host Software Component Overview 3 HSC Subsystem Components 4 HSC Architecture 4 VM Environment 6 Virtual Machine Configuration 9 HSC and Automated Cartridge System Interaction 10 Automat...

Page 6: ...Swapping Library Transports New Model Types 57 Common Recovery Functions 58 Control Data Set Recovery 58 Control Data Set Recovery Techniques 59 User Control of Control Data Sets 59 Command Functions...

Page 7: ...ontrol Statement 110 OPTion TITLE Control Statement 113 Scratch Subpool Definition SCRPDEF Command and Control Statement 115 Tape Request TAPEREQ Control Statement 118 Tape Request Definition TREQDEF...

Page 8: ...g Report Headings 183 Example 184 Stand Alone Utilities 185 Activities Report Utility 186 SLUACTV EXEC 186 Syntax 188 Utility Name 188 Parameters 188 Invoking the Activities Report Utility 190 Control...

Page 9: ...cription 228 Directory Rebuild Utility 236 Prerequisites 236 Reasons for Running the Directory Rebuild Utility 236 How the Directory Rebuild Utility Functions 236 Syntax 236 Utility Name 236 Parameter...

Page 10: ...n MVS 264 JCL Requirements 265 Reconfiguration Utility 266 Reasons for Running the Reconfiguration Utility 266 Considerations Before Running Reconfiguration 267 DASD Considerations in a VM only Enviro...

Page 11: ...tax 303 Utility Name 304 Parameters 304 JCL Requirements 316 Invoking the Set Utility 317 JCL Examples 318 Output Description 319 Unselect Utility 320 Syntax 320 Utility Name 321 Parameters 321 JCL Re...

Page 12: ...l Trace Table 374 HSC TRACE Command 376 Diagnostic Commands 377 VM CP Commands 377 SCP Debug Mode 377 Setting Initialization Sequence Break Points 377 SCP Diagnostic Subsystem Commands 379 HSC Diagnos...

Page 13: ...f the VIew Command 420 Advantages of Using the VIew Command 420 Loading Cartridges Into the Library 422 Loading Cartridges for Immediate Use in a Newly Installed LSM 422 Loading Cartridges for Later U...

Page 14: ...nt 449 OPTion control statement 450 Reconfiguration Definition RECDEF control statement 450 Scratch Subpool SCRPOol control statement 450 Scratch Subpool Definition SCRPDEF command and control stateme...

Page 15: ...DRAin CAP command 476 EJect command 476 ENter command 478 Journal command 478 MODify command 478 MONITOR command 478 Mount command 479 Mount Dismount Options MNTD command and control statement 480 MOV...

Page 16: ...ppendix B CP Commands and DIAGNOSE Codes 495 Overview 495 CP Commands 495 CP Programming Services 495 IUCV 496 Appendix C Record Formats 497 Overview 497 Mapping Macros for SMF Records 498 Mapping Mac...

Page 17: ...593 Batch API Mapping Macros 593 Batch API Record Formats 594 SLUVDDAT 594 SLUVPDAT 598 Appendix D Logging ACS Robotics Motion 603 Overview 603 Information Being Logged 603 Robotics Motion Start Coun...

Page 18: ...guration 2 623 Configuration 3 624 Configuration 4 625 Configuration 5 626 Programming and Operational Considerations 627 Appendix F Batch Application Program Interface API 629 Overview 629 QCDS Reque...

Page 19: ...Decompile Utility Sample Output 229 Figure 13 EJECt Cartridge Utility Sample Output 248 Figure 14 Enter Cartridge Utility Sample Output 252 Figure 15 Journal Offload Utility Sample Output 256 Figure 1...

Page 20: ...ata Relationships 404 Figure 28 Using LSMs as Scratch Loaders 428 Figure 29 Configuration 1 622 Figure 30 Configuration 3 624 Figure 31 Configuration 4 625 Figure 32 Configuration 5 626 Figure 33 Samp...

Page 21: ...Functions 170 Table 11 SLUADMIN Return Codes 182 Table 12 Label Descriptions for Devices in Output LIBGEN 228 Table 13 I O Requirements 269 Table 14 HSC State to Run SET Options 300 Table 15 SET Utili...

Page 22: ...SB Record Format 513 Table 40 SLSSMF07 Record Format 515 Table 41 SLSSMF08 Record Format 523 Table 42 Mapping Macros for LOGREC Records 525 Table 43 SLSSLHDR Record Format 526 Table 44 SLSSVLG1 Record...

Page 23: ...612 Table 70 LMU Response Codes 0201 thru 0203 613 Table 71 LMU Response Codes 0301 thru 0310 613 Table 72 LMU Response Codes 0401 thru 0427 614 Table 73 LMU Response Codes 0501 thru 0512 615 Table 74...

Page 24: ...xxiv VM HSC 6 0 System Programmer s Guide 1st ed 6 30 04 312579601...

Page 25: ...x B Library Configurations Operator s Guide Chapter 2 CAPPref DRAin EJect ENter MODify MOVe RELease CAP VIew commands Appendix B HSC Support of the SL8500 System Programmer s Guide Chapter 2 Mixing Me...

Page 26: ...anged to include a new flag value for the VOLFLAG2 field Under FOR ERRANT VOLUMES the following has been added VOLERMNT EQU X 02 VOLUME IS MOUNTED Mounted volumes now appear as errant and the VOLERACT...

Page 27: ...maintenance of HSC software involving the technical details should be familiar with the following software topics VM operating system ACF VTAM functions and principles VMFMERGE Organization of This Gu...

Page 28: ...ns record layouts for control data set records SMF records and LOGREC records Appendix D Logging ACS Robotics Motion contains information about logging library robot motions Included is the type of in...

Page 29: ...Operator s Guide Hardware Operator s Guide Requesting Help from Software Support Nearline Physical Planning Guide Physical Planning Guide Reader s Comments We would like to know what you think about t...

Page 30: ...xxx VM HSC 6 0 System Programmer s Guide 1st ed 6 30 04 312579601...

Page 31: ...odule LSM contains storage cells for tape cartridges The storage capacity of an LSM depends upon the LSM model There are several LSM models available Standard Model 4410 PowderHorn Model 9310 WolfCree...

Page 32: ...ge location for each cartridge is contained in the library control data sets maintained by the HSC Library Management Unit LMU controls the Library Storage Modules LSMs in the ACS The LMU interprets t...

Page 33: ...control Integrity of the control data set can be assured through the following techniques employed at an installation allocating secondary shadow and standby data sets in addition to the primary cont...

Page 34: ...omponents The server components provide physical control of system entities for the control components The server components consist of the data base server the LMU server the WTO component and the ad...

Page 35: ...STARTUP COMMAND S SLS HSC ADDRESS SPACE APPLICATIONS OPERATOR COMMANDS UTILITIES TMI COMMON SUBSYSTEM COMMANDS BATCH UTILITIES TAPE MANAGEMENT INTERFACE TMI COMMON MOUNT DISMOUNT CAP COMMON COMMON RE...

Page 36: ...equires relatively few system services The VM system services that are used are Spool files Inter User Communications Vehicle IUCV IUCV based services MSG and BLOCKIO Diagnose RSCS VMDUMP Storage Dump...

Page 37: ...and deallocating storage through standard macro calls Device Management This component has exclusive control over SCP driven I O activity to virtual devices IUCV is the interface to the DASD data sets...

Page 38: ...ts out the interrupt subtypes and a second level handler which does the bulk of the processing Timer services include the TOD clock the TOD clock comparator and the CPU timer Tracing includes an inter...

Page 39: ...the HSC and the user and provides allocation mount and scratch pool services The HSC provides the TMS with mount dismount service and assists it in allocation for those volumes and drives which are un...

Page 40: ...ismount requests are processed from the TMS and the library control data set is used to determine the location of the requested cartridge library controlled or nonlibrary The library control data set...

Page 41: ...ANDBY CONTROL DATA SET LSM CD TMS SERVICE MACHINE TMS REQUESTOR CMS NONLIBRARY TAPE DRIVE C27925 LMU VM HOST A LMU 3174 3274 TERMINAL CONTROL UNIT OPERATOR OPERATOR VM HOST B HSC SCP ACS SERVICE MACHI...

Page 42: ...e volume is to be mounted on a transport If all drives in an LSM are busy a cartridge can be moved to another LSM to satisfy the mount request This action is performed without operator intervention si...

Page 43: ...dge and the robot moves to the appropriate position PTP cell or transport The robot hand extends and the cartridge is positioned and released at its destination PTP cell or transport If the destinatio...

Page 44: ...T STANDBY CONTROL DATA SET JOURNALS HOST 1 HOST 2 HOST 3 HOST 16 3274 CONTROL UNIT 0 3274 CONTROL 7 LOCAL AREA NETWORK LOCAL AREA NETWORK STATIONS 1 16 STATIONS 1 16 LMU 0 LAN 0 LAN 0 LAN 1 LAN 1 LMU...

Page 45: ...trol data set is automatically updated to reflect the new location of the cartridge Dual LMU Environment In a dual LMU environment the HSC maintains contact with both LMUs Both LMUs are varied online...

Page 46: ...o allow you to manage library resources The utilities enable you to dynamically perform maintenance on control data sets control cartridge and scratch volume functions produce performance activity and...

Page 47: ...various tasks Commands perform such functions as assigning a preference to a specific cartridge access port CAP displaying system status such as control data set status ACS LSM and volume status enter...

Page 48: ...18 VM HSC 6 0 System Programmer s Guide 1st ed 6 30 04 312579601...

Page 49: ...page 5 include installation initialization termination mount dismount processing volume cell control CAP processing common recovery command utility LMU server communications tape management interface...

Page 50: ...tements operator commands Installation Functions Installation functions pertain to installation or reconfiguration processing for the HSC subsystem Since these topics are extensive they are presented...

Page 51: ...he lower level of functionality Full service level provides full functionality of the HSC Normally the HSC initializes to the full service level when started HSC can be started at the base service lev...

Page 52: ...the HSC builds data areas loads program modules and sets up the required operating system services to support the two service levels of operation Termination of the HSC including normal termination a...

Page 53: ...ISMount NO YES Display YES YES DRAin NO YES EJect NO YES ENter NO YES Journal YES YES LIst YES YES MNTD NO YES MODify F NO YES MONITOR MN YES YES Mount NO YES MOVe NO YES OPTion YES YES RECover NO YES...

Page 54: ...Base and Full Service Levels Utility Service Level Execution Base Full AUDIt NO YES BACKup YES YES EJECt NO YES ENTEr NO YES LIBGen YES YES MOVe NO YES OFFLoad YES YES REPLaceall YES YES RESTore NO NO...

Page 55: ...the subsystem at the base service level before your library hardware is physically installed Starting the HSC at the base service level allows you to perform many of the preliminary tasks involved in...

Page 56: ...e Processing When a job requests specific media type and recording technique the HSC uses information provided by TAPEREQ control statements to select a cartridge with the appropriate media type and i...

Page 57: ...TAPEREQ and VOLATTR control statements Parameter values associated with MEDia and RECtech and their hierarchy are shown in the following figure MEDIA TYPES RECORDING TECHNIQUES STK2 STK2P STK2W DD3A...

Page 58: ...ITATTR control statements do not use the RECtech parameter Table 3 shows the relationship between MODel and RECtech parameters Table 3 MODel RECtech Translation MODel Resulting RECtech 4480 18track 44...

Page 59: ...tatement Media type is provided by one VOLATTR statement and recording technique is provided by another VOLATTR statement Media type is provided by a VOLATTR statement and recording technique is provi...

Page 60: ...ements because scratch counts are determined entirely from VOLATTR information Accurately defined VOLATTR statements are critical for correct processing of nonspecific volume requests The HSC analyzes...

Page 61: ...ges of the requested media type or recording technique in the ACS there are no scratch cartridges of the requested media type or recording technique in the requested subpool in the ACS The message ide...

Page 62: ...and 36track Standard and LONGItud Standard and no recording technique specified Notes If the default VOLATTR specifies MEDia Standard RECtech 18track then scratch volumes defined as MEDia Standard an...

Page 63: ...l Statement in the HSC Operator s Guide for a description of these options Mount Processing for Specific Volumes The HSC determines when a library volume is to be mounted on a library controlled trans...

Page 64: ...tion accepts a list of volume serial numbers for addition to or deletion from the control data set s list of scratch volumes If desired the entire scratch list may be deleted by using the Scratch Upda...

Page 65: ...of situations in which this communication takes place The transport is in an ACS but the volume is not The HSC issues a WTOR The operator may reply that the mount request is to be ignored and the TMS...

Page 66: ...cess to the volume by simulating that the thumbwheel is in a read only state In this virtual thumbwheel mode the transport ignores the fact that the volume might be physically enabled for writing The...

Page 67: ...sport the following cleaning process is invoked prior to mounting the requested cartridge 1 The HSC selects a cleaning cartridge from the pool of cleaning cartridges in the LSM that contains the tape...

Page 68: ...onal information Notes 1 Any cartridges identified by the cleaning prefix are treated exclusively as cleaning cartridges they cannot be scratched or initialized by HSC utilities 2 Extra overhead can b...

Page 69: ...count is used to track the number of times a cleaning cartridge has been used Used cleaning cartridges which are reentered will be used more times than specified by the applicable MAXclean value Each...

Page 70: ...ted in the ACS until it finds a compatible cleaning cartridge If no compatible cleaning cartridges are found in the ACS the HSC prompts the operator to enter a cleaning cartridge or skip the clean pro...

Page 71: ...ng cartridges must be identified ejected from the ACS and replaced with new cleaning cartridges Use the Volume Report utility to identify over use cleaning cartridges Select the cleaning cartridges by...

Page 72: ...42 VM HSC 6 0 System Programmer s Guide 1st ed 6 30 04 312579601 solution This task can be used to initiate the clean process for all drives at a predetermined time...

Page 73: ...the capability to move volumes at your discretion Volume movement may be required because of changes in your library hardware configuration Addition of tape transports or LSMs to a library configurati...

Page 74: ...detailed information on how to implement scratch subpooling using the SCRPOol control statement The syntax for the SCRPOol PARMLIB control statement is also shown in Appendix A Macros Control Stateme...

Page 75: ...s available Thus a failure of this task could result in impairing any library processing relying on scratch volumes The HSC provides automatic recovery and reinstatement of this task if a failure occu...

Page 76: ...and eject operation is processed separately The user can run concurrent tasks against CAPs on a single LSM PCAPs are used for single cartridge enter and eject operations These are controlled by the u...

Page 77: ...mode CAPs especially if you enter many cartridges without external Tri Optic labels WTORs are issued by the host currently servicing the automatic mode CAP which may present an inconvenience if you ar...

Page 78: ...sages inform you of conditions and actions to take You are prompted by an initial message to confirm or terminate release of the specified CAP This confirmation prevents the release of a CAP that is c...

Page 79: ...System Programmer s Guide Configuration Mismatches on page 163 changing drive panel types without running a reconfiguration Refer to the HSC System Programmer s Guide SET Device Numbers for Drives on...

Page 80: ...reported to the HSC by the LMU If the LSM is defined in the CDS as a 4410 but it is actually a 9310 PowderHorn the LSM type is automatically updated in the CDS Thus an LSM upgrade from a 4410 to a 931...

Page 81: ...be added later define dummy host IDs now Entries for future hosts can be defined in the SLILIBRY macro HOSTID host0 host15 parameter For example host IDs of FREE1 FREE2 and FREE3 could be defined The...

Page 82: ...l type either using the SET SLIDRIVS utility to change between standard and wide drive panels or running the LIBGEN SLICREAT reconfiguration process to change other panel types Notes 1 StorageTek CSEs...

Page 83: ...rom being allocated on the frozen panel 2 Use the MOVe utility or the MOVe or EJect commands to move all cartridges off the panel rows being changed Because the panel has been frozen cartridges cannot...

Page 84: ...in the HSC Operator s Guide for a description of the keywords used to perform these operations Renaming Relocating a CDS Scenarios To rename and relocate a CDS copy only one copy of the CDS must be d...

Page 85: ...must modify CDSDEF control statements to keep them consistent with the active CDS Relocating an Uncataloged CDS Copy Assume that ACS DBASECPY has been disabled and deleted or uncataloged and ACS NOTCA...

Page 86: ...pand command to insure that the latest copy of the CDS is available in case of a failure during the expand operation The number of formatted blocks in the CDS remains constant for all copies of the CD...

Page 87: ...ace the tape transports 3 Run the SET SLIDRIVS utility to omit the device numbers being replaced It is only necessary to specify the device numbers being replaced not all device numbers on the panel E...

Page 88: ...is data set is strictly optional but also recommended Note The SLIRCVRY LIBGEN macro TCHNIQE parameter determines how many CDS copies will be initialized by the SLICREAT program and whether or not jou...

Page 89: ...ossible switch internal CDS directory rebuild standby CDS copy diagnostic information on CDS errors error detection and correction of the CDS through the BACKup and RESTore utilities the ability of th...

Page 90: ...tandby control data sets When HSC is initialized it assigns its control data set copies as primary secondary and standby based on the Database Heartbeat record not on the assignment in the CDSDEF PARM...

Page 91: ...p the control data set with the HSC BACKup utility 3 Restore the control data set with the HSC RESTore utility This will clear the control data set information in the Database Heartbeat record 4 Start...

Page 92: ...control processing CARTRIDGE CONTROL ALLOC MVS only DISMount Display Mount MOVe MNTD SCRPOol Warn LSM Display MODify VIew OPTion Viewtime LMU Display SWitch Vary CAP CAPPref Display DRAin EJect ENter...

Page 93: ...SC commands or utilities manual the user must issue HSC commands and utilities to use the CAP online the CAP is online to all hosts offline the CAP is offline to all hosts Refer to the HSC Operator s...

Page 94: ...robot hand is focused on the specified object Note If you respond to the message before the expiration of the requested time interval the VIew request is cancelled Refer to the OPTion command and the...

Page 95: ...ary and volume activity can be invoked using various HSC utilities Figure 7 illustrates the control concept provided by the various HSC utilities Refer to Chapter 4 Utility Functions on page 131 for d...

Page 96: ...e master LMU the master as part of its acknowledgment informs the HSC of the status of the standby The standby LMU is either ready or not ready The master LMU thinks that the standby is ready if the s...

Page 97: ...table indicates valid combinations Table 4 HSC LMU Validity Matrix HSC Version LMU Version Number of LMUs Powered Up Valid Combination Functionality Available 1 2 ECap SPE 3 2 1 Yes New HSC features a...

Page 98: ...tations must be specified not just the new ones 2 The second SET control statement defines the listed stations for all hosts Note All stations must be specified not just the new ones 3 The following a...

Page 99: ...BGEN The Database Decompile LIBGEN utility can be used to reconstruct a LIBGEN reflecting the true configuration of your HSC subsystem if for some reason your LIBGEN has been lost Refer to Database De...

Page 100: ...ing TCP IP communications configuring VM for TCP IP support Recovery Maintenance Requirements Two sets of PTFs must be applied to allow the recovery processes described in Recovering TCP IP Communicat...

Page 101: ...which when added to 50000 means that the HSC on HSTA uses port number 50001 the HSC on HSTB uses 50002 the HSC on HSTC uses 50003 and the HSC on HSTD uses 50004 Multiple TCP IP Stack Implications Whe...

Page 102: ...OFFline 2 Station addresses specified in the LIBGEN SLISTATN macro do not have to be removed for the HSC to communicate to the LMU using TCP IP 2 Load the LMUPDEF statements containing the LMUPATH par...

Page 103: ...it reestablishes communication to the LMU Note When 30 minutes is exceeded no further reconnection attempts are made and operator intervention is required In a dual LMU environment users can switch to...

Page 104: ...considered in an online state Issue the SWitch command to make the current standby LMU the new master LMU SWitch Acs acs_id The HSC redrives requests to the new master LMU Communication Lost to Standb...

Page 105: ...CP IP service machine System Profile File ACS SYSPROF Add the LMUPDEF command and control statement to the ACS SYSPROF file LMUPDEF vaddr DSN dsname VOL volser where vaddr is the virtual address of th...

Page 106: ...f OS formatted Minidisk and Allocation of CMS RESERVED Minidisk in the HSC Installation Guide for more information Commands to Format OS Minidisk EXEC SLIMDISK vaddr volser INIT EXEC SLIMDISK vaddr vo...

Page 107: ...he LMUPDEF data set using the ACS UTIL VOLCOPY command Note ACS UTIL VOLCOPY creates skeleton JCL that you modify to match your configuration JOB SLSXUTIL SLUGENER PARM RECCOPY FILE SYSPRINT DEV PRNT...

Page 108: ...osts control data set switch information CAP status information Types of Communications Services Communications services that are available fall into three categories Telecommunications access method...

Page 109: ...sts are defined For example the library is operating in an environment with three hosts Host 0 Host 1 and Host 2 The COMMPath command must be issued three times on each host The table of definitions f...

Page 110: ...a summary of current parameter settings for all hosts is displayed in a message If the HOSTid is specified as the current settings are displayed for the host from which the command is entered If the...

Page 111: ...volume s location in the LSM This information allows the TMS to determine whether the volume should be mounted on an automated or a manual drive The HSC returns a list of drives that are physically ac...

Page 112: ...information in batch mode The CDS specified as input to the request does not have to be active nor does it have to be referenced by the HSC address space the request executes in the user address spac...

Page 113: ...e operator command With these options it is not necessary to stop the HSC and restart it to initialize the new or changed options that you want to specify Those PARMLIB control statements that can be...

Page 114: ...d below Refer to Control Statement Syntax Conventions on page 439 for information on specifying control statements Note PARMLIB control statements that apply only to system programmer tasks are descri...

Page 115: ...mple statements Journal Data Set Definition In this control statement you specify the journal data set definitions Journal information is specified in the JRNDEF control statement Refer to Journal Def...

Page 116: ...Reconfiguration CDS Definition RECDEF Control Statement on page 98 for control statement syntax parameter information and example statements Scratch Subpool Control Warning If scratch pools are define...

Page 117: ...me where the specified CDS resides the unitname for the SVC99 parameter list for CDS allocation switch information controlling the enabling of a standby CDS Notes The number of CDS copies used by the...

Page 118: ...s based on last use which two are the correct copies to use during the initialization of the Control Data Set Services VOLx optionally volser is the volume serial number of the DASD volume where the s...

Page 119: ...ple of using the CDSDEF control statement Note Control statements can only be continued if PARMLIB begins with a comment statement see Control Statement Syntax Conventions on page 439 CDSDEF DSN1 SLS...

Page 120: ...7 for a description of the start procedure and how it relates to EXECParm Syntax Control Statement Name EXECParm initiates the control statement Parameters MSGPRFX optionally specifies control of whet...

Page 121: ...specifying the GTF format ID HOSTID optionally host id specifies the system ID associated with the request to process the EXECParm control statement Note If the hostid specified does not match the ho...

Page 122: ...tions In a multi host complex a separate JRNDEF statement is required for each host Refer to CDS Definition CDSDEF Control Statement on page 87 for information about defining CDS files Syntax Control...

Page 123: ...naling is discontinued the data contained in all journals and off loaded copies cannot be used for recovery purposes However by running the BACKup utility all journals are reset and journaling automat...

Page 124: ...the console without terminating the HSC Syntax Command Name LKEYDEF initiates the LKEYDEF command or control statement Parameter Descriptions DATASET or DSN Specifies the name of the data set contain...

Page 125: ...itted a unit name of SYSDA is the default HOSTID Optionally limits the execution of this command or control statement to the specified hosts host id Specifies the name of one or more hosts from which...

Page 126: ...entered exactly as received from StorageTek PRODuct Specifies the product and release to which the license key applies product identifier Indicates the product identifier For HSC 6 0 the product iden...

Page 127: ...ring as received from StorageTek license key string Indicates the license key string Examples In the following example the LKEYINFO control statement is used to input HSC license key information as re...

Page 128: ...trol statement Parameters DSNx dataset name is the name of a newly created HSC CDS At least one DSN parameter must be specified as many as two can be specified The first DSN becomes the primary CDS If...

Page 129: ...he following is an example of using the RECDEF control statement Note Control statements can only be continued if PARMLIB begins with a comment statement see Control Statement Syntax Conventions on pa...

Page 130: ...the same alphanumeric order by name as VMTAPE has them defined internally Syntax Control Statement Name SCRPOol control statement identifier Parameters Subpool information is defined in PARMLIB as ind...

Page 131: ...fied the HSC reads only the last RANGE setting it encounters and loads only that range All other ranges are ignored StorageTek recommends that you specify multiple ranges separated by commas on one SC...

Page 132: ...parameter ENter command specified with SCRatch parameter SCREdist utility with SUBpool and BALtol parameters EJect command with SCRTCH SUBpool parameters Mount command with SCRTCH SUBpool parameters...

Page 133: ...ds to dynamically load the data sets without stopping the HSC The LMUPDEF SCRPDEF TAPEREQ UNITATTR and VOLATTR statements contained in a definition data set are in effect only on the host that opens t...

Page 134: ...arameter statements reside see Scratch Subpool Control Statement SCRPDEF can be issued either in PARMLIB or as an operator command Refer to Scratch Subpool Definition SCRPDEF Command and Control State...

Page 135: ...specified by host name or LMU IP address Defining Tape Request Attributes TAPEREQ TAPEREQ statements describe the media type and recording technique to be used for a particular data set TAPEREQ param...

Page 136: ...ment on page 140 and Unit Attribute UNITATTR Control Statement on page 136 for descriptions of syntax and parameters Defining Volume Attributes VOLATTR VOLATTR statements describe the media type and r...

Page 137: ...PTion TITLE control statement places an identifying string in a definition data set to describe the contents of the data set See OPTion TITLE Control Statement on page 113 for descriptions of syntax a...

Page 138: ...play the LMUPDEF data set refer to Display LMUPDEF in the HSC Operator s Guide LMUPATH Usage LMUPATH statements define the TCP IP addresses used to communicate between an HSC on a host and the LMU for...

Page 139: ...control statement Each parameter entered must represent a different IP address lmu_hostname defines a host name for the TCP IP connection The host name can be up to 24 characters long The first chara...

Page 140: ...fect only on that host If different hosts use the same definition data set the LMUPATH parameter statements are shared by those hosts Notes 1 Users can find additional important TCP IP related informa...

Page 141: ...essage is issued and the statement is ignored dataset name specifies the name of the data set containing the LMUPATH address parameters If the data set name includes a member name dataset name must be...

Page 142: ...0018I is issued Optionally limits the execution of this control statement to the specified hosts If one of the specified hostids matches the host executing this control statement the control statement...

Page 143: ...ng can be displayed with HSC Display commands Refer to DISPLAY Command in the HSC Operator s Guide for descriptions of command syntax and parameters Syntax Control Statement Name OPTion initiates the...

Page 144: ...r s Guide 1st ed 6 30 04 312579601 Example The following example illustrates the use of the OPTion TITLE control statement Specify an Identifying String For a Definition Data Set OPTION TITLE SAMPLE I...

Page 145: ...e is to be modified for a given shift or application remember that the new definition remains in effect until another definition is loaded or the HSC is recycled The definition file then reverts to th...

Page 146: ...tements Only OPTion TITLE and SCRPOol statements are processed If any other statement is encountered an error message is issued and the statement is ignored dataset name specifies the name of the data...

Page 147: ...I is issued Optionally the HOSTid parameter limits the execution of this control statement to the specified hosts If one of the specified hostids matches the host executing this control statement the...

Page 148: ...ltiple matching TAPEREQ statements containing different parameters the HSC merges the parameters from the matching statements Each parameter value is searched for independently and for each the first...

Page 149: ...only TAPEREQ information The HSC searches the TAPEREQ statements for media type and recording technique values and uses these values to mark inappropriate transports ineligible for the request If the...

Page 150: ...atements to determine the media type and recording technique or model to assign to a request To disable all TAPEREQ definitions load a definition data set that contains only one TAPEREQ statement with...

Page 151: ...04 312579601 Syntax TAPEREQ JOBname jobname STEPname stepname PROGram PGMname program name program name DATASET DSN dataset name dataset name EXPDT RETPD retention period NE GT LT LE EQ GE expiration...

Page 152: ...2 STK2P RECtech LONGItud 18track 36track 36Atrack 36Btrack 36Ctrack HELical DD3 STK1R STK1R34 STK1R35 STK1RA STK1RA34 STK1RA35 STK1RB STK1RB34 STK1RB35 STK1RAB STK1RC STK1RC34 STK1RC35 STK2P STK2P34 S...

Page 153: ...or any single non blank character any character string length zero to 8 not to exceed one qualification level For example A B matches A B and A B C but does not match A B C D used only in DATASET Indi...

Page 154: ...data set name is not ABC Similarly if the DSN parameter refers back to a previous DD statement the data set name is resolved to the referred to data set Thus the data set referred to must be coded on...

Page 155: ...uest where a specific volume is specified Note TAPEREQ never overrides the actual media type of the specified volume if it is taken from the media label or VOLATTR Nonspec specifies that a nonspecific...

Page 156: ...any Standard ECART or ZCART cartridge Standard indicates a standard length 3480 cartridge It can be read on any longitudinal drives 4480 4490 9490 or 9490EE Data can be written in 36 track mode on 449...

Page 157: ...dges along with their associated media capacities are A 10GB B 25GB C 50GB Data capacity differences between DD3A DD3B and DD3C cartridges are related to the length of the tape in the cartridge not to...

Page 158: ...alue of the MEDia parameter on the first matching TAPEREQ Table 6 shows default values used if RECtech is omitted To avoid problems StorageTek recommends that all TAPEREQ statements specify MEDia and...

Page 159: ...or T9840B transport STK1R35 indicates a 3590 image 9840 or T9840B transport STK1RA indicates a 3490E or 3590 image 9840 transport STK1RA34 indicates a 3490E image 9840 transport STK1RA35 indicates a...

Page 160: ...PA35 indicates a 3590 image T9940A transport STK2PB indicates a T9940B transport STK2PB34 indicates a 3490E image T9940B transport STK2PB35 indicates a 3590 image T9940B transport MODel optionally spe...

Page 161: ...T9840B transport T9840B35 indicates a 3590 image T9840B transport T9840C indicates a 3490E image T9840C transport T9840C35 indicates a 3590 image T9840C transport T9940A indicates a 3490E image T9940A...

Page 162: ...t attributes Set Tape Request Attributes Note In the example above the last TAPEREQ statement specifies a user defined default for all data sets that do not match one of the first three statements TAP...

Page 163: ...definition is loaded or the HSC is recycled The definition file then reverts to the PARMLIB specification Thus TREQDEF can be used to temporarily change a definition file Definition commands issued on...

Page 164: ...re processed If any other statement is encountered an error message is issued and the statement is ignored dataset name specifies the name of the data set containing tape request parameters If the dat...

Page 165: ...is issued Optionally the HOSTid parameter limits the execution of this control statement to the specified hosts If one of the specified hostids matches the host executing this control statement the c...

Page 166: ...pe 4490 9490 9490EE SD 3 9840 T9840B T9840C T9940A T9940B 3590 type SD 3 9840 T9840B T9840C T9940A T9940B Note SD 3s 9840s T9840Bs T9840Cs T9940As and T9940Bs can be defined as either 3490E or 3590 34...

Page 167: ...this case the first UNITATTR statement specified for a unit is used Note The HSC does not allow duplicate or overlapping ranges of addresses to be processed If duplicates are encountered the HSC issu...

Page 168: ...ack Silverton tape transport 9490 indicates a 9490 36 track Timberline tape transport 9490EE indicates a 9490EE 36 track Timberline EE transport SD3 indicates an SD 3 RedWood tape transport 9840 indic...

Page 169: ...s if specified match those reported by the LMU If they do not all UNITATTRs are rejected NETHOST optionally indicates a parameter used by LibraryStation If this parameter is specified the HSC ignores...

Page 170: ...ocedure to remedy the mismatch If a definition file is changed by a UNITDEF operator command and if the change is to be permanent you must update PARMLIB before restarting the HSC If the definition fi...

Page 171: ...he name of the data set containing UNITATTR parameters If the dataset name includes a member name the entire dataset name must be enclosed in single quotes For example DATASET YOUR DSN MEMBER VOLume o...

Page 172: ...hostids matches the host executing this control statement the control statement is executed for that host Otherwise it is ignored If this parameter is omitted the control statement is executed on all...

Page 173: ...that are specified on that VOLATTR statement The search continues for any attributes that are not specified on the first matching VOLATTR statement These attributes are supplied by the next matching...

Page 174: ...K1R Then the global statement that follows specifies a global RECtech of 36track which is incompatible with the earlier statement VOLATTR SERIAL EAG000 EAG999 MEDIA STK1R VOLATTR SERIAL RECTECH 36TRAC...

Page 175: ...ed 6 30 04 312579601 Syntax This syntax diagram is continued on the next page VOLATTR SERial volser vol range vol list MEDia Standard CST MEDIA1 STD 1 3480 ECART E ECCST ETAPE Long MEDIA2 3490E ZCART...

Page 176: ...dges Note Standard cleaning cartridges that do not match the cleaning prefix established in the LIBGEN may be treated as scratch cartridges RECtech MAXclean use limit LONGItud 18track 36track 36Atrack...

Page 177: ...VOLATTR statement all volumes specified in a list or range must be the same media type e g a Standard cartridge cannot be included in a range of VOLSERs that also contains an ECART or DD3A cartridge 2...

Page 178: ...4480 4490 9490 or 9490EE Data can be written in 36 track mode on 4490 9490 or 9490EE transports but cannot be read on an 18 track 4480 drive Synonyms for this type of cartridge include CST MEDIA1 STD...

Page 179: ...ated media capacities are A 10GB B 25GB C 50GB D cleaning cartridge Data capacity differences between DD3A DD3B and DD3C cartridges are related to the length of the tape in the cartridge not to the re...

Page 180: ...9840 T9840B T9840C and T9940A T9940B media types If this parameter is not specified a default is chosen based on the value of the MEDia parameter Table 8 shows default values used if RECtech is omitt...

Page 181: ...3590 image 9840 or T9840B transport STK1RA indicates a 3490E or 3590 image 9840 transport STK1RA34 indicates a 3490E image 9840 transport STK1RA35 indicates a 3590 image 9840 transport STK1RB indicate...

Page 182: ...9940B transport STK2PB34 indicates a 3490E image T9940B transport STK2PB35 indicates a 3590 image T9940B transport MAXclean optionally specifies a maximum cleaning cartridge usage for the VOLSER or ra...

Page 183: ...bout recommended MAXCLEAN values for specific types of cleaning cartridges 2 In the example above the last VOLATTR statement specifies a user defined default for all volumes that do not match any of t...

Page 184: ...ange a definition file Definition commands issued on one host are in effect only on that host If different hosts use the same definition data set the volume attribute parameter statements are shared b...

Page 185: ...R statements are processed If any other statement is encountered an error message is issued and the statement is ignored dataset name is the name of the data set containing volume attribute parameters...

Page 186: ...18I is issued Optionally limits the execution of this control statement to the specified hosts If one of the specified hostids matches the host executing this control statement the control statement i...

Page 187: ...nd Fid parameters Also see HSC Initialization Parameters and HSCPARM in the HSC Installation Guide This section describes how to create the SLKJCL file A typical syntax for the PARM statement and full...

Page 188: ...hould be used only when absolutely necessary The installation instructions for some HSC maintenance may direct you to perform a COLD start Note You do not need to include the COLD parameter when you a...

Page 189: ...ential data set or PDS member or it may define the last FILE statement in the startup job specified as FILE SLSSYSxx M is the abbreviation for this parameter Dialog specifies that messages can be disp...

Page 190: ...atements and commands are to be specified in the startup SLKJCL file delete the first FILE SLSSYSxx statement Then do the following 1 Verify that the CDSDEF statement contains DSNx VOLx and UNITx valu...

Page 191: ...ON MNTD Dismount Auto Manual MNTD Scratch Auto Manual Set CAP preferences CAPPref prefvalue cap list Define control data sets CDSDEF DSN1 prm dsname VOL1 volunit1 UNIT1 unit1 DSN2 sec dsname VOL2 vol...

Page 192: ...t determined by the TCHNIQE parameter of the LIBGEN SLIRCVRY macro The HSC uses all of the CDS copies defined in the CDSDEF control statement whether this includes more or less CDS copies than are spe...

Page 193: ...sed HSC may be started prior to hardware arrival to ensure that it has been installed properly The HSC subsystem comes up with the LMU stations offline HSC operator commands may be entered but any fun...

Page 194: ...s online the mismatched configuration can be corrected If the hardware configuration is incorrect the affected ACS s can then be brought online Otherwise the configuration can be changed through the L...

Page 195: ...ted with the PARM statement in the HSC startup SLKJCL see Creating an SLKJCL File for Starting the HSC on page 157 can also be supplied via a PARM option with the ACS INIT command and the ACS SUBMIT c...

Page 196: ...full service level when it is started The syntax for the commands used to initialize the HSC to the full service level is shown below Syntax for Initializing HSC to Full Service Level AUTOLOG svmname...

Page 197: ...e BASE parameter can be used with other parameters on the PARM statement When the BASE parameter is specified in the startup SLKJCL the syntax to initialize the HSC to the base service level is the sa...

Page 198: ...168 VM HSC 6 0 System Programmer s Guide 1st ed 6 30 04 312579601...

Page 199: ...s submitted as batch jobs to the SCP require the use of special SCP JCL SLKJCL statements Specific utility functions are requested by special utility control statements which define the function and s...

Page 200: ...and optionally replace it with a new list Replace REPLaceall Delete a volume or volumes from the scratch list contained in the CDS UNSCratch or Replace REPLaceall Eject one or more cartridges from an...

Page 201: ...Restore or recreate the library CDS RESTore Set or change library configuration information including ACS esoteric CDS level cleaning prefix delete disposition device numbers for drives eject password...

Page 202: ...P environment The submitted file consists of SCP job control statements which define the files needed to run the SLUADMIN program and utility control statements which specify the desired utility funct...

Page 203: ...his syntax convention refer to Appendix A Macros Control Statements Utilities and Commands Syntax Reference on page 429 Utility Environmental Requirements Most of the utility functions require the HSC...

Page 204: ...all the utilities named in util list The valid values that may be entered in the util list are listed below and are also shown in the utility syntax examples provided throughout the remainder of this...

Page 205: ...y perform the following steps 1 Delete the lines in the template that are not required or leave the comment indicator in column one 2 Remove the comment indicator from the desired lines 3 Specify valu...

Page 206: ...sented all control statements are actually just comments If you decide not to execute the utility then enter the XEDIT command QUIT To execute the utility perform the following steps 1 Delete the line...

Page 207: ...file type is SLKJCL and the file must consist of fixed 80 column card image records composed of the following job control statements JOB jobname pgmname PARM parms COMM comments FILE fileopts Note Wit...

Page 208: ...It may be used only before or after FILE statements Note After a FILE ddname statement a COMM statement is interpreted as data comments comments of any format FILE Statement The FILE statement descri...

Page 209: ...JCL fmode the CMS filemode of the job file If omitted it defaults to class the job class desired If omitted it defaults to U Note These jobs must be submitted in job class L HSC startup HSCINIT SLSBIN...

Page 210: ...Commands Syntax Reference on page 429 Sample SCP Batch Job File JCL and Control Statements The ACS UTIL command used to create a template for invoking three utility functions first a Scratch Update u...

Page 211: ...is passed to the appropriate program which handles the actual processing Utility functions represented by additional control statements are not started until the prior utility function stops and contr...

Page 212: ...description of the error condition Refer to the HSC Messages and Codes Guide for any messages encountered Examples of utility program outputs including messages indicating the return codes are provid...

Page 213: ...output reports Parameter Description NOHDR Suppresses printing of report headings error messages still can be written to the report file This can be useful when running the Volume Report utility with...

Page 214: ...that all dates displayed in report detail lines are in the mm dd yy format A yy value of 71 or greater indicates a 20th century 19xx date A yy value of 70 or less indicates a 21st century 20xx date T...

Page 215: ...l Some utilities run stand alone in the sense that they perform no dialogues with other HSC components but they do require the VM Operating System to be available and some require the SCP to be runnin...

Page 216: ...y the library when running in the StorageTek SCP environment The Performance Log Reblocker SLUPERF utility must be run prior to executing the Activities Report utility Parameters are passed to the uti...

Page 217: ...type code may be retrieved SLSPRINT DISK fname ftype fmode or SLSPRINT PRINTER identifies the definition of the output file to be produced The output may either go to the named file or directly to a p...

Page 218: ...a yy value of 71 or greater to indicate a 20th century 19xx date Specify a yy value of 70 or less to indicate a 21st century 20xx date To avoid confusion you are encouraged to use the yyyymmdd date fo...

Page 219: ...specified end date must be in the same format Note When using the mm dd yy format specify a yy value of 71 or greater to indicate a 20th century 19xx date Specify a yy value of 70 or less to indicate...

Page 220: ...cing an Activities report beginning on December 2 1999 at noon Since the END parameter is not specified all activity up to the last record in the SLSSMF data set is reported This assumes that all SMF...

Page 221: ...e ignored The duration criteria are specified in the Activities Report utility syntax as input via the SLSIN parameters For the Move section of the Activities Report every move type is reported under...

Page 222: ...ibrary hardware existed which matched the requested duration criteria For dismounts this includes time for the transport to rewind and unload the cartridge For mounts this includes time the transport...

Page 223: ...orted mount and dismount times 4 Other LSM operations besides cartridge moves consume ACS resources e g CAP and audit scans probably take the next highest amount of LSM activity depending on frequency...

Page 224: ...rt output is based on an LMU interval In a single host environment the LMU interval is equivalent to the customer defined HSC SMF interval In a multi host environment the LMU interval for each host is...

Page 225: ...not configured A value of X percent indicates that the LSM is configured but no SMF records matched the duration criteria LSM arm motion is used for CAP and audit scans as well as general cartridge mo...

Page 226: ...s pass thru count 4 The ACS section of the Activities Report only processes the LMU statistics buffer data block SMF record subtype 4 LMU statistics buffer records contain information calculated and r...

Page 227: ...4 12 20040401 05 12 25 NONSCRATCH SAME LSM 345 100 19 9 SEC N A 20040301 11 54 12 20040401 05 12 25 DIFF LSM 0 0 N A 0 0 20040301 11 54 12 20040401 05 12 25 TOTAL OF ALL AVE TIME AVE PASS THRUS EARLIE...

Page 228: ...ell storage locations on a cell by cell basis across each specified LSM panel then proceeds on a panel by panel basis regardless of whether an entire LSM or an ACS is being audited Usually you invoke...

Page 229: ...label exists and the vision system cannot determine the media type Note CDS media information is updated when the volume external label is read by the robotic vision system and is transmitted back to...

Page 230: ...and cell information for the corresponding entries in the library control data set If the APPly YES parameter is specified the control data set is corrected to reflect the current contents of the insp...

Page 231: ...om the same or different systems are allowed and can usually improve the performance of the selective restrictive audits in different LSMs Concurrent audits are not recommended when duplicate volumes...

Page 232: ...specifies that a discrepancy listing is produced and the control data set is not updated ACS specifies that only a particular ACS in the library is to be audited acs id The one or two digit hexadecim...

Page 233: ...list is specified the elements must be separated by blanks or commas and the entire list enclosed in parentheses Refer to the appropriate ACS hardware document for information about LSM outer and inn...

Page 234: ...of panel 1 which contains only four usable cells rows 35 through 38 For 9740 LSMs valid row entries are 0 through 41 on panels 0 2 and 3 and 36 through 41 on panel 1 For SL8500 libraries valid row en...

Page 235: ...d is AA LL CC where AA is the ACS number hexadecimal 00 FF LL is the LSM number hexadecimal 00 17 and CC is the CAP number Allowable values for CC are 00 For 4410 and 9310 LSMs standard 21 cell CAP or...

Page 236: ...d placed new cartridges in empty cells or they need to correct cartridge location information for library volumes that have been manually moved to empty cells In either case if APPLy YES is specified...

Page 237: ...0 diagnostic cells cannot be scanned by an audit JCL Requirements The following definitions apply to Audit utility JCL SLSPRINT output messages from the utility program SLSIN input to the utility in t...

Page 238: ...APid where the cartridges are to be ejected is also specified JCL for Selective Audit 1 ACS 2 LSMs with CAPid The following example shows JCL for a selective audit specifying a panel list and producin...

Page 239: ...e audit processing messages indicating anomalies observed and or actions occurring during processing see Figure 10 on page 210 updated and validated library control data set with respect to the librar...

Page 240: ...LSMid 00 11 panel 6 has completed SLS0238I Audit scan for LSMid 00 11 panel 7 has completed SLS0238I Audit scan for LSMid 00 11 panel 8 has completed SLS0238I Audit scan for LSMid 00 11 panel 9 has c...

Page 241: ...set is optional It is a formatted control data set with only one valid record the Database Heartbeat DHB It is highly recommended that a standby control data set be created and initialized in your ins...

Page 242: ...performed Copy data sets are made for use as analysis data sets to limit the hardware reserve placed on the control data set to an absolute minimum Depending upon options selected analysis of data bl...

Page 243: ...ournaling is enabled all specified journals are reset when the backup is completed Note Up to 99 journals can be specified per run Finally the control data set is returned to a state where it can supp...

Page 244: ...a backup taken while the link is down After the link is restored ALL HSCs should remain down for backup restore Run BACKup OPTion Analyze must be used If you know which CDS has had the most processing...

Page 245: ...ndary CDS complete processing separately you may bypass the programmatic algorithm that normally determines the control data set to be backed up If you know which data set primary or secondary had the...

Page 246: ...current primary CDS on one side of the link while SLSCNTL2 should be specified as the current primary CDS on the other side of the link If you are sure which two CDSs should be compared do not specif...

Page 247: ...if a switch occurs and the standby data set is now active the CDSs can be reordered to maintain database integrity SLSCOPY1 the data set to which the primary control data set specified by the FILE SL...

Page 248: ...icator in column one 2 Remove the comment indicator from the desired lines 3 Specify values for the desired parameters 4 Delete the parameters that are not desired 5 Enter the command FILE The job fil...

Page 249: ...ckup is processed with journals If the FILE SLSCNTL2 statement is not provided a return code of four RC 4 is generated and a backup of the primary is taken JCL for Backup of Primary or Secondary CDS w...

Page 250: ...ith appropriate messages when syntax errors occur messages associated with backup processing Note These messages may include error conditions an Errant and In transit Location Report refer to Figure 1...

Page 251: ...tions 221 1st ed 6 30 04 312579601 a condition code from backup processing 0 no errors and no SLUADMIN control cards generated 4 warning MESSAGES Backup successful 8 a system failure occurred Restart...

Page 252: ...211I PROCESSING COMPLETE FOR THE DALM BLOCK SLS1210I PROCESSING HAS STARTED FOR THE LSM BLOCK SLS1211I PROCESSING COMPLETE FOR THE LSM BLOCK SLS1210I PROCESSING HAS STARTED FOR THE CAP BLOCK SLS1211I...

Page 253: ...FOR THE DES BLOCK SLS1210I PROCESSING HAS STARTED FOR THE FREE BLOCK SLS1211I PROCESSING COMPLETE FOR THE FREE BLOCK SLS1215I SLSCOPY1 WAS SUCCESSFULLY COPIED TO SLSBKUP SLUADMIN n n n STORAGETEK AUT...

Page 254: ...return code of eight RC 8 the BACKup utility can be restarted as long as criteria described in Parameters on page 214 for OPTion Restart is true Related Utilities The RESTore utility complements the...

Page 255: ...the LIBGEN from the existing control data set opens the existing control data set and an output data set to hold the recreated LIBGEN data set reads the control data set into buffers and determines v...

Page 256: ...Note SLSCNTL should be the copy of the CDS currently selected as the primary CDS Two ways to determine the identity of the primary CDS are issue the Display CDS command and look at PRIVOL run the BAC...

Page 257: ...indicator from the desired lines 3 Specify values for the desired parameters 4 Delete the parameters that are not desired 5 Enter the command FILE The job file is then submitted to the ACS service mac...

Page 258: ...line is displayed EJCTPAS messages associated with error conditions resulting from an unsuccessful execution of the utility Refer to Figure 12 on page 229 for an example of output from the utility Tab...

Page 259: ...LSM0006 LSM0007 LSM0008 LSM0009 LSM000A LSM000B X LSM000C LSM000D LSM000E LSM000F LSM0010 LSM0011 X LSM0012 LSM0013 LSM0014 LSM0015 LSM0016 LSM0017 ST000 SLISTATN ADDRESS 00CC LSM0000 SLILSM PASTHRU 8...

Page 260: ...D0000003 D0000003 D0000003 X D0000003 D0000003 D0000003 SLIDRIVS ADDRESS 0A0C 0A0D 0A0E 0A0F LSM00004 SLILSM PASTHRU 2 S 4 S 6 M 8 M X ADJACNT LSM0002 LSM0003 LSM0005 LSM0006 X DRIVE 10 X DRVELST P00...

Page 261: ...00007 D0000007 D0000007 X D0000007 D0000007 D0000007 SLIDRIVS ADDRESS 0A1C 0A1D 0A1E 0A1F LSM0008 SLILSM PASTHRU 2 S 4 S 6 M 8 M X ADJACNT LSM0006 LSM0007 LSM0009 LSM000A X DRIVE 10 X DRVELST P000008...

Page 262: ...B D000000B D000000B D000000B X D000000B D000000B D000000B SLIDRIVS ADDRESS 0A2C 0A2D 0A2E 0A2F LSM000C SLILSM PASTHRU 2 S 4 S 6 M 8 M X ADJACNT LSM000A LSM000B LSM000D LSM000E X DRIVE 10 X DRVELST P00...

Page 263: ...0000F D000000F D000000F X D000000F D000000F D000000F SLIDRIVS ADDRESS 0A3C 0A3D 0A3E 0A3F LSM0010 SLILSM PASTHRU 2 S 4 S 6 M 8 M X ADJACNT LSM000E LSM000F LSM0011 LSM0012 X DRIVE 10 X DRVELST P000010...

Page 264: ...3 D0000013 D0000013 D0000013 X D0000013 D0000013 D0000013 SLIDRIVS ADDRESS 0A4C 0A4D 0A4E 0A4F LSM0014 SLILSM PASTHRU 2 S 4 S 6 M 8 M X ADJACNT LSM0012 LSM0013 LSM0015 LSM0016 X DRIVE 10 X DRVELST P00...

Page 265: ...0000016 D0000016 D0000016 X D0000016 D0000016 D0000016 SLIDRIVS ADDRESS 0A58 0A59 0A5A 0A5B LSM0017 SLILSM PASTHRU 2 S 4 S X ADJACNT LSM0015 LSM0016 X DRIVE 10 X DRVELST P000017 X TYPE 9310 X DOOR ECA...

Page 266: ...ir a corrupted CDS database directory when the HSC is not active Normally the HSC corrects errors automatically How the Directory Rebuild Utility Functions The utility performs the following processin...

Page 267: ...entering the following command EXEC ACS UTIL DIRBLD Execution of the statement results in the ACSUTIL SLKJCL file ACSUTIL SLKJCL File To execute the utility 1 Delete the lines in the template that are...

Page 268: ...ludes a listing of input commands with appropriate messages when syntax errors occur messages associated with error conditions resulting from an unsuccessful attempt to execute DIRBLD processing an up...

Page 269: ...he highest priority CAP available for each ACS refer to the CAP Preference CAPPref Command and Control Statement in the HSC Operator s Guide You may elect to submit multiple EJECt Cartridge utility re...

Page 270: ...andard CST MEDIA1 STD 1 3480 ECART E ECCST ETAPE Long MEDIA2 3490E ZCART Z DD3A DD3B DD3C STK1R R STK2 RECtech 18track 36Atrack 36Btrack 36Ctrack DD3 STK1R STK1R34 STK1R35 STK1RA STK1RA34 STK1RA35 STK...

Page 271: ...dia type or recording technique within the same subpool subpool name subpool name indicates the name for the subpool VOLCNT optionally specifies that a designated number of scratch volumes are to be e...

Page 272: ...cates a helical cartridge The media indicator in the external label is encoded with the cartridge type A B or C Notes DD3A DD3B or DD3C can be abbreviated to A B or C respectively Types of helical car...

Page 273: ...on the media type if supplied If neither is supplied the next scratch cartridge is selected without taking media type and recording technique into consideration If both RECtech and MEDia are supplied...

Page 274: ...icates a 3490E image T9840B transport STK1RB35 indicates a 3590 image T9840B transport STK1RAB indicates a 3490E or 3590 image T9840A or T9840B transport STK1RAB4 indicates a 3490E image T9840A or T98...

Page 275: ...CAP Preference CAPPref Command and Control Statement in the HSC Operator s Guide If a CAP preference has not been specified the HSC displays a message and waits until the user enters a CAPPref value...

Page 276: ...g definitions apply to EJECt Cartridge utility JCL SLSPRINT output messages from the utility program SLSIN input to the utility in the form of control statements Invoking the Eject Cartridge Utility T...

Page 277: ...xample shows JCL for ejecting one standard scratch cartridge JCL to Eject One STD Scratch Cartridge The following example shows JCL for ejecting five SD 3 helical scratch cartridges JCL to Eject Five...

Page 278: ...te ejection processing a message indicating successful ejection processing see Figure 13 SLUADMIN n n n StorageTek Automated Cartridge System Utility PAGE 0001 TIME hh mm ss Control Card Image Listing...

Page 279: ...r you choose to inform the tape management system that the volumes are scratch volumes and or to eject the volumes Note The Enter Cartridges utility may not run concurrently with an Audit utility with...

Page 280: ...magazines 02 priority CAP PCAP for a 4410 or 9310 LSM enhanced CAP or for a 9360 LSM CAP SCRatch When SCRatch is specified it causes volumes to be put into scratch status JCL Requirements The followin...

Page 281: ...dge s into a CAP The volume s is placed into scratch status JCL for Entering Cartridges in a CAP Output Description Output resulting from the execution of the Enter Cartridges utility includes a listi...

Page 282: ...y PAGE 0002 TIME hh mm ss Enter Cartridges Utility DATE yyyy mm dd SLS0211I Volume C83040 successfully entered into library SLS0211I Volume C84181 successfully entered into library SLS0211I Volume C84...

Page 283: ...is to be performed Parameters None JCL Requirements The following definitions apply to the Journal Offload utility program JCL SLSPRINT the message output data set SYSPRINT SLUOFFLD message output SL...

Page 284: ...of the statement results in the ACSUTIL SLKJCL file ACSUTIL SLKJCL File To execute the utility 1 Delete the lines in the template that are not required or leave the comment indicator in column one 2...

Page 285: ...reset messages associated with error conditions resulting from an unsuccessful attempt to execute the Journal Offload utility a condition code indicating successful or unsuccessful completion of the...

Page 286: ...mm ss Journal Offload Utility DATE yyyy mm dd SLS0282I Journal at DDname SLSJRN01 successfully offloaded to data set defined by SLSOFF01 DD statement SLS0282I Journal at DDname SLSJRN02 successfully...

Page 287: ...ptionally the specific panel within the target LSM may also be specified Cartridges may be moved from one panel to another panel within the same LSM but cartridges may not be moved from one location t...

Page 288: ...on Panel panel number to be moved from This parameter has a corequisite of the Flsm parameter and is required An entire panel can be emptied if the Row and Column parameters are not specified panel li...

Page 289: ...t for information about LSM panel row and column locations and layouts Volume volumes to be moved vol list A list of volumes a maximum of 100 can be specified or a range of volumes If you specify the...

Page 290: ...he ACSUTIL SLKJCL file ACSUTIL SLKJCL File To execute the utility 1 Delete the lines in the template that are not required or leave the comment indicator in column one 2 Remove the comment indicator f...

Page 291: ...tion of the MOVe utility include a listing of input commands with appropriate messages when syntax errors occur messages associated with error conditions resulting from an unsuccessful attempt to exec...

Page 292: ...o location 00 11 02 00 09 SLS1950I Volume X00562 moved from location 00 04 00 00 03 to location 00 11 03 00 09 SLS1950I Volume X00546 moved from location 00 04 00 00 04 to location 00 11 04 00 09 SLS1...

Page 293: ...a VM punch spool file and passes reblocking information with each segment The CMS version takes SCP performance log output without any header trailer data and reads it into a CMS file without alterin...

Page 294: ...2 Enter the command FILE Invoking the Performance Log Reblocker Utility in MVS To invoke the Performance Log Reblocker utility in MVS certain steps must occur on VM 1 The PERFJCL system profile SYSPRO...

Page 295: ...he MVS system 3 The SMF parameters must be specified by the SCP SET PERFLOG command which is normally included within the SYSPROF file Refer to the SCP command descriptions found in Chapter 2 Commands...

Page 296: ...ssary to make final corrections to the CDS contents for panels that may have changed as a result of hardware configurations such as the addition of drive panels The Reconfiguration utility executes as...

Page 297: ...VS host run the reconfiguration from the MVS host Refer to HSC System Programmer s Guide for instructions Make sure you are familiar with VM fundamentals and configuring DASD in a VM environment Make...

Page 298: ...the panel on the old CDS is frozen If the panel types do not match on the old and new CDS the panel is frozen only if the panel on the new CDS is frozen The Reconfiguration utility is executed as an S...

Page 299: ...l step of reconfiguration copies the new primary to the new secondary The quantities shown above represent most of the I O done by reconfiguration Depending on the ratio of cells to volumes and nonscr...

Page 300: ...SSD data set Warning Do not include CDSDEF or RECDEF statements in the PARMLIB control statements If included they override the statements for the SSD 2 Perform the reconfiguration using the SSD data...

Page 301: ...ed to be rotated into a different sequence use the procedure described under Reassigning Control Data Set Names in Database Heartbeat Record on page 60 6 Stop execution of the HSC on all hosts except...

Page 302: ...following parameters Comment out any AUTOJOB statements LIBGEN file name of the LIBGEN load module SLSCNTL DSN of the new primary control data set for SLICREAT Comment out the old statement to use la...

Page 303: ...Issue the following command to create a new production startup job file EXEC ACS UTIL HSCINIT NOSEND j Verify that the information is correct and file the job Modify the data set volume and unit infor...

Page 304: ...ing command ERASE ACS SYSPROF A t Issue the following command to submit the RECONFIG job created earlier EXEC ACS SUBMIT RECONFIG SLKJCL The reconfiguration job starts the HSC and copies status inform...

Page 305: ...ny startup files SYSPROF STARTUP JCL and or PROCs for other hosts to reflect the new configuration Notes The MDISK links for other hosts may also need to be changed depending on your configuration 20...

Page 306: ...ormation about enabling journaling Notes The HSC BACKup and RESTore utilities can be used as part of a procedure to rename control data sets Refer to Reassigning Control Data Set Names in Database Hea...

Page 307: ...S Copies Are Split Among Hosts After an Error on page 213 for more information Syntax Utility Name RESTore specifies that the restore operation is to be performed Parameters APPly optionally specifies...

Page 308: ...k updated optional SLSJRNnn if journaling is enabled statements that define all journals since the last backup There are two journals per host and up to 16 hosts The possibility exists that the journa...

Page 309: ...he job file is then submitted to the ACS service machine for execution JCL Examples Various examples showing JCL for running the RESTore utility are presented Select the appropriate example matching t...

Page 310: ...SLUADMIN PARM MIXED FILE SLSBKUP DEV vaddr DSN backup set name FILE SLSCNTL DEV vaddr DSN primary set name FILE SLSCNTL2 DEV vaddr DSN secondary set name FILE SLSSTBY DEV vaddr DSN standby set name FI...

Page 311: ...riate messages when syntax errors occur messages associated with error conditions resulting from an unsuccessful attempt to execute RESTore processing a condition code indicating successful unsuccessf...

Page 312: ...ully restored from SLSCNTL SLS1219I SLSSTBY data set was successfully restored from SLSCNTL SLUADMIN n n n StorageTek Automated Cartridge System Utility PAGE 0003 TIME hh mm ss Restore Utility DATE yy...

Page 313: ...eriodically During this operation discrepancy blocks are generated within the SLSBKUP data set Then during the restore process the discrepant records are formatted into control card statements and out...

Page 314: ...ing a mix of LSMs 4410s 9310s 9360s 9740s is performed based on a percentage of scratch cartridges in the ACS That is the utility causes each LSM to have the same percentage of scratch tapes within th...

Page 315: ...tud Standard CST MEDIA1 STD 1 3480 ECART E ECCST ETAPE Long MEDIA2 3490E ZCART Z HELical DD3 DD3A DD3B DD3C STK1 STK1R R LONGItud 18track 36track 36Atrack 36Btrack 36Ctrack RECtech MEDia HELical DD3 S...

Page 316: ...tolerance value Scratch volumes are distributed based on this specified value tolerance value tolerance value specifies a percent value that identifies when cartridge redistribution ends Valid values...

Page 317: ...BALtol range where BALtol range range of balance tolerance value expnumlsm expected number of scratches for each LSM see above baltol user supplied percent value tolerance value that specifies when sc...

Page 318: ...It can be used only on a 36 track drive 4490 9490 or 9490EE Synonyms include E ECCST ETAPE Long MEDIA2 3490E ZCART indicates a 3490E extended capacity cartridge that provides greater storage capacity...

Page 319: ...media indicator in the external label is encoded with the cartridge type P Note STK2P can be abbreviated to P T9940 cartridge media capacities are 60GB T9940A or 200GB T9940B RECtech optionally speci...

Page 320: ...s a 3490E image 9840 transport STK1RA35 indicates a 3590 image 9840 transport STK1RB indicates a 3490E or 3590 image T9840B transport STK1RB34 indicates a 3490E image T9840B transport STK1RB35 indicat...

Page 321: ...tes a T9940A transport STK2PA34 indicates a 3490E image T9940A transport STK2PA35 indicates a 3590 image T9940A transport STK2PB indicates a T9940B transport STK2PB34 indicates a 3490E image T9940B tr...

Page 322: ...nt results in the ACSUTIL SLKJCL file ACSUTIL SLKJCL File To execute the utility 1 Delete the lines in the template that are not required or leave the comment indicator in column one 2 Remove the comm...

Page 323: ...shows JCL for redistributing helical DD3A 10GB scratch volumes within LSM 01 in ACS 01 JCL to Perform Scratch Redistribution JOB jobname SLUADMIN PARM MIXED FILE SLSPRINT DEV PRNT CLASS A FILE SLSIN S...

Page 324: ...scratch volumes across LSMs in an ACS see Figure 18 SLUADMIN n n n StorageTek Automated Cartridge System Utility PAGE 0001 TIME hh mm ss Control Card Image Listing DATE yyyy mm dd SCREDIST ACS 00 LSM...

Page 325: ...scratch list s in the library control data set When using the Replace utility additions to the scratch list s are made after an initial clearing of the scratch list s StorageTek customers are respons...

Page 326: ...efinitions apply to the Scratch Update utilities JCL SLSPRINT output from the utility program SLSIN input to the utility in the form of control cards Invoking the Scratch Update Utilities The easiest...

Page 327: ...n the control data set JCL to Scratch Unscratch and Replace Output Description Output resulting from the execution of the Scratch Update utilities includes a listing of input commands with appropriate...

Page 328: ...mm dd SCRATCH VOL 102412 102414 SLUADMIN n n n StorageTek Automated Cartridge System Utility PAGE 0002 TIME hh mm ss Scratch Update DATE yyyy mm dd SLS0167I Volume 102412 successfully added to librar...

Page 329: ...own and then reactivated Exceptions include SET FREEZE ON OFf where frozen or unfrozen panels are recognized immediately by all active HSCs SET NEWHOST newhost where the new host will be ready to be b...

Page 330: ...efined RESERVE QNAME is being changed The SET utility issues two RESERVEs against the CDS prior to an update consisting of A RESERVE with the StorageTek defined QNAME STKENQNM A RESERVE using the exis...

Page 331: ...should be performed Otherwise a restore removes the changes made and the SET utility must be rerun This utility does not in any way change the LIBGEN macros and does not update the journals Either ma...

Page 332: ...page 307 EJCTPAS SET Eject Password on page 307 FREEZE SET Freeze Panel on page 308 HOSTID SET Host ID on page 404 HSCLEVEL SET HSC Level on page 309 MAJNAME SET ENQ DEQ RESERVE QNAME on page 310 NEWH...

Page 333: ...esoteric FORACS acs id FORHOST host id CLNPRFX prefix COMPRFX cmdhex DELDISP SCRTCH NOSCRTCH HOSTID newhost FORHOST oldhost HSCLEVEL OFF FORHOST host id MAJNAME qname FREEZE ON OFf FORLSMID lsm id FOR...

Page 334: ...he relevant HSC s are recycled Note The ACSDRV parameter has no effect in the operation of the VM HSC The utility may still be used to set this parameter for MVS systems sharing this CDS esoteric spec...

Page 335: ...this procedure to change a cleaning cartridge prefix 1 Eject all cleaning cartridges from all ACSs The HSC records information about cleaning cartridges in the CDS 2 Terminate the HSC on all hosts 3...

Page 336: ...f Command Prefix Codes to Characters Hex Character Description 40 null blank 4A cent 4B period 4C less than 4D left parenthesis 4E plus 4F vertical bar 50 ampersand 5A exclamation point 5B dollar sign...

Page 337: ...word EJCTPAS specifies that the eject password is to be set HSCs that were brought up before using this function still use the old password HSCs that are brought up after the function use the new pass...

Page 338: ...ions on a panel as a result of a MOVe command utility or PGMI request cartridge entry into the ACS f float scratch dismount or scratch redistribution processing If a cartridge on a frozen panel is sel...

Page 339: ...See SET HSC Level on page 309 for information about resetting operating flags Note You must delimit the HOSTID newhost or oldhost with quotes when this ID is in lower case such as Cray station users S...

Page 340: ...exceed the maximum limitation of 16 hosts newhost specifies a 1 to 8 character host ID which also serves as the SMF system ID for JES2 or the main processor name for JES3 newhost cannot already be def...

Page 341: ...he scratch update utility should be run to update the scratch pools after using this function SL specifies that nonspecific requests for standard labeled tapes are to be automated AL specifies that no...

Page 342: ...all cartridges to other panels or LSMs If a panel type is changed by SET SLIDRIVS the new panel will not be frozen Frozen panels whose panel type did not change remain frozen after SET SLIDRIVS 5 HSC...

Page 343: ...ve device numbers are set If omitted the device numbers for all hosts are changed Note The number of drive positions for a specific host must equal the number of drive positions defined globally issui...

Page 344: ...ed ACS will come up SET LMU Station Address Numbers SLISTATN specifies that the LMU station addresses are to be set The change does not take effect until the affected HSC s is recycled An affected HSC...

Page 345: ...t utility produces incorrect results This is because some HSCs are writing records with the old SMF record type and some with the new record type libtype specifies the SMF record type The range is fro...

Page 346: ...d available for recovery purposes SET TCHNIQE PROCEDURE Use the following procedure to invoke the TCHNIQE utility and to set the appropriate recovery technique value 1 ALLOCATE based on existing CDS d...

Page 347: ...Set Utility The easiest way to run utilities is to execute the ACS UTIL exec by entering the following command EXEC ACS UTIL SET Execution of the statement results in the ACSUTIL SLKJCL file ACSUTIL...

Page 348: ...that makes these modifications changes the host ID from HSCB to HSC2 sets the library station device numbers to 0CD and 0DD for ACS 00 on host HSC2 changes the nonlibrary drive esoteric to CTAPE for...

Page 349: ...messages when syntax errors occur messages associated with error conditions resulting from an unsuccessful attempt to execute SET processing an updated CDS with the changed parameters a condition cod...

Page 350: ...nformation about the Display and DISMount commands refer to DISPLAY Command and DISMOUNT Command in the HSC Operator s Guide The HSC must be running on the same host that is running the UNSElect utili...

Page 351: ...CL SLSPRINT output messages from the utility program SLSIN input to the utility in the form of control cards Invoking the Unselect Utility The easiest way to run utilities is to execute the ACS UTIL e...

Page 352: ...e UNSElect utility includes a listing of input commands with appropriate messages when syntax errors occur messages associated with error conditions resulting from an unsuccessful attempt to execute U...

Page 353: ...Automated Cartridge System Utility PAGE 0001 TIME hh mm ss Control Card Image Listing DATE yyyy mm dd UNSELECT VOL BWX119 SLS0376I Volume BWX119 is now unselected owning host was HSC1 SLS0155I Conditi...

Page 354: ...re inserted into the library control data set last date volumes were selected Sorting may be done in ascending or descending order The report sorted by volume serial number is useful when a listing of...

Page 355: ...alue will include all recording techniques that the reported MEDia value allows e g if the media value is Standard and the recording technique value defaults to LONGItud then 18track 36track 36Atrack...

Page 356: ...TTR statement s add an external media label to cartridges that are not Standard mount the cartridges enter the cartridges through the CAP run an audit Note If an external label is not provided for all...

Page 357: ...filtering are not available If the utility is running under CMS however it is fully functional VOLRpt ACS acs id LSM lsm list VOLser volser vol range vol list VOLume volser vol range vol list SORT LO...

Page 358: ...VOLSERs volser or vol range or vol list volser vol range and vol list indicate the volume serial numbers requested Any subranges of volumes specified in the vol list that are not in the control data s...

Page 359: ...report sorted by date inserted in the control data set and then for each date sorted by select count SORT is mutually exclusive with NOSORT Note SORT is not available if Volume Report is running under...

Page 360: ...are applied before negative attributes for example SCR is applied before NONSCR 4 INCLude is not available if Volume Report is running under SCP indicates that all volumes in the library are consider...

Page 361: ...NCLude values except for the parameter see the INCLude options list above As an example EXCL NONSEL excludes nonselected volumes from the report Notes 1 INCLude parameters are applied before EXCLude p...

Page 362: ...on an LSM and ACS basis and or subpool data on an ACS or LSM basis Totals are affected by the use of limiting parameters such as ACS and possibly LSM VOLser VOLume and INCLude and or EXCLude If both...

Page 363: ...Volume Report parameter file SLSPRINT output messages and report from the utility A message is displayed detailing the data set names being used to produce the report SLSIN input to the utility in th...

Page 364: ...NT For SCP FILE SLSPRINT DEV PRNT CLASS C For CMS SLSPRINT PRINTER DISK fn ft fm Table 18 SLSVA Effect on Volume Report HSC State SLSVA Specified SLSVA Not Specified Active Use VOLATTRs pointed to by...

Page 365: ...sk SLSIN For SCP FILE SLSIN For CMS SLSIN keywords where keywords Volume Report utility keywords Note Input under CMS is restricted to one line only and does not contain the VOLRpt utility indicator U...

Page 366: ...R statements PARM Parameters to pass to the SLUADMIN program For SCP PARM parameters For CMS PARM parameters where parameters any parameters acceptable to the SLUADMIN program JOB SCP only Specifies t...

Page 367: ...eter File A parameter file for the Volume Report running under CMS contains statements similar to those used to execute the utility under SCP An example of a parameter file follows PARM MIXED SLSCDATA...

Page 368: ...mple The following example shows JCL to produce a Volume Report for several LSMs JCL to Produce a Volume Report The optional parameter NOHDR suppresses page headings on the volume report JCL to Produc...

Page 369: ...rted for each volume Media and Recording Technique Origin The media and recording technique are derived from the media type reported by the LMU recorded in the VAR and the applicable VOLATTR statement...

Page 370: ...cratch Scr or Selected Sel headings indicates that the volume is currently in that status A volume in Errant Err status shows the volume s home cell in the Cell Loc column Under the Selected heading a...

Page 371: ...istribution or any update to its scratch status Note The count is valid only for the time that the volume exists in a CDS Totals Reports Two totals reports can be produced Volume Report Totals Subpool...

Page 372: ...specified output data set one volume per record The CDSDATA parameter creates a non volume CDS flat file The following SMP E distributed macros define the non volume information SLUVADAT flat file AC...

Page 373: ...00 03 30 02 R Default 20040216 12 57 06 20040216 13 05 56 3 CLN410 DD3D DD3 01 00 00 15 03 R M Default 20040216 12 57 08 20040216 13 05 58 3 CLN411 DD3D DD3 01 00 02 16 00 R M Default 20040216 12 57...

Page 374: ...10 33 08 100 EE0008 ZCART 36CTRACK 02 00 01 39 01 Y R SUB1 20040214 09 40 07 20040218 10 33 08 45 EE0009 ZCART 36CTRACK 02 00 00 02 00 M R SUB1 20040214 09 40 19 20040221 16 34 17 676 EE0010 ZCART 36...

Page 375: ...POOL ID LABEL TYPE RANGE LIMITS SUB1 SL N A N A NON ACS LSM SCRATCH SCRATCH Media Rectech 00 00 00 0 0 _______ _______ ACS Total 0 0 01 00 10 5 1 ZCART 36CTRACK 00 10 0 0 _______ _______ ACS Total 5 1...

Page 376: ...346 VM HSC 6 0 System Programmer s Guide 1st ed 6 30 04 312579601...

Page 377: ...rocessing Major SCP data relationships Messages HSC Messages Messages with the prefixes SLSxxxxs are emitted by the HSC and are documented in the HSC Messages and Codes Guide SCP Messages Messages wit...

Page 378: ...all SVC functions SCP GTRACE emulation HSC internal trace table HSC TRace command CP Trace Table The CP component of VM has its own internal trace table For the VM SP VM SP HPO and VM ESA 370 feature...

Page 379: ...be any HSC event tracing TRACE Command Syntax For a detailed description of how to use the TRACE command refer to the HSC Operator s Guide SCP Internal Trace Table The SCP internal trace table is comp...

Page 380: ...n the SCP internal trace table Instead USR events generated by the HSC are recorded in the HSC internal trace table The TTE contains common information about every event and some data specific to each...

Page 381: ...WORD3 S device address IOB address CAW Reserved I O Trace Entry event type event code TTEWORD1 TTEWORD2 TTEWORD3 I device address IOB address CSW bytes 0 3 CSW bytes 4 7 SVC Trace Entry event type eve...

Page 382: ...nused unused external interrupt subtype CLKC TTEWORD1 TTEWORD2 TTEWORD3 unused clock comparator value bytes 0 3 clock comparator value bytes 4 7 external interrupt subtype CPUT TTEWORD1 TTEWORD2 TTEWO...

Page 383: ...in storage The IPARML is also used to map the IUCV external interrupt buffer that is filled in at the time an IUCV external interrupt occurs It contains information describing the event that just occ...

Page 384: ...lags 1 IPRCODE IPMSGLIM xx xx x 08 IPVMID BLOCKIO x 10 Block size Block Offset x 18 Vdevaddr xx xx xx xx xx xx x 20 Buffer Length xx xx xx xx Inputs IPVMID userid to connect to BLOCKIO Block size Bloc...

Page 385: ...PTRGCLS target class IPRMMSG1 block number 1 write 2 read x 10 IPRMMSG2 bufffer address xx xx xx xx x 18 xx xx xx xx xx xx xx xx x 20 xx xx xx xx xx xx xx xx Inputs IPPATHID IPTRGCLS IPFLAGS1 Block nu...

Page 386: ...length xx xx xx xx x 18 xx xx xx xx xx xx xx xx x 20 IPBFLN2F reply length xx xx xx xx Inputs IPPATHID IPTRGCLS IPFLAGS1 IPBFRADR1 IPBFLN1F IUCV path id target class flags data buffer address data buf...

Page 387: ...x x 10 xx xx xx xx xx xx xx xx x 18 xx xx xx xx IPBFADR2 reply buffer addr x 20 IPBFLN2F reply length xx xx xx xx Inputs IPPATHID IPMSGID IPTRGCLS IPFLAGS1 IPBFRADR2 IPBFLN2F IUCV path id IUCV message...

Page 388: ...or IUCV SEVER x 00 Path ID xx IPRCODE xx xx xx xx x 08 IPVMID userid connected to x 10 xx xx xx xx xx xx xx xx x 18 xx xx xx xx xx xx xx xx x 20 xx xx xx xx xx xx xx xx Inputs Outputs IPPATHID IPVMID...

Page 389: ...d on path 5 buffer too short for message 6 fetch protection exception 7 addressing exception 8 msgid found but class path invalid 9 message has been purged 10 message length negative 11 target is not...

Page 390: ...ernal interrupt is traced in the internal trace table and the first 8 bytes of the IPARML are saved in the TTE The following is a list of possible IUCV interrupt codes 28 no control buffer exists 48 f...

Page 391: ...nection x 10 IPUSER x 18 IPUSER x 20 xx xx xx xx xx xx xx xx where IPPATHID Flag 1 IPMSGLIM IPVMID IPUSER IUCV pathid IPFLAGS1 privilege flags max number of concurrent messages allowed on path user ID...

Page 392: ...xx x 10 IPUSER x 18 IPUSER x 20 xx xx xx xx xx xx xx xx where IPPATHID Flag 1 IPMSGLIM IPUSER IUCV pathid IPFLAGS1 privilege flags max number of concurrent messages allowed on path 16 bytes of applic...

Page 393: ...vered REsumed Quiesced Interrupt x 00 IPPATHID xx IPTYPE xx xx xx xx x 08 xx xx xx xx xx xx xx xx x 10 IPUSER x 18 IPUSER x 20 xx xx xx xx xx xx xx xx Inputs IPPATHID IPTYPE IPUSER IUCV path id 03 sev...

Page 394: ...09 IPMSGID message id x 08 IPTRBCLS target class xx xx xx xx x 10 IPBFLN1F message length xx xx xx xx x 18 xx xx xx xx xx xx xx xx x 20 IPBFLN2F reply length xx xx xx xx where IPPATHID Flag 1 IPMSGID...

Page 395: ...t x 00 IPPATHID Flag 1 06 07 IPMSGID message id x 08 IPAUDIT xx xx xx xx xx x 10 xx xx xx xx xx xx xx xx x 18 xx xx xx xx xx xx xx xx x 20 IPBFLN2F residual length xx xx xx xx where IPPATHID Flag 1 IP...

Page 396: ...vent ID FID and EID are specified as parameters on the PARM statement of the HSC startup SLKJCL file refer to Creating an SLKJCL File for Starting the HSC on page 157 for more information Supervisor C...

Page 397: ...e external trace function is first enabled additional storage is obtained which is never released This storage is used for queued trace records The SCP Trace Formatter utility SLUETRAC is used to form...

Page 398: ...Formatter Utility EXEC optionally specified to invoke the EXEC SLUETRAC initiates the SLUETRAC EXEC EXEC spoolid events IN OUT infile outfile ALL DSP EXT I O IUC MCK PGM RST SIO SVC USR ACS infn TRAC...

Page 399: ...le The default is ACS inft the CMS filetype of the input file The default is TRACE infm the CMS filemode of the input file The default is A OUT indicates the output file If OUT is not specified a prin...

Page 400: ...30 04 312579601 Supervisor Call SVC Functions The SCP partially supports the following SVC functions They are included here for use when reading trace output Documentation of the actual subfunctions s...

Page 401: ...10 11 12 13 15 16 19 20 24 27 33 34 35 36 40 41 42 43 44 46 47 48 51 55 56 60 62 64 76 83 87 99 107 119 120 122 127 EXCP WAIT POST EXIT LIST GETMAIN LINK LOAD DELETE GET FREEMAIN R TIME SYNCH ABEND E...

Page 402: ...by the act of tracing 5 The Format Id FID parameter is supported It describes the internal format of the trace record The valid decimal FID ranges are 1 user FID 80 81 system FID 255 Actual FIDs used...

Page 403: ...d EID ranges are 0 user EID x 3FF x 400 system EID x FFF The actual EID used by the SCP is x 400 for all FIDs The actual EID used by the HSC is passed to the HSC initialization routine SLSBINIT and is...

Page 404: ...s to see if tracing of the caller s software component has been enabled The internal trace table is always updated If the caller s component has been enabled by the HSC TRACE command then GTRACE will...

Page 405: ...0 40F34040 40404040 3 3 00B61530 F3404040 404040F3 40404040 4040F340 3 3 3 00B61540 40404040 6550D3D9 E2D740BC 00DA0000 LRSP 00B61550 009DB6B8 00000000 4DF1F8F6 F0F1F1F5 1860115 00B61560 F7F2D2F1 F2F1...

Page 406: ...d refer to the HSC Operator s Guide Format of HSC GTRACE USR Records Table 23 HSC GTRACE USR Records Offset Length Description C 2 Trace identifier E 5 Name of module issuing SLSTRACE macro 13 1 Lengt...

Page 407: ...VT to indicate that debug mode is active If the SCP command STOPSCP is issued control will return to CMS without a re IPL Debug mode is terminated by the diagnostic command NODEBUG Setting Initializat...

Page 408: ...e is not specified the current traces are displayed offset the optional offset from the address of epname at which to set a breakpoint using CP PER The default is 0 length the optional length of the b...

Page 409: ...tic subsystem The default prefix is equal sign but may be set to any character that does not conflict with use by other subsystems for example the HSC Note The prefix character cannot be changed durin...

Page 410: ...ned is the assembler definition of the field with the DSECT name and the offset from the DSECT CP SET RUN OFF is executed and the SCP debug mode is entered The diagnostic command NODEBUG terminates th...

Page 411: ...e DIAG subsystem The default is but may be set to any character by the SUBSYS command that started the subsystem epname the name of a known entry point It is either named in the map within any SLKNUCx...

Page 412: ...rminates the debug environment the command character for the DIAG subsystem The default is but may be set to any character by the SUBSYS command that started the subsystem epname the name of a known e...

Page 413: ...Command The LIst command is used to display an HSC data structure Syntax Parameters LIst initiates the LIst command data structure specifies the name of a single HSC data structure It may be any one...

Page 414: ...ss of memory size specifies the amount of memory in decimal to display The default size is 16 DISPLAY Command The HSC Display command offers several options that are useful for diagnostic purposes For...

Page 415: ...SLIRCVRY macro indicates that these additional copies of the control data set are maintained by the HSC during library operation and kept on DASD In addition a CDs operator command provides you with t...

Page 416: ...ess to a failing data set is restored you must run the BACKup and RESTore utilities to restore the integrity of the failed data set An alternative method is to use the CDs command specifying the Enabl...

Page 417: ...ATA SET 1 DATA SET 2 CONTROL DATA SET 2 CONTROL DATA SET 3 CONTROL DATA SET 3 JOURNAL JOURNAL JOURNAL JOURNAL JOURNAL JOURNAL HSC EXECUTION INITIAL CONTROL DATA SET CONFIGURATION AT FAILURE OF PRIMARY...

Page 418: ...ore utilities Control Data Set Processes Several important processes are available to you for recovery purposes These are designed to permit you to keep your library running when there are apparent pr...

Page 419: ...host environment the HSC automatically provides communications to all hosts when a control data set switch has occurred For this communications performance to occur the proper hardware and software mu...

Page 420: ...stic purposes 3 Run the RESTore utility 4 If DASD hardware errors are found reallocate valid control data sets to a good storage device If you are unsuccessful in recovering from mismatch errors conta...

Page 421: ...any program in the SCP or the HSC This is usually done in an ESTAE recovery routine that was called after an error occurred The dump title supplied to the SDUMP becomes the dump title passed to the CP...

Page 422: ...S s virtual reader Move it to the appropriate machine s virtual reader by issuing the following command from STKACS s virtual console CP TRANSFER RDR CLASS V TO userid If the initial settings of CONSL...

Page 423: ...Tek Software Support using the telephone number provided in the Requesting Help from Software Support guide The remote diagnostician will request the following information Your StorageTek site locatio...

Page 424: ...SCAN environments is established DUMPSCAN VM XA SP and VM ESA IPCSSCAN VM SP and VM SP HPO Release 6 and VM ESA 370 After entering the SCAN environment you may invoke any of the environment s IBM or S...

Page 425: ...ow about SCP and HSC data structures and module locations VIEW The VIEW subcommand displays a data structure and saves its last resolved dump address After supplying or otherwise resolving a structure...

Page 426: ...R STORMAN STQENT SVC006 SVC011 SVC012 SVC034 SVC036 SVC046 SVC046M SVC047 SVC047M SVC060 SVC107 SVC119 SVICB SYSTIOT TBLOK TIMECONV TQE TRELAT TSEL TTE XINT Table 26 VIEW able HSC Data Structures Data...

Page 427: ...E OCRE OCVT ODACS ODCAP ODLSM ODSFT OFFLDWK OLHDR ONLSTP ONTAB ORQD ORQL ORQS ORQX OSHDR OSMLSM OSVSTA PSWIT QEPL QFCE QFCT QMTB QRWK QTIP QUAB QVT RACB RCVT REPL RITC RITO RITP RITT RL00 RL01 RPAURE...

Page 428: ...ACEBACK The TRB subcommand displays register save areas The traceback starts from the current R13 contents an explicit address or the contents of a named field in the SCP structure last VIEWed TRB TRB...

Page 429: ...FIND TASK This subcommand displays a list of addresses of all tasks with a given name The data displayed is the TBLOK address for each task that matches TASK taskname WA WHERE ADDRESS The WA subcomman...

Page 430: ...analog to MVS RB The following HSC data structure is referenced below LVT Library Vector Table The following MVS data structures are referenced below JESCT JES Communciations Table macro IEFJESCT SSCT...

Page 431: ...30 04 312579601 Command Message Trace Processing NUCON CVT CCVT MSGEL CMDPLIST INTERNAL TRACE TABLE CURRENT TTE CCVWTOQ CCVCMDQ COMANC MTT MTTCURR MTTFIRST MTTLAST X 10 VECTPTR TRCTAB X A60 INTERRUPT...

Page 432: ...l console 1 Loops a Disabled loops 1 Press PA1 Enter SET RUN OFF 2 Press PA1 Enter VMDUMP 0 END FORMAT SLK comments The PSW will be within the loop b Enabled loops These will be detected by the dispat...

Page 433: ...Chapter 5 Problem Determination Diagnostics and Recovery 403 1st ed 6 30 04 312579601 NUCON PSAAOLD PSATOLD JBLOK JBLTASK TBLOK TKRBLIST RQBLOK C29331 Figure 26 SCP Task Job Data Relationship...

Page 434: ...6 0 System Programmer s Guide 1st ed 6 30 04 312579601 NUCON VECTPTR CVT CVTJESCT JESCT JESSSCT SSCT SSCTSCTA SSCTSSVT SSCT SSCTSCTA SSCTSSVT SSCTSUSE SSVT SSVT LVT C29332 Figure 27 Subsystem Data Rel...

Page 435: ...g up with DUMP Use the SLUIPCS PRINT command with the COMM TASK PTTE IOS options to see what was happening in each job task when the system went into the wait Check the SLUIPCS PRINT listing for devic...

Page 436: ...tine Look in the PRBxxxxx REPORT file or STAT WA xx xx address in INSTAD or VIEW NUCON WA xx xx address in NUCIOPSW Find the Failing Task VIEW TBLOK PSATOLD Find the Failing Request Block VIEW TBLOK P...

Page 437: ...ually contains the LVT address for HSC modules for example SLS or SLU Find the LCT LST HST First find the LVT see instructions above VIEW LCT LVTLCT VIEW LST LVTLST VIEW HST LVTHST Identify the Last I...

Page 438: ...gnostic Materials During problem resolution Software Support may request that you provide them with specific diagnostic material While printed format may be accepted it is most desirable that you prov...

Page 439: ...figuration information dump data may be required problems relating to PROP message intercept PROP console log STKACS CONSLOG copy of execs and action table problems relating to HSC control data set co...

Page 440: ...ostic data be sent in machine readable format on tape in the following format VMFPLC2 format for VM dump processing refer to Dump Processing on page 391 if possible DO NOT use SPTAPE format Tape Retur...

Page 441: ...ration daily operations controlled by an operator This chapter contains recommendations and highlights performance techniques that can be helpful to you in making your library operate more efficiently...

Page 442: ...ay be used when operator intervention is required or when it is necessary to reset some static library parameter to improve performance Monitoring Library Activity and Performance There are several me...

Page 443: ...vities Report utility Using the Performance Measurement and Predictive Maintenance System PM2 The Performance Measurement and Predictive Maintenance System generates performance and error reports on v...

Page 444: ...the HSC warns of low quantities of scratch cartridges The Warn command establishes thresholds which control when the HSC notifies the operator of an insufficient quantity of scratch cartridges in an...

Page 445: ...d can be used to analyze library performance Software analytical tools can be used to manipulate the data and create various performance statistics Refer to Appendix C Record Formats on page 497 for d...

Page 446: ...Journal Definition JRNDEF Journal specify FULL Abend or FULL Continue Journals JRNDEF Journal specify FULL Abend or FULL Continue Mount Processing MNTD MNTD General Purpose Options OPTion OPTion Scrat...

Page 447: ...MPath Command and Control Statement in the HSC Operator s Guide describe how multiple hosts are connected by any of the three possible communication methods You have the capability to set or dynamical...

Page 448: ...unication methods can exist at the same time between multiple hosts Designation of Communication parameters When specifying communication parameters in the operator command the parameters can designat...

Page 449: ...es or simply because of daily procedures used within a data center The VIew command is invoked to improve performance because it can be used to quickly resolve problems It can often eliminate the need...

Page 450: ...SMF parameters Note Subtype 8 SMF record logging is not a default and must be specified in accordance with the instructions contained in the referenced paragraph Another useful technique to monitor th...

Page 451: ...Chapter 6 Performance Considerations 421 1st ed 6 30 04 312579601 With the use of SMF logging accurate records can be accumulated for system analysis or to monitor system status...

Page 452: ...The control data set is updated with each load of cartridges entered through the CAP If you begin entering cartridges containing data sets known to be required by regularly scheduled jobs these volum...

Page 453: ...sing the Scratch Redistribution utility to balance scratch cartridges involves moving cartridges to various LSMs to achieve scratch balancing This type of activity involves heavy pass thru usage If yo...

Page 454: ...move scratch cartridges between LSMs until an equilibrium is reached Each inter LSM movement of cartridges causes pass thrus which delay robot movement in mounting a cartridge Depending on the number...

Page 455: ...want the workload to be spread evenly among the robots rather than having one robot overloaded while the others are idle Within each LSM you want mounts to be evenly distributed among transports rath...

Page 456: ...erformance strive for a balanced workload schedule nonproductive library activities during low demand times Balancing the Workload If you experience higher than expected average mount times but at the...

Page 457: ...ty executes in both MVS and VM environments for which different versions of the utility are produced In the VM environment SLUPERF reads an SCP performance log spool file into a CMS file preserving th...

Page 458: ...rmixed with 4410 LSMs to improve library performance 1 Specify the following operator command MNTD SCRDISM ARCHIVE 2 Run scratch redistribution frequently 3 Eject cartridges when necessary from the ar...

Page 459: ...parameters and positional parameters Command names initiate command execution keyword parameters are operands that contain keywords and their related values and positional parameters are operands that...

Page 460: ...statement begins with a statement ends with diagrams continuing to the next line begin with fragments begin and end with Single Required Choice Branch lines without repeat arrows indicate that a singl...

Page 461: ...ce of values in a stack When the stack contains a default value the keyword and the value choices are placed below the baseline to indicate that they are optional and the default value appears above t...

Page 462: ...Fragments Fragment references direct you to parts fragments of the syntax that contain more detail than can be shown in the main syntax diagram COMMAND UTILITY NAME Fragment Reference Item1 Fragment...

Page 463: ...See the HSC Configuration Guide for information about the SLIACS macro The first LSM listed for an ACS acquires a hexadecimal number of 00 the second LSM listed for an ACS acquires a hexadecimal numbe...

Page 464: ...ek optional CAP may be added to the WolfCreek CAP TimberWolf LSM Model 9740 This LSM is configured with either a 14 cell permanent rack or a 10 cell removable magazine StreamLine Library Model 8500 Th...

Page 465: ...cell CAP of an enhanced CAP the 20 cell CAP of a WolfCreek CAP a 14 cell or 10 cell removable magazine 9740 TimberWolf CAP the 3 13 cell removable magazines for an SL8500 CAP 01 indicates one of the...

Page 466: ...those of the second element You cannot increment two portions of a range element If 111AAA is the first element you cannot specify 112AAB for the second element If a VOLSER range contains more than o...

Page 467: ...g incremented Note For most operator commands a VOLSER range is limited to 100 entries If a large range is entered only the first 100 VOLSERs are acted upon If HSC utilities are used the entire range...

Page 468: ...sed in parentheses For some HSC operator commands an element may consist of a single item or a range Refer to the individual command explanations for valid list entries In general HSC utilities do not...

Page 469: ...r definition data sets A control statement is terminated if the statement is not continued Control statements must have a comment as the first control statement in the PARMLIB member A PARMLIB member...

Page 470: ...ing example illustrates a continuation used incorrectly SCRPOOL NAME STD36 RANGE AAA000 AAA999 ZZZ 000 ZZZ999 Users must enter a nonblank character in column 72 e g an X PARMLIB control statements can...

Page 471: ...scope of the display may be limited to MEDia and or RECtech scratch counts within a subpool ACS or LSM When DETail is supplied all MEDia and RECtech information is displayed along with scratch counts...

Page 472: ...ia so a transport must be found that matches the MEDia RECtech or MODel aid transport selection when they match the MEDia If MEDia is not supplied for a nonspecific request then RECtech or MODel when...

Page 473: ...correct or volume to transport incompatibilities may exist These issues may result in various operator interactions and unexpected results WARN Command acs id lsm id SUBpool Yes Yes No A scratch thres...

Page 474: ...30 04 312579601 LIBGEN Macros The LIBGEN macros are shown below in alphabetical order Refer to Syntax Flow Diagrams in the HSC Installation Guide for complete explanations of macro syntax and paramet...

Page 475: ...o SLIALIST macro SLIDLIST macro SLIDRIVS macros SLIENDGN macro acs0 SLIACS Additional Parameters Additional Parameters ACSDRV esoteric0 esoteric15 LSM lsm0 lsm1 lsm23 STATION station0 station15 acslis...

Page 476: ...macro SLILIBRY HOSTID host id0 host id1 host id15 ACSLIST acslist Optional Parameters Optional Parameters CLNPRFX prefix CLN SMF libtype 255 NNLBDRV esoteric0 esoteric15 DELDISP SCRTCH NOSCRTCH MAJNAM...

Page 477: ...LISTATN macro S ptppane18 S M ADJACNT lsm1 lsm4 DOOR ECAP WINDOW wndpanel0 wndpanel3 100 TYPE 4410 9310 9360 075 050 9740 SLILSM lsm0 PASTHRU ptppane10 M WC2 WC1 8500 1 8500 2 STD 8500 DRVELST drvelst...

Page 478: ...efinition CDSDEF control statement EXECParm control statement Journal Definition JRNDEF control statement CDSDEF DSN1 dataset name VOL1 volser UNIT1 unitname DSN2 dataset name VOL2 volser UNIT2 unitna...

Page 479: ...U Path Definition LMUPDEF command and control statement DATASET dataset name DSN dataset name VOLume volser LKEYDEF UNIT unitname HOSTID host id LKEYINFO PRODuct product_identifier CUSTomer customer_n...

Page 480: ...ion RECDEF control statement Scratch Subpool SCRPOol control statement OPTion TITLE identifying string TRACE TRACEF RECDEF DSN1 dataset name VOL1 volser UNIT1 unitname DSN2 dataset name VOL2 volser UN...

Page 481: ...Tape Request TAPEREQ control statement SCRPDEF DSN dataset name DATASET dataset name VOLume volser UNIT unitname HOSTID host id TAPEREQ JOBname jobname STEPname stepname PROGram PGMname program name p...

Page 482: ...DD3C STK1 STK1R STK2 STK2P RECtech LONGItud 18track 36track 36Atrack 36Btrack 36Ctrack HELical DD3 STK1R STK1R34 STK1R35 STK1RA STK1RA34 STK1RA35 STK1RB STK1RB34 STK1RB35 STK1RAB STK1RC STK1RC34 STK1...

Page 483: ...control statement Unit Attribute UNITATTR control statement TREQDEF DATASET dataset name DSN dataset name VOLume volser UNIT unitname HOSTID host id UNITATTR ADDRess MODel 4480 4490 9490 9490EE SD3 98...

Page 484: ...tatement Volume Attribute VOLATTR control statement UNITDEF DATASET dataset name DSN dataset name VOLume volser UNIT unitname HOSTID host id VOLATTR SERial volser vol range vol list MEDia Standard CST...

Page 485: ...VOLATTR control statement continued RECtech MAXclean use limit LONGItud 18track 36track 36Atrack 36Btrack 36Ctrack HELical DD3 STK1R STK1R34 STK1R35 STK1RA STK1RA34 STK1RA35 STK2PA STK1RAB STK1RAB4 S...

Page 486: ...HSC 6 0 System Programmer s Guide 1st ed 6 30 04 312579601 Volume Attribute Definition VOLDEF command control statement VOLDEF DSN dataset name DATASET dataset name VOLume volser UNIT unitname HOSTID...

Page 487: ...on utility syntax and parameters ACTIvities Report utility AUDIt utility ACTIvities Optional Parameters Optional Parameters BEGIN begin date TODAY begin time 00 00 00 END end date TODAY end time 23 59...

Page 488: ...e Decompile LIBGEN utility Directory Rebuild DIRBLD utility EJECt utility BACKup CDS Primary Secondary STandby OPTion Restart Analyze Copy LIBGEN DIRBLD EJECt Eject Method 1 Eject Method 2 CAP cap lis...

Page 489: ...a Standard CST MEDIA1 STD 1 3480 ECART E ECCST ETAPE Long MEDIA2 3490E ZCART Z DD3A DD3B DD3C STK1R R STK2 RECtech 18track 36Atrack 36Btrack 36Ctrack DD3 STK1R STK1R34 STK1R35 STK1RA STK1RA34 STK1RA35...

Page 490: ...ournal OFFLoad utility MOVe utility Reconfiguration utility REPLace utility OFFLoad MOVe Parameters Parameters Flsm lsm id Panel panel list Volume vol list Row row list Column column list TLsm lsm lis...

Page 491: ...dix A Macros Control Statements Utilities and Commands Syntax Reference 461 1st ed 6 30 04 312579601 RESTore utility SCRAtch utility RESTore APPly NO YES GENerate Only Short YES NO SCRAtch VOLser vol...

Page 492: ...dard CST MEDIA1 STD 1 3480 ECART E ECCST ETAPE Long MEDIA2 3490E ZCART Z HELical DD3 DD3A DD3B DD3C STK1 STK1R R LONGItud 18track 36track 36Atrack 36Btrack 36Ctrack RECtech MEDia HELical DD3 STK1R STK...

Page 493: ...CSDRV esoteric FORACS acs id FORHOST host id CLNPRFX prefix COMPRFX cmdhex DELDISP SCRTCH NOSCRTCH HOSTID newhost FORHOST oldhost HSCLEVEL OFF FORHOST host id MAJNAME qname FREEZE ON OFf FORLSMID lsm...

Page 494: ...UNSCratch utility Unselect utility SET Options Options SMF libtype TCHNIQE JOURNAL SHADOW BOTH STANDBY ALL NONE SLIDRIVS addr0 addr19 FORLSMID lsm id FORPANEL panel FORHOST host id SLISTATN stat1 stat...

Page 495: ...m list VOLser volser vol range vol list VOLume volser vol range vol list SORT LOC INS VOL SEL USE DEScend ASCend NOSORT INCLude SCR NONSCR ERR NONERR SEL NONSEL READable UNREADable MEDEQUAL NONMEDEQ E...

Page 496: ...xplanations of command syntax and parameters CAP Preference CAPPref command and control statement CDs Enable Disable command CLean command CAPPref prefvlue lsm id cap id cap range cap list host id AUT...

Page 497: ...h COMMPath command and control statement DISMount command COMMPath HOSTid host id METHod LMU CDS LMU acs id VTAM LMUpath acs id acs range acs list VTAMpath name LMUpath acs id acs range acs list VTAMp...

Page 498: ...r s Guide 1st ed 6 30 04 312579601 Display command Display Acs Display ALl Display ALLOC Display Cap Display CDS Display acs id Acs acs list acs range Display ALl Display ALLOC Display all CAPs Cap ac...

Page 499: ...nd Commands Syntax Reference 469 1st ed 6 30 04 312579601 Display Cmd Display COMMPath Display DRives Display command name COmmand CMd Display COMMPath HOSTid ALL host id host list Display DRives Libr...

Page 500: ...TK1R R STK1U U RECtech LONGItud STK2 STK2P STK2W 18track 36track 36Atrack 36Btrack 36Ctrack HELical DD3 STK1R STK1R34 STK1R35 STK1RA STK1RA34 STK1RA35 STK1RB STK1RB34 STK1RB35 STK2P STK1RAB STK1RAB4 S...

Page 501: ...tax Reference 471 1st ed 6 30 04 312579601 Display Exceptions Display LKEYDEF Display LMUPDEF Display LSM Display Message Display MNTD Display EXceptns X Display LKEYDEF Display LMUPDEF Display Lsm ls...

Page 502: ...472 VM HSC 6 0 System Programmer s Guide 1st ed 6 30 04 312579601 Display MONitor Display OPTion Display Requests Display MONitor PGMI L name cc Display OPTion Display Requests...

Page 503: ...LONGItud CST MEDIA1 STD 1 3480 ECART E ECCST ETAPE Long MEDIA2 3490E ZCART Z HELical DD3 DD3A DD3B DD3C STK1 STK1R R RECtech LONGItud 18track 36track 36Atrack 36Btrack 36Ctrack HELical DD3 STK1R STK1R...

Page 504: ...474 VM HSC 6 0 System Programmer s Guide 1st ed 6 30 04 312579601 Display SCRPDEF Display SRVlev Display Status Display SCRPDEF Display SRVlev Display Status...

Page 505: ...LONGItud CST MEDIA1 STD 1 3480 ECART E ECCST ETAPE Long MEDIA2 3490E ZCART Z HELical DD3 DD3A DD3B DD3C STK1 STK1R R RECtech STK1R34 18track LONGItud 36track 36Atrack 36Btrack 36Ctrack HELical DD3 ST...

Page 506: ...DEF Display VOLDEF Display Volume DRAin CAP command EJect command Display UNITDEF Display VOLDEF Display Volume Volser vol range volser vol list DETail DRAin cap id EJect ENter cap list EJect Option 2...

Page 507: ...d Standard CST MEDIA1 STD 1 3480 ECART E ECCST ETAPE Long MEDIA2 3490E ZCART Z HELical DD3 DD3A DD3B DD3C STK1 STK1R R RECtech STK1R34 LONGItud 18track 36track 36Atrack 36Btrack 36Ctrack HELical DD3 S...

Page 508: ...312579601 ENter command Journal command MODify command MONITOR command ENter acs id cap id lsm id 00 SCRatch Journal Full Continue ABEND F MODify CAP cap id lsm id ONline OFFline LSM lsm id lsm range...

Page 509: ...479 1st ed 6 30 04 312579601 Mount command Mount volser devaddr host id Readonly SCRTCH devaddr host id SUBpool subpool name MEDia LONGItud Standard CST MEDIA1 STD 1 3480 ECART E ECCST ETAPE Long MED...

Page 510: ...command and control statement MNTD AUtocln ON OFf Dismount Auto Manual EJctauto ON MSg OFf ACS acs id Float ON OFf ACS acsid MAXclean count MMount Delete Reply MOuntmsg Roll Noroll PASSTHRU count Scr...

Page 511: ...tements Utilities and Commands Syntax Reference 481 1st ed 6 30 04 312579601 MOVe command MOVe Flsm lsm id Panel pp Row row list Column cc Row rr Column column list Volume vol range volser vol list TL...

Page 512: ...over Host command RELease CAP command OPTion Dialog Both Log Console Off HOSTID host id DISCmsg SHow SUppress ACS acs id EJLimit count ENTdup Auto Manual LOGging Standard Extended Output Upper Mixed R...

Page 513: ...6 30 04 312579601 SENter command SRVlev Service Level command Stop Monitoring STOPMN command SWitch command SENter cap id SRVlev BASE FULL STOPMN PM PGMI L cc name SWitch Acs acs id 1 Note 1 ACS acs...

Page 514: ...04 312579601 TRace command TRACELKP command Vary Station command TRace comp name comp list OFF comp name comp list TRACELKP table name table list OFF table name Vary acs range acs id acs list OFFline...

Page 515: ...command VIew CAp CAPID cap id Lsm lsm id CAPID 00 00 00 CEll Row rr Row 00 Lsm 00 00 Lsm lsm id Panel pp Panel 00 Column cc Column 00 Column cc Column 00 DRive Address xxx Host host id PLaygrnd Lsm 0...

Page 516: ...rd RECtech LONGItud CST MEDIA1 STD 1 3480 ECART E ECCST ETAPE Long MEDIA2 3490E ZCART Z DD3 DD3A DD3B DD3C STK1 STK1R R STK2 STK2P 18track 36Atrack 36Btrack 36Ctrack HELical DD3 STK1R STK1R34 STK1R35...

Page 517: ...trol Statements Utilities and Commands Syntax Reference 487 1st ed 6 30 04 312579601 HSC Diagnostic Commands LIst command TRace command LIst data structure address size 16 TRace comp name comp list OF...

Page 518: ...ator Commands comment Statement AUTHorize Command CANCEL command CP Command DEFine Command DUMP Command comments AUTHorize user list userid CMDS MSGS route codes NETVM NONE CANCEL taskid DUMP CP cmdpa...

Page 519: ...d HELP Command Modify Command SCP Query Command FILE ddname BLOCKIO DISK CLEAR DEV vaddr CARD PNCH PRNT CLass class DSN dsn IUCV userid vaddr DSN dsn HELP HELP scp command diag command msgnum topic ta...

Page 520: ...2579601 Reply Command SET Command Reply nn text text CONSlog SET ON OFF CLOSE destination DUMPOpts REset maxcount userid userid MSGtype MSGNOH MSG PERFlog ON OFF CLOSE SMF subsystem interval SUBTYPE s...

Page 521: ...dix A Macros Control Statements Utilities and Commands Syntax Reference 491 1st ed 6 30 04 312579601 Class class TO FOR userid AT node ALL DSP EXT IO I O IUC MCK destination events NONE PGM RST SIO SV...

Page 522: ...9601 SLK Command STArt Command STOP Command STOPSCP Command SUBSYS Command SLK scp command STArt progname progname taskid 50 prio parms JOBRDR AUTHRDR JOBRDR taskid AUTHRDR taskid 50 prio CLass class...

Page 523: ...Appendix A Macros Control Statements Utilities and Commands Syntax Reference 493 1st ed 6 30 04 312579601 GCS Component Server Commands SLKGCS Command SLKGCS START DISPLAY STOP CANCEL...

Page 524: ...perator Commands ACS EXEC CMS HELP EXEC ACS command INIT NOJOBs BREAK breakstr PARM parmstr SUBMIT jobfname SLKJCL ftype fmode U class PARM parmstr UTILity util list utility NOSEND JOBName jobname NOE...

Page 525: ...d by the VM HSC CP Programming Services The following DIAGNOSE codes may be issued by the HSC DIAGNOSE Code X 00 Store extended identification code DIAGNOSE Code X 08 Virtual console function DIAGNOSE...

Page 526: ...496 VM HSC 6 0 System Programmer s Guide 1st ed 6 30 04 312579601 IUCV Communication vehicle for API and communication with Host to Host component...

Page 527: ...ONST BITMAP and Length LENGTH contain values in the Decimal and Hexadecimal columns Type AREA contains offsets in the Decimal and Hexadecimal columns The Length is the length of an area An area define...

Page 528: ...ds Mapping macros for Volume Report and Batch API records are listed in Table 57 on page 562 Mapping Macros for Batch API Records Mapping macros for Batch API Records available only through the Batch...

Page 529: ...Attribute Record Data Length within other SMF records SLSSFHDR SMF Record Header Information SLSSBLOS SMF LSM Operations Statistics SLSSCAPJ SMF CAP Eject Record SLSSCAPN SMF CAP Enter Record SLSSVSTA...

Page 530: ...at Dec Hex Type Length Label Description SLSDVAR Distributed Volume Attribute Record Length FUNCTION Pass the HSC Volume Attribute Record Length VARL for other Distributed HSC Macros to use as needed...

Page 531: ...MOUNT REQUEST 14 VTCS VTV DISMOUNT REQUEST 15 VTCS VTV DELETE REQUEST 16 VTCS RTD MOUNT REQUEST 17 VTCS RTD DISMOUNT REQUEST 18 VTCS VTV TO MVC REQUEST 19 VTCS RECALL VTV FROM MVC REQUEST 20 VTCS RTD...

Page 532: ...TS for the following VTCS SMF SUBTYPEs 10 0A CONST OSHDVT10 VTCS Subsystem Performance Request 11 0B CONST OSHDVT11 VTCS Channel Interface Performance Rqst 12 0C CONST OSHDVT12 VTCS State Save 13 0D C...

Page 533: ...Event 28 1C CONST OSHDVT28 VTCS REPLICATE VTV CLUSTERED VTSS Rqst 28 1C CONST OSHDMAXS MAXIMUM RECORD SUBTYPE VALUE 24 18 LENGTH OSHDL LENGTH OF FIXED PORTION OF OSHDR 24 18 OFFSET SLSSTYPE DEFINE EAC...

Page 534: ...SHDENTR 06 OSHDFLAG 000001 04 OSHDL 18 OSHDLRST 04 OSHDMAXS 1C OSHDMLSM 03 OSHDRCTY 000001 05 OSHDRC07 07 OSHDRECL 000002 00 OSHDRSTY 000002 16 OSHDSID 000004 0E OSHDSSID 000004 12 OSHDSTV 40 OSHDTIME...

Page 535: ...Appendix C Record Formats 505 1st ed 6 30 04 312579601 OSHDVT20 14 OSHDVT21 15 OSHDVT22 16 OSHDVT23 17 OSHDVT24 18 OSHDVT25 19 OSHDVT26 1A OSHDVT27 1B OSHDVT28 1C SLSSTYPE 18 Name Len Offset Value...

Page 536: ...SECT OR CONTINUATION OF DATA AREA YES PRODUCE A DSECT LISTING NO NO DSECT 0 0 AREA 2 SLSSBLOS LSM OPERATIONS STATISTICS DATA AREA START OF SMF FIXED PORTION 0 0 SIGNED HWORD 2 BLOSKNT COUNT OF BLOS DA...

Page 537: ...ENGTH OF COUNTER SECTION 24 18 LENGTH BLOSL BLOS LENGTH Name Len Offset Value BLOSDNS 10 BLOSDOPC 000004 0C BLOSDSS 20 BLOSDTIM 000004 10 BLOSEJT 01 BLOSKNT 000002 00 BLOSL 18 BLOSLSSL 02 BLOSMNS 40 B...

Page 538: ...SMF WRITER SERVICE ROUTINE FOR THE CARTRIDGE EJECT EVENT SYMBOLICS DSECT DSECT OR CONTINUATION OF DATA AREA YES PRODUCE A DSECT LISTING NO NO DSECT 6 6 AREA 2 SLSSCAPJ CAP EJECT SMF RECORD SUBTYPE 6 6...

Page 539: ...F WRITER SERVICE ROUTINE FOR THE CARTRIDGE ENTER EVENT SYMBOLICS DSECT DSECT OR CONTINUATION OF DATA AREA YES PRODUCE A DSECT LISTING NO NO DSECT 6 6 AREA 2 SLSSCAPN CAP ENTER SMF RECORD SUBTYPE 6 6 H...

Page 540: ...REA 2 SLSSVSTA VARY STATION SMF RECORD SUBTYPE 0 0 SIGNED FWORD 4 SVSTFLAG FLAGS 0 0 A ADDR 1 SVSTFLG0 TYPE OF STATISTIC FLAGS 1 X 80 SVSTVON VARY ON 1 X 40 SVSTVOF VARY OFF 1 X 20 SVSTFOR VARY FORCE...

Page 541: ...04 312579601 Cross Reference Name Len Offset Value SLSSVSTA 000002 00 SVSTACID 000001 04 SVSTACS 10 SVSTATID 000002 04 SVSTFLAG 000004 00 SVSTFLG0 000001 00 SVSTFOR 20 SVSTL 08 SVSTSTBY 08 SVSTUNID 00...

Page 542: ...N OF DATA AREA YES PRODUCE A DSECT LISTING NO NO DSECT 0 0 AREA 2 SLSSMLSM MODIFY LSM SMF RECORD SUBTYPE 0 0 SIGNED FWORD 4 SMLSFLAG FLAGS 0 0 A ADDR 1 SMLSFLG0 TYPE OF STATISTIC FLAGS 1 X 80 SMLSVON...

Page 543: ...ATION OF DATA AREA YES PRODUCE A DSECT LISTING NO NO DSECT 0 0 AREA 2 SLSSLSB LMU ATHS STATISTICS BUFFER 0 0 HEXSTRING 2 LSBMON MONTH 2 2 HEXSTRING 2 LSBDAY DAY 4 4 HEXSTRING 2 LSBHR HOUR 6 6 HEXSTRIN...

Page 544: ...12 C SIGNED FWORD 4 RESERVED 2 RESERVED 20 14 LENGTH LSBEL SIZE OF LSBE Name Len Offset Value LSBACS 000001 14A LSBDAY 000002 02 LSBEARMU 000004 00 LSBECNT1 000004 04 LSBECNT2 000004 08 LSBECON1 0000...

Page 545: ...IDGE MOVEMENT TYPE THAT INITIATED THE ENTER BY CHECKING SMF07TYP TO FIND EJECT ACTIVITY WITHIN THE SLSSMF07 RECORDS FIND ALL SLSSMF07 MOVE DETAIL RECORDS WITH A DESTINATION IDENTIFIER SMF07DEI CAP SMF...

Page 546: ...BY THE HSC ONLY 7 7 HEXSTRING 4 SMF07TDT DATE THE REQUEST WAS RECEIVED BY THE HSC 0CYYDDDF 11 B HEXSTRING 4 SMF07LTM TIME IN HUNDREDTHS THE REQUEST WAS WAS RECEIVED BY THE LMU SERVER 15 F HEXSTRING 4...

Page 547: ...2B HEXSTRING 4 SMF07CON CONSOLEID IF INITIATED BY THE OPERATOR 47 2F CHARACTER 1 SMF07LBL LABEL MODIFIER 1 F1 CHAR CONST SMF07MVV VERIFY LABEL VOLSER 2 F2 CHAR CONST SMF07MVU VERIFY UNLABELED CARTRID...

Page 548: ...N LSM 64 40 HEXSTRING 1 SMF07TPN DESTINATION PANEL 65 41 HEXSTRING 1 SMF07TRO DESTINATION ROW 66 42 HEXSTRING 1 SMF07TCO DESTINATION COLUMN 67 43 HEXSTRING 2 SMF07DRS SOURCE DRIVE DEVICE NUMBER INVOLV...

Page 549: ...ON LSM ROBOTICS TIME HEX FFFFFFFF INDICATES LMU COUNTER OVERFLOW 100 64 HEXSTRING 4 SMF07DRQ INTERVAL IN HUNDREDTHS OF DESTINATION LSM ROBOTICS QUEUE TIME HEX FFFFFFFF INDICATES LMU COUNTER OVERFLOW 1...

Page 550: ...07DNS 10 SMF07DRO 000004 60 SMF07DRQ 000004 64 SMF07DRS 000002 43 SMF07DRT 000002 45 SMF07DSS 20 SMF07DSV 80 SMF07DTV 40 SMF07DWT 000004 5C SMF07EDT 000004 53 SMF07EJT 01 SMF07ETM 000004 4F SMF07FLG 0...

Page 551: ...00004 70 SMF07PRQ 000004 74 SMF07RQS 000001 01 SMF07SAC 000001 38 SMF07SCE CVAL SMF07SCO 000001 3C SMF07SCP CVAL SMF07SDR CVAL SMF07SDT 000004 4B SMF07SFI CVAL SMF07SFN CVAL SMF07SF1 000001 36 SMF07SL...

Page 552: ...004 07 SMF07TDW CVAL SMF07TLS 000001 3F SMF07TMI 06 SMF07TNM 000001 57 SMF07TPN 000001 40 SMF07TRO 000001 41 SMF07TTM 000004 03 SMF07TYP 000001 00 SMF07UNK 00 SMF07US1 000008 1B SMF07US2 000008 23 SMF...

Page 553: ...F08LSM LSM number 2 2 A ADDR 1 SMF08CID CAP id 3 3 A ADDR 1 SMF08MAG MAG number 4 4 A ADDR 1 SMF08TYP Type of VIEW completed 1 X 01 SMF08CEL Storage diag or playgrnd cell 1 X 02 SMF08CAP CAP cell 11 X...

Page 554: ...00001 00 SMF08CAP 02 SMF08CEL 01 SMF08CID 000001 02 SMF08COL 000001 07 SMF08CUA 000002 12 SMF08DRV 03 SMF08HST 000008 0A SMF08L 14 SMF08LSM 000001 01 SMF08LSM2 000001 05 SMF08MAG 000001 03 SMF08PNL 00...

Page 555: ...ation Termination Record SLSSLLG1 LOGREC LMU Driver Format 1 SLSSLLG2 LOGREC LMU Driver Format 2 SLSSLLG3 LOGREC LMU Driver Format 3 SLSSLLG4 LOGREC LMU Driver Format 4 SLSSLLG5 LOGREC Dual LMU Status...

Page 556: ...Counts 7000 DATABASE JOURNALLING LOGREC RECORD 7001 DATABASE PRIMARY SHADOW SWITCH LOGREC RECORD 8500 RECOVERY ERDS RECORD 0 8501 RECOVERY ERDS RECORD 1 9201 HOST COMMUNICATIONS LOGREC FORMAT 1 0 0 ST...

Page 557: ...FORCE UNSELECT RECORD 20480 5000 CONST LTYP5000 INIT TERM LOGREC RECORD 25857 6501 CONST LTYP6501 LMU DRIVER LOGREC FORMAT 1 25858 6502 CONST LTYP6502 LMU DRIVER LOGREC FORMAT 2 25859 6503 CONST LTYP...

Page 558: ...528 VM HSC 6 0 System Programmer s Guide 1st ed 6 30 04 312579601 652 28C LENGTH OLHDL LENGTH OF FIXED PORTION OF OLHD Table 43 SLSSLHDR Record Format Continued Dec Hex Type Length Label Description...

Page 559: ...5 6505 LTYP6506 6506 LTYP7000 7000 LTYP7001 7001 LTYP8500 8500 LTYP8501 8501 LTYP9201 9201 OLHDCDCT 000001 06 OLHDCPID 000008 10 OLHDDATE 000004 08 OLHDERF 20 OLHDERID 20 OLHDETIM 000004 288 OLHDJBID...

Page 560: ...System Programmer s Guide 1st ed 6 30 04 312579601 OLHDRVRA 000006 1B4 OLHDSMS 000001 02 OLHDSOFT 40 OLHDSTC 000004 284 OLHDSW2 000001 03 OLHDTFLG 08 OLHDTIME 000004 0C OLHDVS2 80 SLSSTYPE 20 Name Le...

Page 561: ...RECORD 16385 4001 CONST VLG1SUBT SUBTYPE X 4001 STANDARD SLS CONTROL BLOCK HEADER DEFINITION 0 0 CHARACTER 4 VLG1HDR IDENTIFIER VLG1 4 4 A ADDR 4 VLG1LEN LENGTH OF THE VLG1 8 8 A ADDR 1 VLG1SP SUBPOO...

Page 562: ...d 6 30 04 312579601 Cross Reference Name Len Offset Value SLSSVLG1 000002 00 VLG1HDR 000004 00 VLG1HOST 000008 0C VLG1JOBN 000008 14 VLG1KEY 000001 09 VLG1L 36 VLG1LEN 000004 04 VLG1OWNR 000008 22 VLG...

Page 563: ...T OR CONTINUATION OF DATA AREA YES PRODUCE A DSECT LISTING NO NO DSECT 0 0 AREA 2 SLSSBLOG INIT TERM LOGREC RECORD 20480 5000 CONST BLOGID RECORD TYPE 5000 0 0 AREA 4 BLOGFLAG FLAGS 0 0 BITSTRING 1 BL...

Page 564: ...Programmer s Guide 1st ed 6 30 04 312579601 Cross Reference Name Len Offset Value BLOGABND 20 BLOGCNCL 10 BLOGFLAG 000004 00 BLOGFLG0 000001 00 BLOGID 5000 BLOGL 08 BLOGRECO 08 BLOGSHTD 40 BLOGSTRT 8...

Page 565: ...1 LLG1KEY PROTECTION KEY 10 A SIGNED HWORD 2 RESERVED RESERVED LLG1 BODY 12 C HEXSTRING 1 LLG1ACS ACSID OF REQUEST 13 D HEXSTRING 2 LLG1STN STATION RECEIVING RESPONSE 15 F BITSTRING 1 LLG1ECD ERROR C...

Page 566: ...ST LLG1NNUM NON NUMERIC BLOCK HEADER 12 0C CONST LLG1SNOB STANDBY LMU CANNOT ACCEPT B BLOCK 13 0D CONST LLG1SWAT SWITCHOVER ALREADY ACTIVE 50 32 CONST LLG1NWSN WRONG SEQUENCE NUMBER THIS STN 51 33 CON...

Page 567: ...IP HOSTNAME ADDRESS 102 66 CHARACTER 24 LLG1SHNM STATION NETWORK HOST NAME FOR TCP IP NETWORK ADDRESS 126 7E HEXSTRING 4 LLG1STCP STATION NETWORK IP ADDRESS 130 82 HEXSTRING 22 RESERVED RESERVED FOR...

Page 568: ...LLG1ECD 000001 0F LLG1ERSP 18 LLG1ERTP 34 LLG1HDFL 000001 5D LLG1HDR 000004 00 LLG1ILGL 33 LLG1INVB 28 LLG1INVR 10 LLG1ITYP 84 LLG1KEY 000001 09 LLG1L 98 LLG1LEN 000004 04 LLG1LMLV 000002 63 LLG1NCJI...

Page 569: ...RCDE 000001 10 LLG1RNTN 14 LLG1RQST 000044 11 LLG1RSPN 000032 3D LLG1SHNM 000024 66 LLG1SNOB 0C LLG1SP 000001 08 LLG1STCP 000004 7E LLG1STHN 80 LLG1STN 000002 0D LLG1STTC 40 LLG1STYP 000001 65 LLG1SUB...

Page 570: ...ADDR 4 LLG2LEN LENGTH OF THE LLG2 8 8 A ADDR 1 LLG2SP SUBPOOL NUMBER 9 9 A ADDR 1 LLG2KEY PROTECTION KEY 10 A SIGNED HWORD 2 RESERVED RESERVED LLG2 BODY 12 C HEXSTRING 1 LLG2ACS ACSID OF BLOCK 13 D H...

Page 571: ...Offset Value LLG2ACS 000001 0C LLG2BLNN 7C LLG2DBKE 04 LLG2ECD 000001 0F LLG2HDR 000004 00 LLG2IBLK 000064 11 LLG2ISEQ 88 LLG2KEY 000001 09 LLG2L C8 LLG2LEN 000004 04 LLG2OBLK 000064 51 LLG2RCDE 0000...

Page 572: ...SECT 0 0 AREA 2 SLSSLLG3 LMU DRIVER LOGREC FORMAT THREE 25859 6503 CONST LLG3SUBT SUBTYPE X 6503 STANDARD SLS CONTROL BLOCK HEADER DEFINITION 0 0 CHARACTER 4 LLG3HDR IDENTIFIER LLG3 4 4 A ADDR 4 LLG3L...

Page 573: ...LISTING NO NO DSECT 0 0 AREA 2 SLSSLLG4 LMU DRIVER LOGREC FORMAT FOUR 25860 6504 CONST LLG4SUBT SUBTYPE X 6504 STANDARD SLS CONTROL BLOCK HEADER DEFINITION 0 0 CHARACTER 4 LLG4HDR IDENTIFIER LLG4 4 4...

Page 574: ...uide 1st ed 6 30 04 312579601 Cross Reference Name Len Offset Value LLG4COND 000001 0E LLG4DEVC 000002 0C LLG4FSC 000004 10 LLG4HDR 000004 00 LLG4KEY 000001 09 LLG4L 14 LLG4LEN 000004 04 LLG4SP 000001...

Page 575: ...POOL NUMBER 9 9 A ADDR 1 LLG5KEY PROTECTION KEY 10 A SIGNED HWORD 2 RESERVED RESERVED LLG5 BODY 12 C HEXSTRING 1 LLG5ACS ACS ID 13 D HEXSTRING 2 LLG5STN Station number 15 F CHARACTER 1 LLG5OMST Old Ma...

Page 576: ...IS A NETWORK IP ADDRESS FOR TCP IP HOSTNAME ADDRESS 20 14 CHARACTER 24 LLG5SHNM STATION NETWORK HOSTNAME FOR TCP IP NETWORK ADDRESS 44 2C HEXSTRING 4 LLG5STCP STATION NETWORK IP ADDRESS 48 30 HEXSTRIN...

Page 577: ...S 000001 0C LLG5HDR 000004 00 LLG5KEY 000001 09 LLG5L 48 LLG5LEN 000004 04 LLG5NMST 000001 11 LLG5NSLV 000001 12 LLG5OMST 000001 0F LLG5OSLV 000001 10 LLG5SHNM 000024 14 LLG5SP 000001 08 LLG5STCP 0000...

Page 578: ...otection Key 10 A SIGNED HWORD 2 RESERVED Reserved for future use LLG6 Body 12 C HEXSTRING 1 LLG6ACS ACS ID binary 0 255 13 D HEXSTRING 1 RESERVED Reserved 14 E BITSTRING 1 LLG6FLG1 1st byte of LSM co...

Page 579: ...ed 56 38 SIGNED FWORD 4 LLG6L5RM LSM 5 Robotic Motions Started 60 3C SIGNED FWORD 4 LLG6L5SF LSM 5 Softfails Recovered 64 40 SIGNED FWORD 4 LLG6L6RM LSM 6 Robotic Motions Started 68 44 SIGNED FWORD 4...

Page 580: ...3 Softfails Recovered 128 80 SIGNED FWORD 4 LLG6L14RM LSM 14 Robotic Motions Started 132 84 SIGNED FWORD 4 LLG6L14SF LSM 14 Softfails Recovered 136 88 SIGNED FWORD 4 LLG6L15RM LSM 15 Robotic Motions S...

Page 581: ...6L0AV 80 LLG6L0RM 000004 10 LLG6L0SF 000004 14 LLG6L1AV 40 LLG6L1RM 000004 18 LLG6L1SF 000004 1C LLG6L10AV 20 LLG6L10RM 000004 60 LLG6L10SF 000004 64 LLG6L11AV 10 LLG6L11RM 000004 68 LLG6L11SF 000004...

Page 582: ...6L4AV 08 LLG6L4RM 000004 30 LLG6L4SF 000004 34 LLG6L5AV 04 LLG6L5RM 000004 38 LLG6L5SF 000004 3C LLG6L6AV 02 LLG6L6RM 000004 40 LLG6L6SF 000004 44 LLG6L7AV 01 LLG6L7RM 000004 48 LLG6L7SF 000004 4C LLG...

Page 583: ...R LOGREC MAP ID NUMBER MATCHES CORRESPOND ING MESSAGES FROM WMSGTXTD MACRO 0 0 BITSTRING 1 DJLRFLG1 FLAG BYTE 1 X 80 DJLRIO I O ERROR IMMEDIATELY FOLLOWING JOURNAL SWITCH 1 X 40 DJLRBIO BOTH JOURNALS...

Page 584: ...LENGTH DJLRL DOUBLE WORD MULTIPLE FOR GETMAIN Name Len Offset Value DJLRBIO 40 DJLRDDN1 000008 01 DJLRDDN2 000008 3E DJLRDSN1 000044 09 DJLRDSN2 000044 46 DJLRFLG1 000001 00 DJLRID 7000 DJLRIO 80 DJL...

Page 585: ...HEXSTRING 1 PSWPRFLG PRIMARY FLAG BYTE 1 1 HEXSTRING 1 PSWSCFLG SECONDARY FLAG BYTE 2 2 HEXSTRING 2 RESERVED RESERVED 4 4 SIGNED FWORD 4 PSWITERR ERROR CAUSING SWITCH TO SHADOW 8 8 SIGNED FWORD 4 PSW...

Page 586: ...Len Offset Value PSWITERR 000004 04 PSWITFLG 000004 00 PSWITID 7001 PSWITL 84 PSWPRDCB 000004 08 PSWPRFLG 000001 00 PSWPRQNM 000044 16 PSWPRUCB 000004 0C PSWPRVOL 000006 10 PSWSCDCB 000004 44 PSWSCFLG...

Page 587: ...TAINS THE LSM ID OF AN LSM REQUIRING AUDIT SYMBOLICS DSECT DSECT OR CONTINUATION OF DATA AREA YES PRODUCE A DSECT LISTING NO NO DSECT 0 0 AREA 2 SLSSRL00 RECOVERY ERDS RECORD 0 34048 8500 CONST RL00ID...

Page 588: ...RECOVERED SYMBOLICS DSECT DSECT OR CONTINUATION OF DATA AREA YES PRODUCE A DSECT LISTING NO NO DSECT 0 0 AREA 2 SLSSRL01 RECOVERY ERDS RECORD 1 34049 8501 CONST RL01ID EVENT 8501 0 0 A ADDR 2 RL01DEF...

Page 589: ...LG1KEY Protection key 10 A SIGNED HWORD 2 RESERVED Reserved for future use HLG1 body 12 C SIGNED FWORD 4 HLG1RC Return code causing method switch 16 10 CHARACTER 8 HLG1LCLH Hostid of local executing h...

Page 590: ...t so method is switched for all other possible hosts 57 39 A ADDR 1 HLG1FLG2 Flag byte 2 58 3A A ADDR 2 RESERVED Reserved This is the header information of the module creating the LOGREC rec 60 3C CHA...

Page 591: ...1 39 HLG1HDR 000004 00 HLG1ICMD 80 HLG1ID CVAL HLG1IICN 10 HLG1INTH 000008 20 HLG1IOTH 40 HLG1IWRT 20 HLG1KEY 000001 09 HLG1L 80 HLG1LCLH 000008 10 HLG1LEN 000004 04 HLG1NLP 000004 28 HLG1NMTH 000004...

Page 592: ...h API Records on page 593 to see SLUVDDAT and SLUVPDAT which are used only by the Batch API Table 57 Mapping Macros for Volume Report and Batch API Records Macro Description SLUVADAT Flat File ACS LSM...

Page 593: ...SENTS EACH HOST CONNECTED FROM LEFT TO RIGHT IN HOST INDEX ORDER 8 8 CHARACTER 2 ACSL1CLV LMU 1 COMPATIBILITY LEVEL FUTURE W90 10 A HEXSTRING 2 RESERVED 12 C CHARACTER 2 ACSL2CLV LMU 2 COMPATIBILITY L...

Page 594: ...NG 1 LSMPNTOT TOTAL NUMBER OF PANELS 16 10 HEXSTRING 1 LSMCAPNO NUMBER OF CAPS 17 11 HEXSTRING 1 LSMPTPNO MAX PTPS THIS LSM 18 12 HEXSTRING 1 LSMNPGCS NUMBER OF PLAYGROUND CELLS 19 13 HEXSTRING 1 LSML...

Page 595: ...SCRCT NUMBER OF SCRATCHES IN THIS LSM 62 3E HEXSTRING 6 LSMPANLS 44 LSM PANEL ARRAY 326 146 LENGTH LSMENTLN LENGTH OF LSM ENTRY LSMPANLS CONTAINS AN ENTRY FOR EACH PANEL IN AN LSM MAXIMUM 20 AND MAY B...

Page 596: ...F PANEL 3 1 1 X 28 LSMWP3DR 1 1 WOLF PANEL 3 W DRIVE 1 1 1 X 29 LSMWP41C 1 1 1 WOLF PANEL 4 W 1 CAP 11 X 30 LSMWP42C 11 WOLF PANEL 4 W 2 CAPS 11 1 X 31 LSMW3NOC 11 1 WC PANEL 3 WITHOUT CELLS 11 1 X 32...

Page 597: ...EL STATUS 1 X 80 LSMPFRZ PANEL IS FROZEN 4 4 HEXSTRING 2 RESERVED RESERVED 3 03 LENGTH LSMPFRZL LENGTH OF FREEZE PANEL BYTES 6 06 LENGTH LSMPNLEL LENGTH OF PANEL ENTRY Name Len Offset Value ACSDUALL 8...

Page 598: ...SMCPTMP 04 LSMCSTMP 05 LSMCWIDD 14 LSMCWIDN 13 LSMDPNUM 000001 1E LSMELCAP 81 LSMELCEL 82 LSMELCE3 83 LSMELCE4 84 LSMELDRV 80 LSMELIB 07 LSMENTLN B8 LSMFRECL 000002 24 LSMHCLVL 000006 30 LSMHSTID 0000...

Page 599: ...1 1C LSMNROPN 000001 1A LSMNUMBR 000001 00 LSMNXPRT 000001 16 LSMODPNO 000001 18 LSMOFFPN 40 LSMPANLS 000006 3E LSMPCCNT 000002 01 LSMPFLG 000001 03 LSMPFRZ 80 LSMPFRZL 03 LSMPNLEL 06 LSMPNLTY 000001...

Page 600: ...LSMTWLF 06 LSMVCAMF 000001 02 LSMVCAMR 40 LSMWOLF 03 LSMWPNL0 20 LSMWPNL2 25 LSMWPNL3 27 LSMWP0PT 22 LSMWP1DR 24 LSMWP2PT 26 LSMWP3DR 28 LSMWP41C 29 LSMWP42C 30 LSMW3NOC 31 LSMW1NOD 23 LSMW2PSL 21 LSM...

Page 601: ...C SIGNED HWORD 2 CFGNMACS TOTAL DEFINED ACSS 14 E SIGNED HWORD 2 CFGTOTLS TOTAL DEFINED LSMS 16 10 SIGNED HWORD 2 CFGTOTCA TOTAL CAPS FOR ALL LSMS 18 12 SIGNED HWORD 2 CFGTOTDR TOTAL DRIVES IN ALL LS...

Page 602: ...CRNL 1 NL NONLABELLED 11 X 03 CFGSCRNS 11 NSL NON STANDARD 1 X 04 CFGSCRBL 1 BLP BYPASS LBL PROC 1 1 X 05 CFGSCRNA 1 1 LBL TYPE NOT AVAIL 26 1A LENGTH CFGLNGTH LENGTH OF RECORD 256 100 CONST CFGMXLSM...

Page 603: ...CFGDDNSC 40 CFGDDSCR 80 CFGDISVF 40 CFGENGLS 80 CFGFLAG1 000001 17 CFGFRNCH 10 CFGGERMN 20 CFGITALN 40 CFGLANG 000001 18 CFGLIBFX 80 CFGLNGTH 1A CFGMXLSM 100 CFGNMACS 000002 0C CFGSCRAL 01 CFGSCRBL 04...

Page 604: ...T DESCRIPTORS SECTION HSTHOSTS CONSISTS OF 1 ENTRY PER GENNED HOST EACH OF WHICH MAY BE MAPPED BY THE FOLLOWING DSECT 0 0 STRUCTURE HSTHDMAP 0 0 CHARACTER 8 HSTHNAME HOST NAME 8 8 HEXSTRING 1 HSTINDEX...

Page 605: ...08 HSTR210 1 HSC 2 1 0 1 X 04 HSTR400 1 HSC 4 0 0 1 X 02 HSTR410 1 HSC 4 1 0 12 C CHARACTER 8 HSTNONEN NON LIBRARY ESOTERIC NAMES 20 14 CHARACTER 8 HSTLIBEN 16 LIBRARY ESOTERIC NAMES BY ACS 148 94 LEN...

Page 606: ...AG1 000001 09 HSTFLAG2 000001 0A HSTFLAG3 000001 0B HSTFXLEN 03 HSTHNAME 000008 00 HSTHOSLN 94 HSTHOSTS 03 HSTHSTAC 20 HSTINDEX 000001 08 HSTLIBEN 000008 14 HSTNHOST 000002 01 HSTNONEN 000008 0C HSTPR...

Page 607: ...RESERVED 8 8 CHARACTER 8 CDSENQNM CDS MAJOR ENQUEUE NAME 16 10 CHARACTER 8 CDSLEVEL CDS LEVEL VERSION RELEASE MOD LEVEL VV RR MM 24 18 CHARACTER 8 CDSCDATE DATE CDS CREATED MM DD YY NOTE SINGLE DIGIT...

Page 608: ...OL CDS VOLSER 50 32 HEXSTRING 2 RESERVED RESERVED 52 34 CHARACTER 8 CDSUNIT CDS UNIT NAME 60 3C HEXSTRING 2 CDSSWCNT CDS SWITCH COUNT 62 3E HEXSTRING 2 RESERVED RESERVED 64 40 HEXSTRING 4 RESERVED 4 R...

Page 609: ...CDSBTIME 000008 28 CDSCDATE 000008 18 CDSCTIME 000008 20 CDSDSN 000044 00 CDSENQNM 000008 08 CDSINFOL 50 CDSJOURN 20 CDSLEVEL 000008 10 CDSLNGTH 138 CDSNAMES 000240 48 CDSNONE 00 CDSRCVRY 000001 01 CD...

Page 610: ...NFXLEN LENGTH OF FIXED SECTION 2 02 OFFSET STNSTNS START OF ACS HOST STATION ARRAY STNSTNS CONSISTS OF 1 ENTRY PER GENNED HOST EACH OF WHICH MAY BE MAPPD BY THE FOLLOWING DSECT 0 0 STRUCTURE STNENTRY...

Page 611: ...mats 581 1st ed 6 30 04 312579601 Cross Reference Name Len Offset Value STNACS 000001 01 STNADDRS 000003 01 STNADENL 03 STNCUA 000002 01 STNENTLN 31 STNFLAG 000001 00 STNFXLEN 02 STNHINDX 000001 00 ST...

Page 612: ...ubpool labels or IDs Fields VOLSPLBL and VOLSPID are blank filled 3 When a volume has been mounted the VOLERMNT and VOLERACT bit values are both set in VOLFLAG2 If the volume is errant the VOLERMNT bi...

Page 613: ...NG 1 VOLOHID OWNING HOST ID 4 4 SIGNED FWORD 4 VOLSELCT VOLUME SELECTION COUNT 8 8 CHARACTER 6 VOLSER VOLUME SERIAL NUMBER LEFT JUSTIFIED AND BLANK FILLED 14 E CHARACTER 14 VOLHMLOC HOME LOCATION 14 E...

Page 614: ...LWORD OF THE CPU TOD CLOCK VALUE WHEN THE VOLUME WAS RESPECTIVELY ENTERED INTO THE LIBRARY LAST SELECTED AND LAST MOUNTED FOR EACH OF THESE FIELDS THE LOW ORDER BIT BIT 31 HAS A VALUE EQUAL TO 2 TO TH...

Page 615: ...TRING 1 VOLFLAG3 VOLUME FLAG BYTE 3 1 X 80 VOLD4YR INDICATES DATE FORMAT ON YYYYMMDD FORMAT OFF MM DD YY FORMAT 1 X 20 VOLMNDSM AFFECTS VOLDTMNT VOLTMMNT FLDS ON TIME DATE LAST MOUNTED 02 OFF TIME DAT...

Page 616: ...1 VOLITRTN RECOVERY ROUTINE FLAG IN TRAN ON 1 X 04 VOLRRAUS 1 AUDIT START 1 X 08 VOLRRALD 1 AUDIT LOGICAL DELETE 1 X 10 VOLRRMNT 1 MOUNT 1 1 X 14 VOLRRDEJ 1 1 DISMOUNT EJECT 1 1 X 18 VOLRRCLU 1 1 CLE...

Page 617: ...ING DSECT 0 0 STRUCTURE VOLLOC 0 0 CHARACTER 1 VOLSTYPE SOURCE TYPE 1 F1 CHAR CONST VOLSCELL CELL 2 F2 CHAR CONST VOLSCAP CAP 3 F3 CHAR CONST VOLSDRIV DRIVE 4 F4 CHAR CONST VOLSOTHR OTHER 1 1 HEXSTRIN...

Page 618: ...IVE INDEX NUMBER 4 4 HEXSTRING 1 RESERVED RESERVED 5 5 BITSTRING 1 VOLSDFLG DRIVE FORMAT FLAG 1111 1111 X FF VOLSDFIX DRIVE IS DRIVE INDEX FORMAT 6 6 HEXSTRING 2 RESERVED RESERVED FOR OTHER TYPES THIS...

Page 619: ...80 VOLERACT 80 VOLERDSC 10 VOLERHSC 04 VOLERLIL 40 VOLERLSC 08 VOLERMNT 02 VOLERSSC 20 VOLEXLBL 20 VOLEXRD 10 VOLFLAG1 000001 02 VOLFLAG2 000001 78 VOLFLAG3 000001 74 VOLHMACS 000002 0E VOLHMCEL 00000...

Page 620: ...4 VOLMEDIA 000001 01 VOLMEDST CVAL VOLMEDTA CVAL VOLMEDTB CVAL VOLMEDTC CVAL VOLMEDTD CVAL VOLMEDTE CVAL VOLMEDTJ CVAL VOLMEDTP CVAL VOLMEDTR CVAL VOLMEDTU CVAL VOLMEDTW CVAL VOLMEDTZ CVAL VOLMEDT1 CV...

Page 621: ...8 VOLRRVDL 28 VOLSACSN 000001 01 VOLSCAP CVAL VOLSCELL CVAL VOLSCLOC 000002 03 VOLSCOLN 000001 05 VOLSCR 80 VOLSDFIX FF VOLSDFLG 000001 05 VOLSDIDS 000001 03 VOLSDNUM 000001 04 VOLSDPNL 000001 03 VOLS...

Page 622: ...579601 VOLSPNLN 000001 03 VOLSPNON CVAL VOLSPNSL CVAL VOLSPSL CVAL VOLSRCE 000006 7E VOLSROWN 000001 04 VOLSTYPE 000001 00 VOLTDINS 000004 38 VOLTDMNT 000004 40 VOLTDSEL 000004 3C VOLTMINS 000008 4C V...

Page 623: ...istributed macros map only Batch API records Refer to Volume Report and Batch API Records on page 562 to see the records that map both Volume Report and Batch API Table 64 Mapping macros for Batch API...

Page 624: ...N DRIVE NEEDS CLEANING 2 2 BITSTRING 1 UVDFLAG2 MOUNT ERROR FLAG 1 X 80 UVDBMNT MOUNT ERROR 1 X 40 UVDOPRQ OPER INTERV REQD BY UX01 1 X 20 UVDV5310 IAT5310 ERROR MESSAGE ISSUED 3 3 BITSTRING 1 UVDFLAG...

Page 625: ...HEXSTRING 1 UVDIDLSM DRIVEID LSM 8 8 HEXSTRING 1 UVDIDPNL DRIVEID PANEL 9 9 HEXSTRING 1 UVDIDNUM DRIVEID NUMBER WITHIN PANEL 12 C SIGNED FWORD 4 UVDDEFIN DRIVE IS DEFINED TO A HOST BIT MAP REPRESENTIN...

Page 626: ...08 UVDLEN 34 UVDLUNIT 000002 12 UVDNOLMU FFFF UVDNSCR 40 UVDNUNIT 000002 10 UVDOPRQ 40 UVDRACF 10 UVDREDW CVAL UVDRT 000001 00 UVDSCR 80 UVDSILV CVAL UVDTIMB CVAL UVDTMS7 08 UVDTYPE 000002 04 UVDUNITN...

Page 627: ...Appendix C Record Formats 597 1st ed 6 30 04 312579601 UVD994B5 CVAL Name Len Offset Value...

Page 628: ...F1AUT CAP IS IN AUTOMATIC MODE 1 X 10 UVPF1LNK CAP IS LINKED 1 X 08 UVPF1ONL CAP IS ONLINE 2 2 BITSTRING 1 UVPFLAG2 CAP MODE 1 X 80 UVPF2ENT CAP IS ENTERING 1 X 40 UVPF2DRA CAP IS DRAINING 1 X 20 UVPF...

Page 629: ...EXSTRING 1 UVPPANEL PANEL NUMBER OF CAP 51 33 BITSTRING 1 UVPTYPE TYPE OF CAP 1 X 80 UVPPCAP PRIORITY CAP 1 X 01 UVPCIM CIMARRON 1 X 02 UVPCLIP CLIPPER 11 X 03 UVPTWSTD STANDARD WOLF CLIPPER 1 X 04 UV...

Page 630: ...UVPF1LNK 10 UVPF1ONL 08 UVPF1REC 40 UVPF2CLN 10 UVPF2DRA 40 UVPF2EJT 20 UVPF2ENT 80 UVPF2IDL 08 UVPHOST 000008 0E UVPHOSTI 000001 16 UVPID 000003 03 UVPJOBN 000008 06 UVPLEN 34 UVPLPRIO 000002 20 UVPN...

Page 631: ...Appendix C Record Formats 601 1st ed 6 30 04 312579601 UVPTWSTD 03 UVPTYPE 000001 33 UVP9740 05 Name Len Offset Value...

Page 632: ...602 VM HSC 6 0 System Programmer s Guide 1st ed 6 30 04 312579601...

Page 633: ...location move it and place it at another location When the Catalog or VIew commands are used the count is the number of times the robot hand is moved to a target location The Robotics Motion Start Cou...

Page 634: ...ach time a permanent motion failure occurs complete information concerning the failure is logged A permanent error is counted against any motion which causes a Mount DISMount Swap MOVe Catalog or VIew...

Page 635: ...esent Such a record is called an LLG6 record Refer to Appendix C Record Formats on page 497 to see the record layout for LLG6 Table 67 Format for Total Motions and Temporary Error Counts Initiated and...

Page 636: ...ry 56 59 LSM 1 Robotic motions started binary 60 63 LSM 1 Temporary motion error counts binary 64 67 LSM 2 Robotic motions started binary 68 71 LSM 2 Temporary motion error counts binary 72 75 LSM 3 R...

Page 637: ...motions started binary 132 135 LSM 10 Temporary motion error counts binary 136 139 LSM 11 Robotic motions started binary 140 143 LSM 11 Temporary motion error counts binary 144 147 LSM 12 Robotic mot...

Page 638: ...TIME macro was used 03 03 X 20 indicates record contains an error ID 04 05 Reserved 06 06 Record count 07 07 Reserved 08 11 System date of error 12 15 System time of error 16 23 CPU ID 24 31 Subsystem...

Page 639: ...t Operations that are automatically retried by the HSC are usually not errors and some other states may be defined that are not logged as errors See LMU Response Codes on page 611 for information on e...

Page 640: ...multi host environment than in a single host environment For this reason more explanation is necessary Since the LMU counts robotic motions started and temporary errors by LSM and not by host when an...

Page 641: ...ons of whether a console message is generated indications of whether a LOGREC record is cut indications of whether this response code is included as an R hard fail or if it is excluded Symbols used in...

Page 642: ...lumn M L H H H H H H 0113 No cell at the specified address M L H H H H H H 0114 Label modifier option not legal M L H H H H H H 0115 Source modifier option not legal M L H H H H H H 0116 Source type i...

Page 643: ...CAP does not exist M L H H H H H H Table 71 LMU Response Codes 0301 thru 0310 LMU Resp Response Description Con Msg LOG rec Mnt B Dmt C Swp D Mov E Cat J K Vw X 0301 CAP not reserved M L H H H H H H 0...

Page 644: ...full M L H H H H 0407 Multiple LSM requests in maintenance M L H H H H H H 0408 Path rejected due to full PTP deadlock M L H H H H H H 0410 Bad recovery on cartridge VOLSER M L H H H H H H 0411 Maximu...

Page 645: ...r r 0504 Transmission rejection Transmission error M r r r r r r 0505 Transmission rejection No ACK M r r r r r r 0506 Transmission rejection No operational LAN M r r r r r r 0507 Transmission reject...

Page 646: ...604 Bad qualifier byte 2 M L H H H H H H 0605 LSM online M L H H H H H H 0606 Offline pend overridden M L H H H H H H 0610 Unknown panel type from static configuration M L H H H H H H 0611 Internal lo...

Page 647: ...705 CAP is not operational M L H H H H H H 0707 Necessary elements inoperational M L H H H H H H 0708 Failed robotics portion of move M L H H H H H H 0709 Bad PUT M L H H H H H H 0710 Bad GET M L H H...

Page 648: ...s 0901 thru 0977 LMU Resp Response Description Con Msg LOG rec Mnt B Dmt C Swp D Mov E Cat J K Vw X 0901 Wrong LSM on GET response M L H H H H H H 0902 Packet type of response not received M L H H H H...

Page 649: ...H H 0952 Hand empty M L H H H H H H 0953 Drive full M L H H H H 0955 CAP is currently unlocked M L H H H H H H 0956 Can t unlock CAP in idle M L H H H H H H 0957 CAP is open M L H H H H H H 0958 CAP i...

Page 650: ...l M L H H H 1003 Outstanding request for drive M L H H H H 1004 Drive is allocated M L H H H H 1005 Drive already has cartridge in it unload timeout M L H H H H 1006 Drive found online for diagnostic...

Page 651: ...6 30 04 312579601 Appendix E Remote linked Libraries Overview This appendix contains illustrations of configurations for remote linked libraries In addition programming and operational considerations...

Page 652: ...e ACS remote linked to one CPU The primary secondary and standby control data sets all run on the one CPU HSC OPERATING SYSTEM CH EXT CH EXT CH EXT ACS 0 LEGEND CHANNEL EXTENDER OPTIONAL C29323 MANUAL...

Page 653: ...nd standby control data sets all run on the one CPU Multiple Clients on a Local Area Network C51183 Primary Control Data Set Data Path ESCD TCP IP Path for Robotic Control SL8500 Library Corporate Eth...

Page 654: ...to it The primary and secondary control data sets run on separate SSDs each attached to separate CPUs The standby control data set can be attached to either SSD LMU LMU LEGEND CHANNEL EXTENDER OPTIONA...

Page 655: ...to another CPU with one ACS local to it The primary and secondary control data sets run on separate SSDs each attached to separate CPUs LEGEND CHANNEL EXTENDER OPTIONAL CH EXT LMU LMU CH EXT CH EXT CH...

Page 656: ...tion a third ACS is remote linked to both CPUs The primary and secondary control data sets run on separate SSDs each attached to separate CPUs LEGEND CHANNEL EXTENDER OPTIONAL CH EXT LMU LMU LMU CH EX...

Page 657: ...urnals from Channel Extended Hosts In configurations 3 4 and 5 if a restore of the control data set is needed and the journaling option is invoked all journal files must be obtained from every host th...

Page 658: ...rform a full audit operation Execute the BACKup utility specifying OPTion Analyze immediately followed by the RESTore utility specifying GENerate YES The BACKup utility performs error and comparison c...

Page 659: ...xecutes a single query operation to obtain data set information for CDS dynamic allocation All other request processing occurs in the user address space QCDS requests are limited to a single task with...

Page 660: ...UREQ program VCON the SLSUCAL TXTLIB must be available at CMS command LOAD GENMOD time When SLSUCAL is loaded using the LOAD macro the SLSUCAL TXTLIB must be available at program execution time The SL...

Page 661: ...he first record of the area READ specifies to retrieve the next group of library element records CLOSE specifies to close a library element area This parameter is required TYPE type indicates a librar...

Page 662: ...2 containing the response area length for this READ request This parameter is required for the READ request but is ignored for OPEN and CLOSE requests TOKEN token indicates an RX type fullword locatio...

Page 663: ...CALADR rtnaddr indicates an RX type fullword location register 15 or a register 2 12 containing the address of the SLSUCAL routine This parameter is required You must load the SLSUCAL module into stor...

Page 664: ...id record area type SLUROPIO 16 Open failed I O error while accessing the associated CDS SLUROPDD 20 Open failed An input CDS is not allocated to the designated DDname SLUROPNA 24 Open failed HSC addr...

Page 665: ...ut does require an operational HSC address space After opening the CDS volume record area the program reads groups of volume records into a 64 KB response area buffer SLURRDBA 24 Read failed Attempt t...

Page 666: ...odule work area STM R14 R12 12 R13 Save registers LR R12 R15 Load base register R12 USING QCDSVTV R12 Declare CSECT base register R12 GETMAIN R LV WKAREAL Allocate module work area ST R13 WKSAVE WKARE...

Page 667: ...esponse area L R0 QCDSBLEN Load response area buffer length GETMAIN R LV 0 Request storage ST R1 WKBUFP Store pointer to response area LR R10 R1 Load pointer to response area USING SLUR R10 Map QCDS R...

Page 668: ...OK UCALADR WKUCAL MF E WKQCDS LTR R15 R15 Check for CLOSE failure BNZ CLOSEERR Handle CLOSE error B EXIT READERR WTO READ ERROR B EXIT CLOSEERR WTO CLOSE ERROR B EXIT Clean up and return to caller OPE...

Page 669: ...LATDDL EQU KFLATDD Module work area map WKAREA DSECT Module work area WKSAVE DS 18F MVS register save area WKUCAL DS A SLSUCAL routine address WKTOK DS F QCDS request token WKRDRC DS F QCDS READ retur...

Page 670: ...79601 Sample 2 Reading the ACS and DRV Record Areas Together This sample QCDS request reads two different CDS record areas ACS and DRV alternating between the two The job step JCL must include a DDNAM...

Page 671: ...REGISTER SAVE AREA STM R14 R12 12 R13 SAVE REGISTERS LR R12 R15 LOAD BASE REGISTER R12 USING QACSDRV R12 DECLARE CSECT BASE REGISTER R12 GETMAIN R LV WKAREAL ALLOCATE MODULE WORK AREA ST R13 WKSAVE WK...

Page 672: ...CESSING LOOP LA R9 WKACSBUF POINTER TO ACS RESPONSE AREA SLSUREQ QCDS READ ACS RECORD AREA REQUEST READ TYPE ACS BUFFER R9 BUFLEN QCDSBLEN TOKEN WKTOK UCALADR WKUCAL MF E WKQCDS L R7 SLURQCDO OFFSET T...

Page 673: ...MODULE WORK AREA L R13 4 R13 RESTORE CALLER S SAVE AREA FREEMAIN R A R1 LV WKAREAL RELEASE MODULE WORK AREA L R14 12 R13 RESTORE RETURN ADDRESS LM R0 R12 20 R13 RESTORE CALLER S REGISTERS 0 12 XR R15...

Page 674: ...are SMP distributed and are discussed in Volume Report and Batch API Mapping Macros on page 562 Table 82 Library Element Record Mapping Request Entered Records Returned READ ACS ACS LSM records mappe...

Page 675: ...6 30 04 312579601 SLSUREQM Macro The SLSUREQM mapping macro must be specified in any assembly that uses the SLSUREQ macro Syntax Parameters PRO NO YES Specifies whether the prologue should be generat...

Page 676: ...RT REQUEST TYPE 1 01 CONST SLSUQCDS QCDS REQUEST 6 6 A ADDR 1 SLSUQCDT QCDS REQUEST TYPE 0 00 CONST SLSUQCDO OPEN REQUEST 1 01 CONST SLSUQCDR READ REQUEST 2 02 CONST SLSUQCDC CLOSE REQUEST 7 7 A ADDR...

Page 677: ...SLURRQPL SLSUREQ REQUEST FAILED INVALID SLSUREQ PARAMETER LIST 1001 3E9 CONST SLURRQRT SLSUREQ REQUEST FAILED INVALID SLSUREQ UTILITY REQUEST TYPE 1002 3EA CONST SLURQCRT SLSUREQ REQUEST FAILED INVAL...

Page 678: ...FAILED I O ERROR WHILE ACCESSING THE ASSOCIATED CDS 20 14 CONST SLUROPDD OPEN FAILED AN INPUT CDS IS NOT ALLOCATED TO THE DESIGNATED DDNAME 24 18 CONST SLUROPNA OPEN FAILED HSC ADDRESS SPACE NOT OPERA...

Page 679: ...AREA THAT IS NOT CURRENTLY OPEN 24 18 CONST SLURRDBA READ FAILED ATTEMPT TO READ BEYOND THE END OF THE RECORD AREA 28 1C CONST SLURRDIB READ FAILED INVALID RESPONSE AREA BUFFER ADDRESS 32 20 CONST SL...

Page 680: ...0 CONST SLURCLIO CLOSE FAILED I O ERROR WHILE ACCESSING THE ASSOCIATED CDS 16 10 LENGTH SLURRHLN LENGTH OF REPLY HEADER 16 10 AREA 4 SLURFRS START OF VARIABLE LENGTH FORMATTED RECORD SEGMENT Table 83...

Page 681: ...3 SLSUDRVA 04 SLSUHDR 000004 00 SLSUHSTA 05 SLSUID CVAL SLSULN 148 SLSUMVCA 08 SLSUQCDA 000001 07 SLSUQCDB 000004 0C SLSUQCDC 02 SLSUQCDD 000004 14 SLSUQCDK 000004 08 SLSUQCDL 000004 10 SLSUQCDO 00 SL...

Page 682: ...ROPAO 04 SLUROPDA 1C SLUROPDD 14 SLUROPDM 20 SLUROPIO 10 SLUROPIT 08 SLUROPNA 18 SLUROPOK 00 SLUROPRA 0C SLURQCDN 000004 08 SLURQCDO 000004 0C SLURQCRT 3EA SLURRDBA 18 SLURRDEA 04 SLURRDIB 1C SLURRDIL...

Page 683: ...Appendix F Batch Application Program Interface API 653 1st ed 6 30 04 312579601...

Page 684: ...654 VM HSC 6 0 System Programmer s Guide 1st ed 6 30 04 312579601...

Page 685: ...from 1 to 16 attached LSMs automated library See library automatic mode A relationship between an LSM and all attached hosts LSMs operating in automatic mode handle cartridges without operator interv...

Page 686: ...ge Drive CDRM Cross Domain Resource Manager definition if not using existing CDRMs CDRSC Cross Domain Resource definition CDS See control data set CE Channel End CEL Customer Emulation Lab cell A stor...

Page 687: ...storage administrator that are used to create a data set data compaction An algorithmic data reduction technique that encodes data from the host and stores it in less space than unencoded data The or...

Page 688: ...f tape position drive panel A wall of an LSM that contains tape transports Drive panels for 9840 transports have either 10 or 20 transports per panel drive panels for all other transports contain up t...

Page 689: ...Port standard CAP priority CAP WolfCreek CAP WolfCreek optional CAP or TimberWolf CAP Enhanced Capacity Cartridge System Tape Cartridge system tape with increased capacity that can be used with 4490 a...

Page 690: ...Cartridge System which executes on host systems attached to an automated library This component acts as the interface between the operating system and the rest of the automated library host system A...

Page 691: ...Kilobyte thousand 10 3 bytes keyword parameter In command and utility syntax operands that include keywords and their related values See positional parameter Values are concatenated to the keyword eit...

Page 692: ...LIBGEN The first LSM listed in this parameter acquires the LSM number of 00 hexadecimal the second LSM listed acquires a hexadecimal number of 01 and so forth until all LSMs are identified maximum of...

Page 693: ...tridge may not be able to adequately clean a tape transport however it can be mounted and will attempt to execute the cleaning process See also spent cleaning cartridge over use cleaning cartridge A c...

Page 694: ...asured per unit of length of the recording medium RECtech The parameter used to specify recording technique RedWood 1 The program name of the StorageTek transport that supports a helical recording tec...

Page 695: ...d to clean tape transports See also over limit cleaning cartridge SSD Solid state disk STAM See Shared Tape Allocation Manager Standard 1 A value that can be specified on the MEDia parameter and that...

Page 696: ...The assumption of master LMU functionality by the standby LMU SYNCSORT Third party software by Syncsort Inc a sort merge copy utility program System Control Program The general term to describe a pro...

Page 697: ...tribute Record VAT See Volume Attribute Table Entry Virtual Storage Manager VSM A storage solution that virtualizes volumes and transports in a VTSS buffer in order to improve media and transport use...

Page 698: ...can be specified on the RECtech parameter and includes all 18 track transports 3480 1 A value that can be specified on the MEDia parameter and that includes only standard capacity cartridge tapes 2 An...

Page 699: ...load unload than a 3490E device 9490EE Cartridge Subsystem A high performance tape transport that provides read write capability for Extended Enhanced tape EETape cartridges It is functionally equival...

Page 700: ...1st ed 6 30 04 312579601 670 VM HSC 6 0 System Programmer s Guide...

Page 701: ...emote linked libraries 627 Allocation ALLOC command and control statement 466 AUDIt utility parameters DIAGScan 206 EMPTYCel 206 INTRANs 207 Audit utility actions permitted 200 function 200 invoking 2...

Page 702: ...rWolf defined 666 WolfCreek optional defined 668 WolfCreek defined 668 Cartridge Drive CD defined 656 Cartridge Scratch Loader CSL defined 656 cartridges ejecting 47 entering into library 46 into the...

Page 703: ...tion to avoid future reconfiguration 51 Definition data set control statements OPTion TITLE 113 overview 102 103 Tape request TAPEREQ 118 Tape request definition TREQDEF 133 Unit Attribute Definition...

Page 704: ...acting to 392 requesting 391 types supported 391 Dynamic Device Reconfiguration DDR defined 658 dynamic LMU connection 70 E ECART defined 658 ECCST defined 659 Eject cartridge utility invoking 246 JCL...

Page 705: ...78 installation 20 intitialization termination 21 LMU server 66 mount and dismount 30 33 overview 19 user control of 16 utility 65 volume cell control 43 G GDG See generation data groups Gdgall parame...

Page 706: ...7 PARM statement 178 Audit utility 208 Backup utility 219 Database Decompile utility 227 defined 661 Directory Rebuild utility 238 Eject cartridge utility 247 Enter cartridge utility 251 Journal offlo...

Page 707: ...xamples 97 parameters 96 CUSTomer 96 EXPRdate 96 KEY 97 PRODuct 96 SITEno 96 syntax 96 LMU See Library Management Unit LMUPATH control statement 108 parameters 108 ACS 108 LMUADDR 109 syntax 108 LMUPA...

Page 708: ...Flat File CDS Information DSECT 577 SLUVPDAT Batch API CAP Information DSECT 598 SLUVSDAT Flat File ACS Station Address DSECT 562 SLUVVDAT Flat File Volume Data DSECT 582 master LMU defined 662 matchi...

Page 709: ...METHod 467 MIXED 183 MMount 480 MOuntmsg 480 NEWHOST 310 NOHDR 183 OFF 484 OFFline 478 ONline 478 OUTput 484 Output 482 panel 481 PASSTHRU 480 PGMI 478 483 PLaygrnd 485 prefvlue 466 Primary 466 PRIVAT...

Page 710: ...parameter defined 663 PowderHorn 9310 LSM defined 663 precedence of VOLATTR and TAPEREQ statements 30 primary CDS defined 664 print a list of volumes locations in an LSM 170 library activities report...

Page 711: ...nked libraries 627 Restore utility benefits 276 function 276 invoking 279 JCL examples 279 JCL requirements 278 output description 281 overview 276 parameters 277 prerequisites 276 syntax 277 S SCP ab...

Page 712: ...ro 447 SLKJCL file creating for HSC start 157 SLSSBLOG LOGREC Initialization Termination Record 533 SLSSBLOG LOGREC Macro 533 SLSSBLOS SMF Macro 506 SLSSCAPJ SMF Macro 508 SLSSCAPN SMF Macro 509 SLSSD...

Page 713: ...d control statement 482 OPTion TITLE control statement 113 Performance log reblocker 263 Reconfiguration CDS Definition RECDEF control statement 98 Reconfiguration CDS Definition RECDEF control statem...

Page 714: ...ol statement examples 139 overview 136 parameters 137 syntax 137 usage 136 UNSCratch utility 464 invoking 296 JCL example 297 JCL requirements 296 output description 297 overview 295 parameters 296 sy...

Page 715: ...ords SLUVADAT Flat File ACS LSM Information DSECT 563 SLUVCDAT Flat File Static Configuration Data DSECT 571 SLUVHDAT Flat File Host Information DSECT 574 SLUVIDAT Flat File CDS Information DSECT 577...

Page 716: ...686 VM HSC 6 0 System Programmer s Guide 1st ed 6 30 04 312579601...

Page 717: ......

Page 718: ...Printed in U S A...

Reviews: