product
The <product> element defines or selects a product.
The way that you use the element depends upon the command in which you are using it.
- When you use it with the <register> command, the <prodcode>, <prodvrsn>, and <templates> elements are required children.
If you use it within an <export> command, the <product> element specifies a product to select.
When you use it to select a product, the <prodcode> and <prodvrsn> elements become optional. The command supports limited wildcard characters within the <prodcode> element ( for example, <prodcode>AF*</prodcode>).
Parent element: <register>, <deregister>, <products>, <optionsets>, or <list>
Child elements: <name> (0:1), <prodcode> (0:1), <prodvrsn> (0:1), <templates> (0:1), and <files> (0:1)
Attributes:
Name | Type | Required? | Default | Description |
|---|---|---|---|---|
id | string | no | A 7-character attribute that indicates the FMID for the product. When you register a new product, this value is required. | |
prodlist | string | no | Indicates whether a product is to be included in a list of all installed products. Valid values are yes and no. | |
list | string | no | Controls whether the product is shown on the list of products when Option 2 is selected from the main menu. | |
refid | string | no | A 7-character attribute that is required for a product definition in a solution registration. It refers to the id attribute for the product in its definition. | |
replace | string | no | no | Indicates whether to replace an existing product. Valid values are yes and no. If you specify yes within the <register> command, the registered product replaces any existing product of the same prodcode/version |
Example:
The following example illustrates the use of a <prodcode> element within an export command:
<ddname>XML</ddname>
<!-- select all products for version 1010 -->
<products>
<product>
<prodcode>DOM</prodcode>
<prodvrsn>1010</prodvrsn>
</product>
</products>
</export>
The following example illustrates the use of a wildcard character within the <prodcode> element:
<ddname>XML</ddname>
<!-- select all products with prodcode beginning -->
<!-- with 'A' but only for version 1020 -->
<products>
<product>
<prodcode>A*</prodcode>
<prodvrsn>1020</prodvrsn>
</product>
</products>
</export>
The following example illustrates a <prodcode> element within the <register> command:
<!-- register a product -->
<product replace="yes" id="ZLGCA10" prodlist="no">
<prodcode>LGC</prodcode>
<prodvrsn>1011</prodvrsn>
<name>BMC Configuration Component for z/OS</name>
<templates>
<template type="help">
<dsn>ROHMXN.IVP101MV.BMCXML</dsn>
<member>LGCHELP</member>
<help>
<dsn>ROHMXN.IVP101MV.BMCXML</dsn>
<member>LGCHELP</member>
</help>
</template>
</templates>
<files>
</files>
<created>
<date>20110307</date>
<time>124732939819</time>
<userid>RDADAC2</userid>
</created>
<updated>
<date>20110603</date>
<time>110237504222</time>
<userid>ROHMXN</userid>
</updated>
</product>
</register>
Related topic