VSAM Utility panel
The following table describes the values that you should enter in the fields on this panel:
Field | Description |
|---|---|
OPTION | Enter one of the following VSAM utility options.
|
Specify Dataset Information | |
Dataset name | Specify the cluster name. In the case of allocate (cluster, alternate index, or path), specify the new cluster name. See VSAM data set naming conventions. Pattern dataset names are supported for options B, BLANK, D, DR, R, and M. You can enter a pattern dataset name in this field to display a list of data sets from which you can make a selection. A pattern dataset name or mask consists of explicit characters or a combination of explicit and pattern characters. For more information, see Pattern data set names in Specifying-a-data-set-name-with-example. Enter the FILELIST primary command or blank out the Dataset name field to display the Last Referenced File List. For more information, see Last Referenced File List. |
Volume serial | Specify the volume serial of the direct access device that contains the data set. File-AID displays an error message when the Volume serial field and the Catalog name fields both contain data. |
Processing Option | Valid values are as follows:
For Batch and Formatted Batch information, see Online Processing and Batch/IDCAMS Processing. |
Specify Optional Model Dataset Information for Allocation | |
Dataset name | (Optional) Specify the name of an existing data set in this field to have File-AID copy the allocation attributes from the model data set. The model data set must be cataloged and must be accessible through a normal catalog search. You can enter a pattern dataset name in this field to display a list of data sets from which you can make a selection. A pattern dataset name or mask consists of explicit characters or a combination of explicit and pattern characters. For more information, see Pattern data set names in Specifying-a-data-set-name-with-example. When a model dataset name is specified, the attributes of the model data set are displayed on the dataset allocation screen. As in the File-AID Dataset utility, the model data set can be of any access method; it need not be a VSAM dataset. Enter the FILELIST primary command or blank out the Dataset Name field to display the Last Referenced File List. For more information, see Last Referenced File List. |
Specify Catalog to use if other than Default System Catalog: | |
Catalog name | Specify a catalog name to override the default system catalog. This catalogs the data set in a catalog not connected to the master catalog through the high-level index name. File-AID displays an error message when the Volume serial field and the Catalog name fields both contain data. |
VSAM data set naming conventions
Like ISPF, when a dataset name is typed within single quotes ( ' ' ), File-AID uses the name exactly as entered. When a dataset name is entered without single quotes, the TSO prefix is concatenated to the beginning of the entered name. File-AID carries this convention further when VSAM clusters are allocated.
File-AID creates VSAM dataset names from both user-defined values and from values set at product installation time. File-AID creates the levels of qualifiers of a VSAM dataset as follows:
- The high-level qualifier is generated from the system value set when File-AID is installed.
- The second-level qualifier is generated from the value specified in the VSAM Intermediate Name field on the System Parameters screen. See System parameters. When an unqualified dataset name is entered in this field, the fully qualified value is created by concatenating the VSAM high-level name, VSAM intermediate name, and unqualified name. Any value of up to 19 characters is allowed for the VSAM intermediate name.
- The lower-level qualifiers are generated from the value entered in the Dataset name field of the VSAM Utility screen. For example, if you enter:
in the Dataset name field, and the VSAM Intermediate Name field contains a value of TSOID01, and the system VSAM high-level qualifier is ABC, File-AID creates a VSAM cluster name of: ABC.TSOID01.NEW.VSAM.
Online processing
When processing the VSAM utility online (O for Processing Option) and the appropriate field values are entered, File-AID redisplays the VSAM Utility screen with a message confirming task completion. If the function fails, File-AID displays an error message in the upper-right corner of the IDCAMS Functions Display panel:
IDCAMS Function Display panel
COMMAND ===>
Use VIEW command to browse the IDCAMS control cards and messages
Use END to return to utility menu
Use the VIEW primary command to browse the IDCAMS control cards and error messages, as shown in the following figure.
IDCAMS Error Message Display Screen
COMMAND ===> SCROLL ===>
IDCAMS SYSTEM SERVICES TIME: 15:06:0
3 09/06/95 PAGE 1
MARGINS(1 2000)
IDC0001I FUNCTION COMPLETED, HIGHEST CONDITION CODE WAS 0
DEFINE ALTERNATEINDEX (NAME(USERID9.FRED.SAMPLE) RELATE(USERID9.FASAMP.EMPLOYEE
) VOLUMES(PRD925) BUFFERSPACE(6144) OWNER
(USERID9) RECORDSIZE(80 3120) REUSE SHAREOPTIONS(3 3) SPEED STAGE UNIQUEKEY) DA
TA(NAME(USERID9.FRED.SAMPLE.DATA) TRACKS(
1 1) CONTROLINTERVALSIZE(2048)) INDEX(NAME(USERID9.FRED.SAMPLE.INDEX))
IGD17103I CATALOG ERROR WHILE DEFINING VSAM DATA SET USERID9.FRED.SAMPLE
RETURN CODE IS 80 REASON CODE IS 0 IGG0CLET
IGD306I UNEXPECTED ERROR DURING IGG0CLET PROCESSING
RETURN CODE 80 REASON CODE 0
THE MODULE THAT DETECTED THE ERROR IS IGDVTSCU
SMS MODULE TRACE BACK - VTSCU VTSCT VTSCH VTSCG VTSCD VTSCC VTSCR VTSUC
SSIP4
SYMPTOM RECORD CREATED, PROBLEM ID IS IGD00151
IGD17219I UNABLE TO CONTINUE DEFINE OF DATA SET USERID9.FRED.SAMPLE
IDCAMS SYSTEM SERVICES TIME: 15:06:0
3 09/06/95 PAGE 2
IDC3022I INVALID RELATED OBJECT
IDC3009I ** VSAM CATALOG RETURN CODE IS 80 - REASON CODE IS IGG0CLET-0
Batch/IDCAMS processing
To enable batch/IDCAMs processing, enter VSAM processing option B (Processing Option) and the other appropriate field values on the VSAM Utility panel, and press Enter. File-AID displays the JCL Specification panel, as shown in the following figure.
Processing Options I (Batch IDCAMS) and B (Batch) are exactly the same unless you are using the Delete, Rename, or Delete/Redefine VSAM function. For these functions, IDCAMS creates IDCAMS JCL control cards to perform the task, whereas Batch creates File-AID/MVS JCL control cards for the task.
JCL Specification Screen
COMMAND ===>
JCL Information for Batch Processing:
Sysout class ===> *
JOB Statement Information:
===> //USERID9 JOB ('OFAQC8.0.0',81),'AUDIT',
===> // CLASS=P,NOTIFY=USERID9,MSGCLASS=R
===>
===>
Use JCL command to edit generated JCL
Use SUBMIT command to submit batch job
Use END to return to main panel without submitting job
The following table describes the commands that you should enter on this panel:
Command | Description |
|---|---|
JCL | File-AID generates the JCL to process the job and displays the Generated JCL screen, as shown in the following figure. |
SUBMIT | SUBMIT primary command to submit the batch job. |
END | Use the END command (PF3) to terminate the current request. |
Generated JCL Edit Screen
COMMAND ===> SCROLL ===> PAGE
****** ***************************** TOP OF DATA ******************************
000001 //USERID9A JOB (ACCOUNT),’your name’,
000002 // CLASS=A,MSGCLASS=A,NOTIFY=USERID9
000003 //* YOU ARE VIEWING JCL THAT FILE-AID/MVS HAS GENERATED TO
000004 //* PERFORM THE REQUIRED FUNCTION.
000005 //*
000006 //* YOU CAN CHANGE THIS JCL IF DESIRED AND USE THE SUBMIT PRIMARY
000007 //* COMMAND TO SUBMIT THE JOB. THE CREATE OR REPLACE PRIMARY COMMAND
000008 //* CAN BE USED TO KEEP THIS JOBSTREAM FOR FUTURE USE.
000009 //*
000010 //* USE THE END COMMAND TO EXIT WITHOUT SUBMITTING THE JOB.
000011 //JS10 EXEC PGM=IDCAMS
000012 //SYSPRINT DD SYSOUT=*
000013 //SYSIN DD *
000014 DEFINE CLUSTER -
000015 (NAME(USERID9.FASAMP.EMPLOYE1) -
000016 BUFFERSPACE(6144) -
000017 INDEXED -
000018 KEYS(5 0) -
000019 MANAGEMENTCLASS(SAMPLE@S) -
000020 OWNER(USERID9) -
000021 RECORDSIZE(198 198)
You can edit and submit the generated JCL, and save it to run or rerun later.