StorageTek Host Software Component 6 User Manual

Page of 718
154   VM/HSC 6.0 System Programmer’s Guide
1st ed., 6/30/04 - 312579601
Volume Attribute Definition (VOLDEF) Command and Control Statement 
The VOLDEF command and control statement is used to specify the definition data set 
that contains volume attribute (VOLATTR) statements. (Refer to “Volume Attribute 
(VOLATTR) Control Statement” on page 143
 for details on syntax and parameters.) The 
data set must be a sequential or a partitioned data set (PDS) with any valid record format 
(RECFM). Also, the data set must contain one or more VOLATTR statements. 
The VOLDEF statement can be specified in PARMLIB, or it can be issued as an operator 
command to dynamically load or reload volume attribute parameters. (Refer to 
‘‘PARMLIB Control Statements’’ in the HSC Installation Guide for an explanation of 
PARMLIB.) 
If a definition file is changed by a VOLDEF operator command, and if the change is to be 
permanent, you must update PARMLIB before restarting the HSC. If the definition file 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 the PARMLIB specification. Thus, VOLDEF can be used to temporarily change 
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 by 
those hosts. 
Notes:  
 1. StorageTek recommends that volume attributes be the same on all processors. This 
can be assured by defining the same volume attribute definition data set to all hosts. 
 2. When the VOLDEF command is issued, if the definition data set contains errors, an 
HSC message provides the parameter in error, a description of the problem, and the 
line number where the error occurred.If the definition data set contains errors, none 
of the attributes specified in the VOLATTR control statement(s) will be loaded (put 
into effect), which may cause the wrong scratch media to be mounted on a transport 
or the wrong transport to be allocated for a volume. Message SLS1627I is displayed 
if errors are encountered. If 50 errors are encountered, the remainder of the data set is 
not checked. Correct the problem and reissue the command. 
 3. The VOLDEF command and control statement executes at both base and full service 
levels of the HSC. 
 4. If you issue multiple VOLDEF statements, the last one processed is currently active. 
You can determine which VOLDEF statement is active by entering the Display 
VOLDEF command. 
 5. For additional information about syntax, refer to “Control Statement Syntax 
VOLDEF