Example usage – defining a cluster

To define a cluster, on the VSAM Utilities panel, type 1 in the Process Request field and 3 in the VSAM Data Type field. The Define Cluster panel is displayed as shown in Figure 1.

Figure 1. Define Cluster panel (ISRUVPC3)

   Menu  Function  Utilities  Help
 ───────────────────────────────────────────────────────────────────────────────
                                 Define Cluster

                                                Enter "/" to select option
                                                /  Edit IDCAMS command
                                                /  Browse errors only
  Cluster Name  . . . MYPROJ.DEV.SOURCE3                         
                                                                    More:     +
                           Cluster Level Information:

  Space Units  . . . . . . .    1. Cylinders   Primary Quantity . . .         
                                2. Tracks      Secondary Quantity . .         
                                3. Records
                                4. Kilobytes
                                5. Megabytes
  Volumes  . . . . . . . . .         . . .         . . .         . . .       
  Buffer Space . . . . . . .         
  Control Interval Size  . .       
  Data Class . . . . . . . .         
  Management Class . . . . .         
 Command ===>                                                                 
  F1=Help      F2=Split     F3=Exit      F7=Backward  F8=Forward   F9=Swap
 F10=Actions  F12=Cancel

Note:

Select the Edit IDCAMS command option to edit the IDCAMS command that this process generates before the command is issued. If you do not select this option, the command will be issued when you press Enter.
Select the Browse errors only option to browse the output from IDCAMS only when a nonzero return code is returned by IDCAMS.

Fill in the required fields or use a VSAM profile data set as described in Building a VSAM profile data set. When you press Enter, the screen shown in Figure 2 is displayed.

Note: If you try to use a profile that was defined for a different request type (for example, Generation Data Group), you will receive a "Type mismatch" error.

Figure 2. Editing the IDCAMS command (ISRUVEDT)

   Menu  Utilities  Help
 ───────────────────────────────────────────────────────────────────────────────
                                                            Columns 00001 00072

     Instructions:

       Enter EXECute command to issue request.

       Enter CANcel, END, or RETURN command to cancel request.
 ****** ***************************** Top of Data ******************************
 ==MSG> -Warning- The UNDO command is not available until you change
 ==MSG>           your edit profile using the command RECOVERY ON.
 000001  /* IDCAMS COMMAND */
 000002  DEFINE CLUSTER (NAME(MYPROJ.DEV.SOURCE3) -
 000003         ) -
 000004         DATA (NAME(MYPROJ.DEV.SOURCE3.DATA) -
 000005         ) -
 000006         INDEX (NAME(MYPROJ.DEV.SOURCE3.INDEX) -
 000007         )
 ****** **************************** Bottom of Data ****************************

 Command ===>                                                  Scroll ===> PAGE
  F1=Help      F2=Split     F3=Exit      F5=Rfind     F6=Rchange   F7=Up
  F8=Down      F9=Swap     F10=Left     F11=Right    F12=Cancel

When you are ready to process the command, type EXEC on the Command line and press Enter. If the command processes with a nonzero return code, the panel shown in Figure 3 is displayed.

Figure 3. Browsing IDCAMS Errors (ISRUVBRO)

The pop-up in this screen dump shows that the IDCAMS SYSTEM SERVICES have returned a non-zero return code.

Press Exit (F3) to return to the panel shown in Figure 2, make the necessary changes, and resubmit the command.