createVersionDefinitionSmpe

The createVersionDefinitionSmpe task defines SMP/E version definitions.

The following table describes the version attributes.

Attribute 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 FMIDs can use this copyright or override it. If not specified, all 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
releseId 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.

Attribute 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 filed engineering (FE) service number 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. Vaid 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 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.

Attribute Description Required
distlib The distribution dataset name. A dataset definition of the same name must exist. Yes
id The jclin id. Must be one to eight alphanumeric characters. Yes

inSource

If the value is true, it indicates that JCLIN is stored in source control. Valid values are true and false. Default is false.

No
locationLib The source location dataset. A dataset definition of the same name must exist. Yes

The following table describes the mcscpyrt attribute.

Attribute Description Required
id The member name. Must be one to eight alphanumeric characters. *Not required if text specified. Yes*
location The source location dataset. A dataset definition of the same name must exist. *Not required if text specified. Yes*
text The copyright text. * Not required if id/location specified. Yes*

The following table describes the mcsdel attribute.

Attribute Description Required
file The file containing SMP/E DELETE SYSMOD information for the ++VER MCS for this function. The default value is blank. No
text The text containing SMP/E DELETE SYSMOD information for the ++VER MCS for this function. The default value is blank. No

The following table describes the mcsnpr attributes.

Attribute Description Required
file The file containing SMP/E NPRE SYSMOD information for the ++VER MCS for this function. The default value is blank. No
text The text containing SMP/E NPRE SYSMOD information for the ++VER MCS for this function. The default value is blank. No

The following table describes the mcspre attributes.

Attribute Description Required
file The file containing SMP/E PRE SYSMOD information for the ++VER MCS for this function. The default value is blank. No
text The text containing SMP/E PRE SYSMOD information for the ++VER MCS for this funciton. The default value is blank. No

The following table describes the mcsreq attribute.

Attribute Description Required
file The file containing SMP/E REQ SYSMOD information for the ++VER MCS for this function. The default value is blank. No
text The text containing SMP/E REQ SYSMOD information for the ++VER MCS for this function. The default value is blank. No

The following table describes the mcssup attributes.

Attribute Description Required
file The file containing SMP/E SUP SYSMOD information for the ++VER MCS for this function. The default value is blank. No
text The text containing SMP/E SUP SYSMOD information for the ++VER MCS for this function. The default value is blank. No

The following table describes the mcsver attributes.

Attribute Description Required
file The file containing SMP/E VERSION SYSMOD information for the ++VER MCS for this function. The default value is blank. No
text The text containing SMP/E VERSION SYSMOD information for the ++VER MCS for this function. The default value is blank. No

The following table describes the relfile attributes.

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

The following table describes the scopedproperty attributes.

Attribute 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>	 		

video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki