optionset

The <optionset> element defines the name of the option set to manage.

The following table describes what the option set specifies within each command.

Command

What option set defines

<register> command 1

Specifies an option set defined in an external file to import

<export> command

Specifies the name of an option set to export

<create> command

Specifies the name of the option set to create

<rename> command 2

Specifies the name of the option to rename

1 When you use the <optionset> element within a <rename> command, the <newname> and <instance> elements are the only valid children.

2 When you use the <optionset> element within a <rename> command, the <newdescription> element is the only valid child.

Parent element: <register>, <create>, <deregister>, <export>, or <optionsets>

Child elements: <name> (0:1), <instance> (0:1), <prodcode> (0:1), <prodvrsn> (0:1), <description> (0:1), <newname> (0:1), and <newdescription> (0:1)

Attributes:

Name

Type

Required?

Default

Description

dd

string

no


Identifies the DD statement that contains the option set definition. It is only valid when used with the <register> command element

replace

string

no

no

Identifies whether to replace an existing option set.

Valid values are yes and no.

  • If you specify yes when registering an option set, the option set replaces any existing option set with the same name.
  • If you specify yes when creating an option set, the option set replaces any existing option set with the same name.

type

string

no

display_config

Indicates the type of template to use for the option set.

Example:

The following example shows how to use the <optionset> element when exporting the option set.

     <export format="xml">
  <ddname>DOM</ddname>                           
  <optionsets>                                         
     <optionset>       
        <name>ADS8</name>                        
        <prodcode>DOM</prodcode>                 
        <prodvrsn>1010</prodvrsn>                
     </optionset>                                      
     <optionset>       
        <name>AFDPLEX</name>                     
        <prodcode>DOM</prodcode>                 
        <prodvrsn>1010</prodvrsn>                
     </optionset>                                      
  </optionsets>                                        
</export>

The following example shows how to use the <optionset> element when registering an option set.

<register>                                                 
  <!-- Note that no child elements are required -->          
  <!-- because the option set is defined completely -->            
  <!-- in an external file. -->
  <optionset dd="OPSET" replace="yes" />
</register>

The following example shows how to use the <optionset> element when removing an option set.

  <deregister>                                               
  <optionset>                                              
    <prodcode>DOM</prodcode>                         
    <prodvrsn>1010</prodvrsn>                        
    <name>ADS8</name>                                
  </optionset>                                             
</deregister>


Related topic

Supporting-elements


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*