createVersionDefinition

This task defines SMP/E version definitions.

The following table describes the version attributes.

Attributes	Description	Required
baseFmid	The base FMID name. An FMID definition of the same name must exist.	Yes
baseFunction	The base function name. A function definition of the same name must exist.	Yes
changeTeam	The ID of the change team that manages this version.	No
componentId	The SMP/E component id. Must be nine alphanumeric characters.	Yes
copyright	The default copyright for the version. If specified, all the FMIDs can use this copyright or override it. If not specified, all the FMIDs must specify their own copyrights. The default value is `blank`.	No
defaultFunction	The default function name. If specified, a function definition of the same name must exist. The default value is `blank`.	No
description	The description of the current SMP/E definition. The default value is `blank`.	No
extendedService	One of three possible service modes. Only one can be `true`. Valid values are `true` and `false`. The default is `false`.	No
generallyAvailable	One of three possible service modes. Only one can be true. Valid values are `true` and `false`. The default is `false`.	No
id	The version id. It must be one to four alphanumeric characters.	Yes
levelCreatedBy	The ID of the user that created this version.	No
levelStatus	The status of the level. Default is `CREATED`.	No
levelSupFile	A file containing a comma-delimited list of versions that this one should supersede.	No
levelSupList	A comma-delimited list of versions that this one should supersede.	No
levelType	The level type. Default is `RAW`.	No
name	The name of the current SMP/E definition.	Yes
neverSup	Whether this version should never be superseded. Default is `false`.	No
nonImpacting	Specifies that changes to this system definition do not force Engineering Workflow Management dependency build request processing to use full analysis instead of change set analysis. Valid values are `true` and `false`. The default value is `false`.	No
outOfService	One of three possible service modes. Only one can be true. Valid values are `true` and `false`. The default value is `false`.	No
releaseId	The release id. It must be one to eight alphanumeric characters.	Yes
singleFunction	If the value is `true`, it indicates that this version has s single function and only one FMID is allowed. Valid values are `true` and `false`. The default value is `false`.	No
systemRelease	The SMP/E system release. Must be four alphanumeric characters.	Yes
usermodPrefix	The SMP/E `usermod` prefix. Must be two alphanumeric characters.	No

The following table describes the FMID attributes.

Attributes	Description	Required
alias	The alias name. The default value is `blank`.	No
base	If the value is `true`, it indicates that this FMID is the base function. Valid values are `true` and `false`. The default is `false`.	No
description	The description of this FMID. The default value is `blank`.	No
fesn	The Field Engineering Service Number (FESN) to use when packaged as a ++FUNCTION.	No
function	The base function name. A function definition of the same name must exist.	Yes
ignore	If `true` is specified, the current FMID should be ignored during packaging. Valid values are `true` and `false`. The default value is `false`.	No
jclinCallibs	If `true` is specified, it indicates that SMP/E CALLIBS parameter should be generated. Valid values are `true` and `false`. The default value is `false`.
name	The name of the current FMID.	Yes
nonImpacting	Specifies that changes to this system definition do not force Engineering Workflow Management dependency build request processing to use full analysis instead of change set analysis. Valid values are `true` and `false`. The default value is `false`.	No
osPlatform	The platform that this FMID applies to. Valid values are `ZOS`, `VSE`, and `VM`. Default is `ZOS`.	No
scp	Whether the function is for a z/OS SCP-dependent product. Default is `false`.	NO

The following table describes the JCLIN attributes.

Attributes	Description	Required
distlib	The distribution library data set name. A data set definition of the same name must exist.	Yes
id	The JCLIN id, on 1-8 alphanumeric characters.	Yes
inSource	If the value is `true`, it indicates that JCLIN is stored in source control. The valid values are `true` and `false`. The default is `false`.	No
locationLib	The source location library data set. A data set definition of the same name must exist.	Yes

The following table describes the MCSCPYRT attributes.

Attributes	Description	Required
id	The member name, on 1-8 alphanumeric characters. * Not required if `text` is specified.	Yes*
location	The source location data set. A dataset definition of the same name must exist. * Not required if `text` is specified.	Yes*
text	The copyright text. * Not required if `id` and `location` are specified.	Yes*

The following table describes the MCSDEL attributes.

Attributes	Description	Required
file	The fully-qualified path on the build system to the file that contains the SMP/E `DELETE` SYSMOD information for the `++VER` MCS for this function.	No
text	The text that contains the SMP/E `DELETE` SYSMOD information for the `++VER` MCS for this function.	No

The following table describes the MCSNPR attributes.

Attribute	Description	Required
file	The fully-qualified path on the build system to the file that contains the SMP/E `NPRE` SYSMOD information for the `++VER` MCS for this function.	No
text	The text that contains the SMP/E `NPRE` SYSMOD information for the `++VER` MCS for this function.	No

The following table describes the MCSPRE attributes.

Attributes	Description	Required
file	The fully-qualified path on the build system to the file that contains the SMP/E `PRE` SYSMOD information for the `++VER` MCS for this function.	No
text	The text that contains the SMP/E `PRE` SYSMOD information for the `++VER` MCS for this function.	No

The following table describes the MCSREQ attributes.

Attributes	Description	Required
file	The fully-qualified path on the build system to the file that contains the SMP/E `REQ` SYSMOD information for the `++VER` MCS for this function.	No
text	The text that contains the SMP/E `REQ` SYSMOD information for the `++VER` MCS for this function.	No

The following table describes the MCSSUP attributes.

Attributes	Description	Required
file	The fully-qualified path on the build system to the file that contains the SMP/E `SUP` SYSMOD information for the `++VER` MCS for this function.	No
text	The text that contains the SMP/E `SUP` SYSMOD information for the `++VER` MCS for this function.	No

The following table describes the MCSVER attributes.

Attributes	Description	Required
file	The fully-qualified path on the build system to the file that contains the SMP/E `VERSION` SYSMOD information for the `++VER` MCS for this function.	No
text	The text that contains the SMP/E `VERSION` SYSMOD information for the `++VER` MCS for this function.	No

The following table describes the RELFILE attribute.

Attribute	Description	Required
dsdef	The data set definition name. A data set definition of the same name must exist.	Yes

The following table describes the Scoped Property attributes.

Attributes	Description	Required
condition	The Ant condition string, written in escaped XML, that must evaluate to `true` for the property to be available at run time.	No
name	The name of the property.	Yes
value	The value of the property value.	No

Example

Create version definition


<sm:createversion name="IMSV14"
	description="IMS Version 14"
	nonImpacting="true"
	baseFmid="HMK1400"
	baseFunction="IMS System Services"
	componentId="5635A0500"
	copyright="${version_copyright}"
	defaultFunction="IMS Database Manager"
	id="141"
	releaseId="HMK1400P"
	systemReleae="P115"
	usermodPrefix="IM"
	extendedService="false"
	generallyAvailable="true"
	outOfService="false"
	singleFunction="false">

	<sm:fmid name="HMK1400" alias="DVK1400"
		description="HMK1400 FMID FOR IMS VERSION 14"
		nonImpacting="true"
		functionName="IMS System Services"
		base="true"
		ignore="false"
		initialRevision="1.0"
		osPlatform="ZOS"
		rfdsnpfx="IBM">
		<sm:jclin id="hmk1400" distlib="zdatasetDlib.JCLIN" location="zfolder.JCLIN"/>
		<sm:mcscpyrt text="${fmid_copyright}"/>
		<sm:mcsdel file="delFile.hmk1400.txt" text="text"/>
		<sm:mcsnpr file="nprFile.hmk1400.txt" text="text"/>
		<sm:mcspre file="preFile.hmk1400.txt" text="text"/>
		<sm:mcsreq file="reqFile.hmk1400.txt" text="text"/>
		<sm:mcssup file="supFile.hmk1400.txt" text="text"/>
		<sm:mcsver file="verFile.hmk1400.txt" text="text"/>
		<sm:relfile dsdef="zdatasetDlib.JCLIN"/>
		<sm:relfile dsdef="zdatasetDlib.ADFSLOAD"/>
		<sm:relfile dsdef="zdatasetDlib.ADFSMAC"/>
		<sm:relfile dsdef="zdatasetDlib.ADFSSRC"/>
	</sm:fmid>

	<sm:scopedProperty name="unconditioanl" value="value1"/>
	<sm:scopedProperty name="conditaional" value="value2" condition="&lt;isset property=&quot;cond&quot;/&gt;"/>
</sm:createversion>