Skip to Content
Information
Space announcement We are no longer updating this version of the documentation for the infrastructure components (DBC, LGC, and NGL).  You can no longer leave comments on it. For the latest version of the documentation, see Common Mainframe Infrastructure 2022 release.

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>

 

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

Common mainframe infrastructure 2016 release