Chapter 3. Allocating a VSAM Cluster
File-AID has a utility for managing VSAM datasets and IAM datasets. The features of this utility include:- Allocating clusters (KSDS, ESDS, RRDS, and LINEAR)
- Allocating alternate indexes
- Building alternate indexes
- Deleting objects
- Renaming objects
- Displaying detailed information
- Modifying cluster attributes
- Generating IDCAMS control statements
- Redefining (Delete/Define) clusters
- Allocating and deleting dataspaces
- Allocating IAM datasets.
3.1 Accessing the VSAM Utility (Option 3.5)
The VSAM utility is located on the File-AID Extended Utilities menu (option 3) as utility number 5.Steps:
- From the File-AID Primary Option Menu (not shown here), select option 3.5.
- Press <Enter>. File-AID displays the VSAM Utility screen as illustrated in Figure 3-1.
3.2 Choosing a VSAM Utility Option
The VSAM utility screen (Figure 3-1) is where you specify which VSAM option you want to perform and the necessary background information needed to process the request. The selected option is typed in the OPTION field near the top of the screen. Options for processing include:- A - Allocate VSAM or IAM file
- D - Delete any dataset
- DR - Delete/Define any VSAM dataset
- X - Allocate alternate index
- P - Allocate path
- B - Build index
- R - Rename clusters
- M - Modify cluster attributes
- blank - Display information on any dataset
+--------------------------------------------------------------------------------+ | File-AID --------------------- VSAM Utility --------------------------------| | OPTION ===> | | | | A - Allocate cluster D - Delete | | S - Allocate dataspace DR - Delete/Define | | X - Allocate alternate index T - Delete dataspace | | B - Build alternate index P - Allocate path | | BLANK - Display dataset information R - Rename component | | M - Modify component | | Specify Dataset Information: | | Dataset name ===> FASAMP.EMPMAST | | Volume serial ===> (Required for options S & T) | | | | Process Online or Batch ===> O (O = Online; B = Batch) | | | | Specify Model Dataset Information: | | Dataset name ===> | | | | Specify Catalog to use if other than Default System Catalog: | | Catalog name ===> | | Catalog password ===> (If catalog is password protected) | | -------------------------------------------------------------------------------| | For dataset allocations only, the optional model dataset is used to | | prefill the allocation information on the allocation panel. | +--------------------------------------------------------------------------------+
3.3 Using an Existing Dataset's Allocation Attributes
Processing information you supply includes:- Name of the dataset to act on
- How to process the option (online or batch)
- Name of a dataset to use as a model for allocation attributes (optional)
3.4 Allocating a Cluster
The Allocate cluster option (A) lets you allocate new VSAM clusters and IAM datasets online or in batch. All VSAM dataset types (KSDS, ESDS, RRDS, and LINEAR) are supported.Figure 3-2. VSAM Utility Screen
+--------------------------------------------------------------------------------+ | File-AID --------------------- VSAM Utility --------------------------------| | OPTION ===> A | | | | A - Allocate cluster D - Delete | | S - Allocate dataspace DR - Delete/Define | | X - Allocate alternate index T - Delete dataspace | | B - Build alternate index P - Allocate path | | BLANK - Display dataset information R - Rename component | | M - Modify component | | Specify Dataset Information: | | Dataset name ===> FASAMP.EMPLOYE1 | | Volume serial ===> (Required for options S & T) | | | | Process Online or Batch ===> B (O = Online; B = Batch) | | | | Specify Model Dataset Information: | | Dataset name ===> FASAMP.EMPLOYEE | | | | Specify Catalog to use if other than Default System Catalog: | | Catalog name ===> | | Catalog password ===> (If catalog is password protected) | | -------------------------------------------------------------------------------| | For dataset allocations only, the optional model dataset is used to | | prefill the allocation information on the allocation panel. | +--------------------------------------------------------------------------------+
Steps:
- Type an A in the OPTION field.
- Type FASAMP.EMPLOYE1 in the Dataset name field under the Specify Dataset Information section.
- Type a B in the Process Online or Batch field to request batch processing which generates IDCAMS control statements.
- Type FASAMP.EMPLOYEE in the Dataset name field under the Specify Model Dataset Information section.
- Press <Enter>. File-AID displays the Allocate New VSAM Cluster screen as illustrated in Figure 3-3.
3.5 Verifying Allocation Parameters
You can type over any of the fields to customize your cluster attributes. A second screen of attributes is available by specifying a value of YES in the "Extended allocate" field located at the bottom of the screen.Figure 3-3. Allocate New VSAM Cluster Screen
+--------------------------------------------------------------------------------+ | File-AID --------------- Allocate New VSAM Cluster -------------------------| | COMMAND ===> | | Component names: | | Cluster: 'USERID9.FASAMP.EMPLOYE1' | | Data component ===> 'USERID9.FASAMP.EMPLOYE1.DATA' | | Index component ===> 'USERID9.FASAMP.EMPLOYE1.INDEX' | | Dataset type ===> KSDS (KSDS; ESDS; RRDS; LINEAR) | | Owner ID ===> USERID9 | | | | Space Allocation: DATA Component KSDS INDEX Component (Blank for default) | | Generic unit ===> ===> (Generic group name or unit| | Volume serial ===> PRD928 ===> PRD902 | | Units ===> TRKS ===> TRKS (TRKs; CYLs; RECs; K; M) | | Primary ===> 1 ===> 1 (Amount in above units) | | Secondary ===> 1 ===> 1 (Amount in above units) | | Reuseable ===> YES (Y = Yes; N = No) | | Key length ===> 5 (1 - 255 - Required for KSDS only) | | Key position ===> 0 (0 - maximum record - KSDS only) | | Average Recordsize ===> 198 (Not allowed for LINEAR) | | Maximum Recordsize ===> 198 (Not allowed for LINEAR) | | Expiration date ===> (YYYY/MM/DD or blank) | | Type ===> UNIQUE (U = Unique; S = Sub-allocate) | | Extended allocate ===> YES (Y = Yes; N = No) | | | +--------------------------------------------------------------------------------+
Steps:
- Verify that the value in the "Extended allocate" field is YES. If it is not, type YES in the field.
- Press <Enter>. Since you specified a value of YES in the Extended allocate field, File-AID displays an additional allocation attributes screen as shown in Figure 3-4. Note: The value displayed in the Volume serial field will not be the same value shown in this example. The value you see is unique to your installation and is the same as the model dataset (FASAMP.EMPLOYEE).
More About VSAM Allocation
- Use an OWNER ID of $IAM to identify the dataset as an IAM dataset.
- For variable length records, "Maximum Recordsize" must be larger than "Average Recordsize" but not larger than the "Data C/I size".
3.6 Specifying Extended Allocation Parameters
The second allocation screen contains additional attributes for defining a VSAM cluster that you may want to specify to customize your cluster attributes.Step:
- Press <Enter>. File-AID displays the JCL Specification screen as illustrated in Figure 3-5.
+--------------------------------------------------------------------------------+ | File-AID ------------ Allocate VSAM Cluster (continued) --------------------| | COMMAND ===> | | | | Control Interval - percent free ===> 0 Data C/I size ===> 2048 | | Control Area - percent free ===> 0 Index C/I size ===> 2048 | | Buffer space ===> 6144 | | Specify Allocation options: | | Region share option ===> 3 (1; 2; 3; 4) | | System share option ===> 3 (3; 4) | | Write check ===> NO (Y = Yes; N = No) | | Erase on delete ===> NO (Y = Yes; N = No) | | Imbedded index ===> NO (Y = Yes; N = No) | | Replicated index ===> NO (Y = Yes; N = No) | | Load option ===> RECOV (S = Speed; R = Recovery) | | Spanned records ===> NO (Y = Yes; N = No) | | | | Specify Mass Storage Options: | | Stage option ===> STAGE (S = Stage; B = Bind; C = Cylinder fault) | | Destage wait ===> NO (Y = Yes; N = No) | | | | Specify Passwords: (Fill in or leave blank for no password protection) | | Master ===> Control ===> | | Update ===> Read ===> | | Code ===> Attempts ===> 0 | +--------------------------------------------------------------------------------+
More About Allocate New VSAM Cluster
- If the Data C/I size, Index C/I size, or Buffer space fields contain a value of zero or blanks, File-AID automatically calculates the optimum size for each one.
- If you perform the allocation request online, File-AID processes the request
immediately and redisplays the VSAM utility screen with a message:
CLUSTER ALLOCATED
- If any errors occur, issue the HELP command (PF1) once to see a long message describing the error and twice to access the File-AID tutorial describing the return code. If errors occur during IDCAMS invocation, File-AID displays an IDCAMS error screen when you issue the VIEW command.
3.7 Generating the Batch JCL Information
Use the JCL Specification screen to specify the JCL information for batch processing. As illustrated in this step, enter the JCL primary command to generate and display the JCL before you submit it for processing.Steps:
- Type JCL in the COMMAND field.
- Type an asterisk (*) in the Sysout class field.
- If necessary, change information in the JOB statement information fields to
represent a valid JOB statement for you at your site:
Your JOB statement information stays set from function to function and
session to session until you change it on any JCL Specification screen in
File-AID.
- Press <Enter>. File-AID generates the JCL and displays it on the ISPF/EDIT screen as illustrated in Figure 3-6.
+--------------------------------------------------------------------------------+ | File-AID ------------------ JCL Specification ------------------------------| | COMMAND ===> JCL | | | | JCL Information for Batch Processing: | | | | Sysout class ===> * | | | | JOB Statement Information: | | ===> //useridA JOB (ACCOUNT),'your name', | | ===> // CLASS=x,MSGCLASS=x,NOTIFY=userid | | ===> | | ===> | | | | | | | | | | Use JCL command to edit generated JCL | | Use SUBMIT command to submit batch job | | Use END to return to main panel without submitting job | | | | | | | | | | | +--------------------------------------------------------------------------------+
3.8 Executing the JCL
Use the SUBMIT primary command to submit the batch job. SUB is a valid abbreviation for the SUBMIT command.Steps:
- Type SUB in the COMMAND field.
- Press <Enter>. File-AID submits the JCL for background execution and redisplays the ISPF/EDIT screen. A message at the bottom of the display indicates that File-AID has successfully submitted the job.
- (optional) Use your site's job output display facilities to review the results of the VSAM allocation job.
+--------------------------------------------------------------------------------+ | EDIT ---- SYS94124.T141416.RA000.USERID9.R0043070 ------------ COLUMNS 001 072| | COMMAND ===> SUB SCROLL ===> CSR | | ****** ***************************** TOP OF DATA *****************************| | 000001 //USERID9A JOB (ACCOUNT),'your name', | | 000002 // CLASS=A,MSGCLASS=A,NOTIFY=USERID9 | | 000003 //* YOU ARE VIEWING JCL THAT FILE-AID HAS GENERATED TO PERFORM | | 000004 //* THE REQUIRED FUNCTION. YOU CAN CHANGE THIS JCL IF DESIRED AND USE | | 000005 //* THE SUBMIT PRIMARY COMMAND TO SUBMIT THE JOB. THE CREATE OR REPLAC| | 000006 //* PRIMARY COMMAND CAN BE USED TO KEEP THIS JOBSTREAM FOR FUTURE USE.| | 000007 //* USE THE END COMMAND TO EXIT THE FUNCTION WITHOUT SUBMITTING THE JO| | 000008 //JS10 EXEC PGM=IDCAMS | | 000009 //SYSPRINT DD SYSOUT=* | | 000010 //SYSIN DD * | | 000011 DEFINE CLUSTER - | | 000012 (NAME(USERID9.FASAMP.EMPLOYE1) - | | 000013 BUFFERSPACE(6144) - | | 000014 INDEXED - | | 000015 KEYS(5 0) - | | 000016 OWNER(USERID9) - | | 000017 RECORDSIZE(198 198) - | | 000018 REUSE - | | 000019 SHAREOPTIONS(3 3) - | | 000020 STAGE) - | | 000021 DATA(NAME(USERID9.FASAMP.EMPLOYE1.DATA) - | +--------------------------------------------------------------------------------+
3.9 Saving the JCL
Since you are in an Edit session, you can use the primary commands CREATE or REPLACE with the "C999" line command to save the JCL to a PDS of your choice.3.10 Exit the VSAM Utility
Use the END command several times to exit the VSAM utility and return to the File-AID Primary Option Menu now.Steps:
- Enter the END command (press PF3) TWO OR THREE TIMES until the File-AID Primary Option Menu reappears.
No comments:
Post a Comment
Note: Only a member of this blog may post a comment.