DEFINE CLUSTER

The DEFINE CLUSTER command creates a new VSAM data set. It creates the data and index files on the local machine and catalogs the data set name.

Syntax:

DEFINE CLUSTER (parameters) -
             [DATA(parameters)] -
             [INDEX(parameters)] -
             [CATALOG(parameters)]

Parameters:

MFJAMS supports the following parameters. They are supported as documented in the IBM documentation unless otherwise stated below:

NAME(data-set-name): Name of the VSAM data set. This parameter is required.
CYLINDERS(primary[ secondary]): The amount of space, in cylinders, allocated to the cluster from the volume's available space. This parameter only has an effect when running in a mainframe environment.
KILOBYTES(primary[ secondary]): The amount of space, in kilobytes, allocated to the cluster from the volume's available space. This parameter only has an effect when running in a mainframe environment.
MEGABYTES(primary[ secondary]): The amount of space, in megabytes, allocated to the cluster from the volume's available space. This parameter only has an effect when running in a mainframe environment.
RECORDS(primary[ secondary]): The amount of space, in records, allocated to the cluster from the volume's available space. This parameter only has an effect when running in a mainframe environment.
TRACKS(primary[ secondary]): The amount of space, in tracks, allocated to the cluster from the volume's available space. This parameter only has an effect when running in a mainframe environment.
VOLUMES(volser[ volser...]): Specifies the volumes on which a cluster's components are to have space. This parameter only has an effect when running in a mainframe environment.
DATACLASS(class): Specifies the name of the data class for the new data set.
CONTROLINTERVALSIZE(size): The size of the control interval for the cluster. This parameter only has an effect when running in a mainframe environment.
MANAGEMENTCLASS: Specifies the name of the management class for the new data set.
REUSE|NOREUSE: Specifies whether or not the cluster can be opened again and again as a reusable cluster.
LINEAR: Indicates a data set for linear data is being defined.
INDEXED: Indicates a KSDS data set is being defined.
NONINDEXED: Indicates an ESDS data set is being defined.
NUMBERED: Indicates an RRDS data set is being defined.
KEYS(length offset): Length and offset, relative to 0, of the primary key field for a KSDS data set. The offset must be within the first 4096 bytes of the record. length plus offset must not exceed the maximum length of the record. The default is KEYS(64 0).
RECORDSIZE(average maximum): Average and maximum lengths of the records, expressed in decimal format. The default is RECORDSIZE(4089 4089).
MODEL(data-set-name): MFJAMS supports the following parameters. They are supported as documented in the IBM documentation unless otherwise stated below:
Name of a cataloged VSAM data set that has the same KEYS and RECORDSIZE parameters as this new data set. It is an alternative to specifying the parameters explicitly.
SHAREOPTIONS(crossregion[ crosssystem]): Defines component or cluster sharing among users. To ensure integrity, you should be sure that share options specified at the DATA and INDEX levels are the same. See the SHAREOPTIONS help topic for details.
Note: SMS-managed volumes and catalogs with SMS-managed data sets must not be shared with non-SMS systems.

The values of the SHAREOPTIONS parameters is assumed to be (3,3) when the data set is accessed in VSAM RLS or DFSMStvs mode.
ACCOUNT: This parameter is parsed, but ignored.
BUFFERSPACE(size): This parameter is parsed, but ignored.
BWO(TYPECICS|TYPEIMS|NO): This parameter is parsed, but ignored.
EATTR(NO|OPT): This parameter is parsed, but ignored.
ERASE|NOERASE: This parameter is parsed, but ignored.
EXCEPTIONEXIT(entry-point): This parameter is parsed, but ignored.
FILE(ddname): This parameter is parsed, but ignored.
FREESPACE(CI-percent [CA-percent]|0 0): This parameter is parsed, but ignored.
FRLOG(ALL|NONE|REDO|UNDO): This parameter is parsed, but ignored.
LOG(NONE|UNDO|ALL): This parameter is parsed, but ignored.
LOGSTREAMID(logstream): This parameter is parsed, but ignored.
OWNER(ownerid): This parameter is parsed, but ignored.
RECATALOG|NORECATALOG: This parameter is parsed, but ignored.
SPANNED|NONSPANNED: This parameter is parsed, but ignored.
SPEED|RECOVERY: This parameter is parsed, but ignored.
STORAGECLASS(class): This parameter is parsed, but ignored.
TO(date)|FOR(days): This parameter is parsed, but ignored.
WRITECHECK|NOWRITECHECK: This parameter is parsed, but ignored.

Comments:

The file will be created as Variable Length records. This could be changed by the program that first writes to the file. If the first program accesses the file with fixed length records, then the file record type will be changed from variable to fixed.
INDEXED, NONINDEXED and NUMBERED are mutually exclusive. INDEXED is the default.
MFJAMS does not allow duplicate entries of the primary key.
KEYS and RECORDSIZE override the values obtained from MODEL.
MFJAMS does not support the Micro Focus split-key and key-compression features.

Example:

Here is a typical job to define a cluster:

//DEFCLUS  JOB  CLASS=A
//IDCSTEP  EXEC PGM=IDCAMS
//SYSPRINT DD   SYSOUT=*
//SYSIN    DD   *
  DEFINE CLUSTER(NAME(TEST.KSDS.DUMMY) KEYS(5,0) -
       RECORDSIZE(80,80) CYL(1 1))

Note the use of the continuation character (-) in the DEFINE CLUSTER statement.