Utility Functions › VSAM Utility

VSAM Utility

The VSAM Utility performs many commonly needed functions related to the definition, management, and use of VSAM files. Each of the functions, except display of data set information, is performed either online or batch depending on the Execution Mode.

----------------  CA File Master Plus -- VSAM Utility  --------------
COMMAND ===>                                                                   
                                                                               
BLANK - Display Data Set Information      I - Define Alternate Index           
    V - Define VSAM File                 B - Build Alternate Index             
    K - Delete VSAM File                 P - Define Path                       
    D - Delete/Define VSAM File          R - Rename Component                  
                                         M - Modify VSAM File                  
                                                                               
Data set to be processed                                                       
   Data set name  ===> 'ABC.CIRCLE.KSDS01'                                     
                                                                               
Model VSAM data set for allocations (optional)                                 
   Data set name  ===> 'ABC.CIRCLE.KSDS01'                                     
                                                                               
Saved IDCAMS control statements (optional)                                     
   Data set name  ===> 'TECH.WORKPDS'                                          
   Member name   ===>                                                          
                                                                               
Execution mode   ===> O                  O = Online                            
                                         S = Submit JCL                        
                                         E = Edit JCL                          
                                                                               
                                                                               

For the functions of defining a VSAM cluster or defining an alternate index file, specify a model data set to request that the various allocation parameters default to match the allocation of the model data set.

All of the functions, except Display of Data Set Information, are performed by building IDCAMS control statements and then executing IDCAMS. The generated control statements are copied to a PDS member specified in the Saved IDCAMS control statements section of the screen.

Select one of the following options:

• BLANK – Displays information related to the VSAM definition, allocation parameters and options, and record-level activity statistics. The display of information about the VSAM file is formatted according to VSAM access method.
• V – Define VSAM file
• K – Delete VSAM file
• D – Delete/Define VSAM file
• I – Define Alternate Index
• B – Build Alternate Index
• P – Define a path to be used to access a VSAM cluster (through an AIX or as an alias)
• R – Alter a VSAM file definition to rename components of a cluster, alternate index, or path
• M – Alter a VSAM file to modify allocation parameters, allocated volumes, or SMS class

To assist in the specification of DSNs, each of the DSN fields on this screen has support for wildcarded DSN and DSN Lists. Any of the following syntaxes can be used to request a list of DSNs from which the desired DSN may be selected

• Wildcarded DSN containing an asterisk (*) or a percent sign (%) for unknown characters of the DSN
• D to request a directory of DSN Lists
• D dddddd where 'dddddd' is the name of a DSN list

Note: A wildcarded member name can be specified in the Saved IDCAMS control statements member to request a directory of members that match the wildcard.

Field Descriptions

Data set to be processed - Data set name

Type the DSN of the VSAM component to receive the processing associated with the specified command.

Model VSAM data set for allocations (Optional) – Data set name

When the processing command is V (Define VSAM File), D (Delete/Define VSAM File), or I (Define Alternate Index), a Model VSAM Data Set can be specified. When the Model VSAM Data Set is specified, the various allocation parameters are defaulted to match the allocation of the model data set.

Saved IDCAMS Control Statements – Data set name

The processing of each of the commands, except Display Data Set Information, is performed by generating IDCAMS control statements to perform the function and then executing IDCAMS with these control statements either online or in batch.

When a PDS and member name are specified within the Saved IDCAMS control statements area, these control statements are copied to the specified member.

Saved IDCAMS Control Statements – Member name

Member name into which generated IDCAMS control statements are saved.

Execution mode

The choices for Execution mode are:

• O – Perform the function online
• S – Generate and submit JCL to perform the function
• E – Generate JCL to perform thefunction and initiate an edit session on the JCL. Alter the JCL as needed and submit the JCL or save it to another location.