Subcommand element

Subcommands divide a command’s functionality into distinct groups. Typical subcommands include SAVE for specifying variables to be saved to the active dataset, PRINT for specifying tabular output, and PLOT for specifying chart output. A subcommand can only be specified once per command. The name of a subcommand must be preceded by a forward slash when specified in command syntax.

Table 1. Subcommand attributes
Attribute Use Description Valid Values
IsArbitrary optional Allows arbitrary tokens on the subcommand. This is useful, for example, for specifying variable lists and model effect lists.

True

False

Yes. Equivalent to True.

No. Equivalent to False.

Name required The name of the subcommand. Subcommand names are restricted to 7-bit ASCII characters and start with a letter or one of the characters @, #, or $. Subsequent characters can be any combination of letters, numbers, non-punctuation characters, and a period (.). Use Name="" to specify the anonymous subcommand. any
Occurrence optional Specifies whether the subcommand must be included in a syntax job for the command to run.

Required

Optional

XML representation

<xs:element name="Subcommand" type="subcommand-content"> 
   <xs:sequence>
      <xs:element minOccurs="0" maxOccurs="unbounded" ref="Parameter"></xs:element> 
   </xs:sequence> 
   <xs:attribute name="Name" use="required"></xs:attribute> 
   <xs:attribute name="Occurrence">
      <xs:simpleType>
         <xs:restriction base="xs:token">
            <xs:enumeration value="Required"></xs:enumeration>
            <xs:enumeration value="Optional"></xs:enumeration>
         </xs:restriction>
      </xs:simpleType>
   </xs:attribute>
   <xs:attribute name="IsArbitrary">
      <xs:simpleType>
         <xs:restriction base="xs:token">
            <xs:enumeration value="True"></xs:enumeration>
            <xs:enumeration value="False"></xs:enumeration>
            <xs:enumeration value="Yes"></xs:enumeration>
            <xs:enumeration value="No"></xs:enumeration>
         </xs:restriction> 
      </xs:simpleType> 
   </xs:attribute> 
</xs:element>

Parent elements

Command element

Child elements

Parameter element