Define Variable-length KSDS

Define Variable-length KSDS Example

Define Cluster Tutorial   

Scenario - Creating KSDS with variable-length records of average size 47 and maximum size 67 bytes.

JCL -

----+----1----+----2----+----3----+----4----+----5
//MATEPKE JOB (123),'MTH',CLASS=A,
//             MSGCLASS=A,
//             MSGLEVEL=(1,1),
//             NOTIFY=&SYSUID
//*********************************************
//* Creating variable-length KSDS
//*********************************************
//STEP01   EXEC PGM=IDCAMS
//SYSPRINT DD SYSOUT=*
//SYSIN    DD  *
  DEFINE CLUSTER -
    (NAME(MATEGJ.TEST.VKSDS)  -
     RECORDSIZE(47,67)    -
     CYLINDERS(2,1)       -
	 FREESPACE(10,20)     -
	 KEYS(3,0)            -
     CISZ(4096)           -
     VOLUMES(DEVHD4)      -
     INDEXED              -
     REUSE     )          -
  DATA(NAME(MATEGJ.TEST.VKSDS.DATA)) -
  INDEX(NAME(MATEGJ.TEST.VKSDS.INDEX))
/*

Output -

Once the above JCL is submitted, check the MAXCC of the job for any errors. If the MAXCC is 00 or 04, KSDS successfully created.

Create KSDS Output

Verify the KSDS in 3.4 (Dataset List utility) or any File management tools for the existance.

Create KSDS Output

Explaining Example -

In the above example,

  • RECORDSIZE(47,67) specifies that the record average length is 47, and the maximum length is 47. So the KSDS file we are creating is variable-length.
  • CYLINDERS(2,1) specifies the primary memory allocation is 2 CYLINDERS, and secondary memory allocation is 1 CYLINDER.
  • KEYS(3,0) specifies the key length as 3 bytes from the starting position 0.
  • CISZ(4096) specifies the control interval size is 4096.
  • VOLUMES(DEVHD4) specifies that allocate the KSDS on volume DEVHD4.
  • INDEXED parameter specifies the file is to create KSDS.
  • REUSE specifies the memory can reuse immediately once the file gets deleted.