Language Element - SMP/E Language Extension

The Language Element is specified within the language definition element, langDef. It is used to define the SMP/E extension to language definitions. The extension is used to define SMP/E settings and packaging information for a language.

The following table describes the valid Language Element attributes:

Language Element Attributes

Attribute Description Required

clazz Specifies an element class attribute for the parts defined to this language. The class attribute is optional. By default, the element class attribute is set to the MCS type with the "++" prefix removed. The element class attribute is a grouping mechanism for parts. No

deleted The deleted attribute flags an item for deletion. Specify true to flag all language parts deleted. The parts are not physically deleted from source control, just treated as if they were. Valid values are true and false. The default is false. No

description A free-form textual description of the SMP/E Language Extension. The description may be used to specify detailed information about the language and its SMP/E packaging configuration definition. No

distType

The distribution type identifies the legal restrictions for the parts defined to this language. Valid values are:

Value:	Description:
`B`	Business as Usual
`C`	Object Code Only
`R`	Restricted Materials
`E`	Fundamental or Extraordinary OCO
`I`	Internal OCO

folders

Specifies additional folders in which language files can be found. This attribute is optional. Specify each additional folder name separated by a comma.

The default folder name for a language file is a folder with the same name as the language. For example: if the language is ASM, the default folder name would be ASM. Do not specify the default folder name.

This attribute is optional and is only needed if there are packaging overrides defined at the folder level or there are files for the language that are in folders other than the default folder.

fmid

The Function Module ID (FMID) attribute defines the owing FMID for the parts defined to this language. This attribute is optional.

The default FMID is defined in the Version definition. Refer to the Version definition for more information on default FMID values.

hfsData The HFS data type attribute specifies the type of HFS element for the parts defined to this language. Valid values are: BINARY, TEXT, and NONE. This attribute is optional and is needed only for HFS parts. No

hfsPath The HFS path attribute specifies the HFS path for the parts defined to this language. This attribute is optional and is needed only for HFS parts. No

itemtype Specifies the SMP/E packaging language type. For example: Assembler OCO. See Item Types for more the list of valid values. Yes

jclincs Specifies whether or not this language is used for binder control statements (SYSLIN) that should be processed when creating JCLIN. Valid values are true and false. The default is false. This attribute is set to true to identify input to the JCLIN generation process. No

leparm The link edit parameters attribute specifies the default link edit parameters for the parts defined to this language. No

name A unique name for the SMP/E Language Extension system 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

shipped Specifies whether or not this language is shipped. Valid values are true and false. The default is true. This attribute is set to false to skip packaging for parts that are not shipped with the product. For example, OCO macros or files containing MCS information. No

updated The source update attribute indicates that the language is maintained using source updates. Valid values are true and false. The default is false. The source update attribute is optional and only applicable for service packaging. No

transform This option controls whether the shipped parts must be transformed into a record format and length required by SMP/E (fixed length, 80-byte records) or not. Valid values are true and false. When true, GIMDTS is invoked during packaging to transform the part into FB 80. No

vpl This option controls whether a Viewable Program Listing (VPL) is needed or not. Valid values are true and false. When true, the program listing is converted to VPL format during packaging. The default is false. No

Packaging Element

The Packaging Element is specified within the element. The Packaging Element is used to define packaging information for the language. At least one Packaging Element is required. Specify a unique Packaging Element for each packaging requirement for the language. The following table describes the valid Packaging Element attributes:

Packaging Element Attributes
Attribute	Description	Required
binary	The binary data attribute indicates that the file type must be treated as binary data. Valid values are `true` and `false`. The default is `false`.	No
description	A free-form textual description of the SMP/E packaging definition. The description may be used to specify detailed information about the SMP/E packaging definition.	No
distLib	The distribution library attribute specifies the data set definition name for the distribution library used by this language.	OBJ, SRC
fmidOverride	The FMID override attribute defines the owing FMID for the language for this packaging element. This attribute is optional. This attribute is optional. If an FMID override is specified the package element will only be used for that FMID. If an FMID override is not specified the package element will only be used for all FMIDs.	No
id	The packaging id for shipped parts. Valid values are `LST`, `OBJ`, and `SRC`.	Yes, if shipped
location	The location of the local library used by the packaging process.	LST, OBJ, SRC
mcsType	The SMP/E Modification Control Statements (MCS) type. See SMP/E documentation for valid values. Commonly used values are `DATA`, `HFS`, `MAC`, `MOD`, `SAMP`, and `SRC.`	OBJ, SRC
name	A unique name for the packaging system definition item.	No
originalDistLib	The original SMP/E distribution library. Used when moving distribution libraries.	OBJ, SRC
originalFmidoverride	The original SMP/E FMID override. Used when moving distribution libraries.	OBJ, SRC
originalSyslib	The original SMP/E target library. Used when moving target libraries.	OBJ, SRC
processor	The loader process attribute indicates the method to use for retrieving a file for this language. Valid values are: `COPY`, `GENER`, `LKED` and `UPDTE`. Use `COPY` for reloading load modules. Use `GENER` when files are not fixed length 80-byte records. Use `LKED` for object decks. Use `UPDTE` for everything else.	OBJ, SRC
syslib	The target library attribute specifies the data set definition name for the target library used by this language.	OBJ, SRC

Item Types

The following is a list of valid item types:

Assembler OCO
Assembler sample
Assembler source
Binder
C OCO
C sample
C source
C++ OCO
C++ sample
C++ source
C/370 OCO
C/370 sample
C/370 source
C/390 OCO
C/390 sample
C/390 source
CLIST
COBOL OCO
COBOL sample
COBOL source
Copy member OCO
Copy member sample
Copy member source
Data file
Data file binary
Data file source
Dialog tag language
Dialog tag language message
C header
C header sample
C header source
ISPF message
ISPF panel
ISPF skeleton
ISPF table
ISPF table source
JAR file
Java
Java sample
Java source
JCL
JCLIN
Macro OCO
Macro sample
Macro source
Makefile
MCS copyright
Object file
Other
PL/I OCO
PL/I sample
PL/I source
PLX
RAR file
README file
REXX exec
REXX compiled
Shell script
Script source
TAR file
XML
XML schema

Notes

Examples

Create language definition with SMP/E packaging information:

<target description="Create language definitions." name="langdefs">
   <xt:langdef defaultScanner="false" defaultpatterns="asm" languageCode="ASM" name="ASM" nonImpacting="true">
      <xt:scanner name="com.ibm.teamz.metadata.scanner.default"/>
      <xt:dependencytype name="COPY"/>
      <xt:dependencytype name="++INCLUDE"/>
      <xt:dependencytype name="SQL INCLUDE"/>
      <xt:dependencytype name="MACRO"/>
      <xt:dependencytype name="PROC"/>
      
      <xt:language
        delete="false"
        description="SMPE for ASM"
        distType="C"
        fmid="HMK1400"
        leparm="NCAL,LIST,REUS=NONE,XREF"
        name="ASMSMPE"
        nonImpacting="true"
        shipped="true"
        updated="false"
        transform="false"
        vpl="true"
      >
        
        <xt:packaging
          binary="false"
          description="Assembler Object Deck"
          distLib="zdatasetDlib.ADFSLOAD"
          id="OBJ"
          location="zdataset.OBJ"
          mcstype="MOD"
          name="Object"
          processor="LKED"
          syslib="zdatasetTlib.SDFSRESL"
        />
        
        <xt:packaging
          description="Assembler Listings"
          id="LST"
          location="zdataset.PRT.ASM"
          name="Listing"
        />
      </xt:language>
   </xt:langdef>
</target>