The task is used to create an Enterprise Extensions system definition for a data set.

Attributes

The following table describes the task specific attributes for the task:

Task Specific Attributes

Attribute Description Required

additionalParm This attribute can be used to specify any BPXWDYN keys that are not covered by the specific attributes listed here. No

blockSize Specifies the BLZSIZE to use when allocating the data set. No

compact

Specifies whether or not outputs are compacted. Valid values are true and false. The default is false.

When true, outputs published to the build result have trailing white space removed from each line and outputs stored in a PDS are compressed. For compressed outputs use BLZCMPST to extract the PDS member.

dataClass Specifies the SMS data class to use when allocating the data set. No

description A free-form textual description of the data set. No

directoryBlocks Specifies the number of directory blocks to use when allocating the data set. The default is 0. No

dsDefUsageType

Specifies the usage type for the data set. The default is 0. Valid values are:

Type:	Description:
0	Destination data set for a zFolder
1	Build output data set (created if it does not exist)
2	Temporary data set used for build
3	Existing data set used for build

dsMember Member name as defined on a z/OS^® system. No

dsName Data set name as defined on a z/OS^® system. No

dsType

Specifies the type of z/OS^® data set. The default is 0. Valid values are:

Type:	Description:
0	PDSE
1	Sequential
2	VSAM
3	PDS
9	Undefined

genericUnit Specifies the UNIT to use when allocating the data set. No

managementClass Specifies the SMS storage class to use when allocating the data set. No

name A unique name for the data set definition item. Yes

nonImpacting Specifies that changes to this system definition do not force Enterprise Extensions dependency build request processing to use full analysis instead of change set analysis. Valid values are true and false. The default is false. No

prefixDSN Specifies whether or not the data set name prefix from the build should be added to the defined data set name to form the complete data set name. Valid values are true and false. The default is false. No

primaryQuantity Specifies the primary quantity to use when allocating the data set. The default is 1. No

recordFormat

Specifies the RECFM to use when allocating the data set. The default is FB. Valid options are:

Options:	Description:
F	Fixed
V	Variable
U	Undefined
B	Blocked
A	ASA control characters
M	Machine control characters
S	Standard format if Fixed; Spanned format if Variable

Valid values are:

RECFM:	Description:
`F`	Fixed, unblocked
`FA`	Fixed, unblocked, ASA print-control
`FB`	Fixed, blocked
`FM`	Fixed, unblocked, machine control codes
`FS`	Fixed, unblocked, standard
`FBA`	Fixed, blocked, ASA print-control
`FBM`	Fixed, blocked, machine control codes
`FBS`	Fixed, blocked, standard
`FSA`	Fixed, unblocked, standard, ASA print-control
`FSM`	Fixed, unblocked, standard, machine control codes
`FBSA`	Fixed, blocked, standard, ASA print-control
`FBSM`	Fixed, blocked, standard, machine control codes
`V`	Variable, unblocked
`VA`	Variable, unblocked, ASA print-control
`VB`	Variable, blocked
`VM`	Variable, unblocked, machine control codes
`VS`	Variable, unblocked, standard
`VBA`	Variable, blocked, ASA print-control
`VBM`	Variable, blocked, machine control codes
`VBS`	Variable, blocked, standard
`VSA`	Variable, unblocked, standard, ASA print-control
`VSM`	Variable, unblocked, standard, machine control codes
`VBSA`	Variable, blocked, standard, ASA print-control
`VBSM`	Variable, blocked, standard, machine control codes
`U`	Undefined
`UA`	Undefined, ASA print-control
`US`	Undefined, standard

recordLength Specifies the LRECL to use when allocating the data set. No

secondaryQuantity Specifies the secondary quantity to use when allocating the data set. The default is 1. No

spaceUnits

Specifies the space units to use when allocating the data set. The default is blks. Valid values are:

Unit:	Description:
`blks`	Blocks
`trks`	Tracks
`cyls`	Cyliners

storageClass Specifies the SMS storage class to use when allocating the data set. No

volumeSerial Specifies the VOLSER to use when allocating the data set. No

Notes

Examples

Define data sets:

<target name="dsDef">
  
  <!-- zFolders -->
  <xt:dsDef
    name="COBOL"
    dsName="COBOL"
    dsDefUsageType="0"
    dsType="0"
    spaceUnits="cyls"
    primaryQuantity="1"
    secondaryQuantity="1"
    recordFormat="FB"
    recordLength="80"
    blockSize="0"/>
  
  <!-- New data sets -->
  <xt:dsDef
    name="OBJ"
    dsName="OBJ"
    dsDefUsageType="1"
    dsType="0"
    spaceUnits="cyls"
    primaryQuantity="1"
    secondaryQuantity="1"
    recordFormat="FB"
    recordLength="80"
    blockSize="0"/>
  <xt:dsDef
    name="LOAD"
    dsName="LOAD"
    dsDefUsageType="1"
    dsType="0"
    spaceUnits="cyls"
    primaryQuantity="1"
    secondaryQuantity="1"
    recordFormat="U"
    recordLength="0"
    blockSize="32760"/>
  
  <!-- Temporary data set -->
  <xt:dsDef
    name="TEMPFILE"
    dsDefUsageType="2"
    prefixDSN="false"
    dsType="9"
    spaceUnits="trks"
    primaryQuantity="5"
    secondaryQuantity="5"
    genericUnit="SYSALLDA"/>
  
  <!-- Existing data sets -->
  <xt:dsDef
    name="IGYCRCTL"
    dsName="COBOL.V4R1M0.SIGYCOMP"
    dsMember="IGYCRCTL"
    dsDefUsageType="3"
    prefixDSN="false"/>
  <xt:dsDef
    name="IEWBLINK"
    dsMember="IEWBLINK"
    dsDefUsageType="3"
    prefixDSN="false"/>
  <xt:dsDef
    name="SCEELKED"
    dsName="CEE.SCEELKED"
    dsDefUsageType="3"
    prefixDSN="false"/>
  
</target>

getTaskNameHdr()

Attributes

Notes

Examples