DEFINE Statement Extensions

Lists each DEFINE statement extension and provides a description of each.

DEFINE Command Extensions
%PCDSN(`pcdatasetname`)	Specify a data file on the local PC for a new dataset that you want to associate with the z/OS dataset referenced in the DEFINE command. Note: If you omit this parameter, Enterprise Test Server generates a PC filename automatically. This parameter is valid only with new datasets and is ignored for old datasets. If z/OS rules dictate, enclose `pcdatasetname` in single quotes. If the filename specified for `pcdatasetname`contains spaces, enclose the name in double quotes ("). The specified filename cannot exceed 256 characters, including all characters between single quotes and including double quotes that enclose the PC filename.
%CHARSET({EBCDIC \| ASCII})	Specify the character set for a new dataset. By default, the character set is the same as the character set of the system. Note: This parameter is for Micro Focus internal use only unless justified otherwise.
CURRENT(`n`)	Specify the current generation when defining a generation data group for which the underlying G0000V00 datasets already exist. By default, the G0000V00 dataset with the highest G0000V00 number becomes the current generation, but this option allows you to make the G0000V00 dataset of your choice the current generation. For example, if you currently have the datasets TEST.GDG.G9999V00, and TEST.GDG.G0001V00 allocated and then define a GDG called TEST.GDG, the two G0000V00 datasets become part of the TEST.GDG generation data group (GDG), and under normal behavior, the highest number would become the current generation; however, in this example the GDG has clearly cycled past the G9999V00, and using the CURRENT(1) extension allows you to make G0001V00 the current generation.

DEFINE Command Extensions

%PCDSN(pcdatasetname)

Specify a data file on the local PC for a new dataset that you want to associate with the z/OS dataset referenced in the DEFINE command.

Note:

If you omit this parameter, Enterprise Test Server generates a PC filename automatically.
This parameter is valid only with new datasets and is ignored for old datasets.
If z/OS rules dictate, enclose pcdatasetname in single quotes.
If the filename specified for pcdatasetnamecontains spaces, enclose the name in double quotes (").
The specified filename cannot exceed 256 characters, including all characters between single quotes and including double quotes that enclose the PC filename.

%CHARSET({EBCDIC | ASCII})

Specify the character set for a new dataset. By default, the character set is the same as the character set of the system.

Note: This parameter is for Micro Focus internal use only unless justified otherwise.

CURRENT(n)

Specify the current generation when defining a generation data group for which the underlying G0000V00 datasets already exist. By default, the G0000V00 dataset with the highest G0000V00 number becomes the current generation, but this option allows you to make the G0000V00 dataset of your choice the current generation.

For example, if you currently have the datasets TEST.GDG.G9999V00, and TEST.GDG.G0001V00 allocated and then define a GDG called TEST.GDG, the two G0000V00 datasets become part of the TEST.GDG generation data group (GDG), and under normal behavior, the highest number would become the current generation; however, in this example the GDG has clearly cycled past the G9999V00, and using the CURRENT(1) extension allows you to make G0001V00 the current generation.

Example:

%PCDSN Example

DEFINE CLUSTER(NAME(MFIDSA.RJSE.VSAMKSDS.WITH.SPECIFIC.PCNAME ) -
        TRK(1 1) -
        RECSZ(80 80) KEYS(15 3)) -
        ;MFE:%PCDSN -
         ('"F:\MX30 JCL SYSTEM\ \PCFILE.VSAMKSDS.DAT"')

%PCDSN Example

DEFINE CLUSTER(NAME(MFIDSA.RJSE.VSAMKSDS.WITH.SPECIFIC.PCNAME ) -
        TRK(1 1) -
        ;MFE:%PCDSN -
         ('"F:\MX30 JCL SYSTEM\PCFILE.VSAMKSDS.DAT"')

CURRENT(n) Example

DEFINE GENERATIONDATAGROUP - 
      (NAME(TEST.GDG) EMPTY SCRATCH LIMIT(5) CURRENT(1))