Parameter, élément

Un paramètre contrôle une partie spécifique de la fonctionnalité d'une commande. Il existe de nombreux types de paramètre ; l'élément Parameter est suffisamment flexible pour couvrir les différents types de fonctionnalité fournis par les paramètres. Les sous-commandes contiennent zéro ou plusieurs paramètres.

Tableau 1. Attributs de paramètre
Attribut	Utilisation	Descriptif	Valeurs valides
Name	required	Nom du paramètre. Les noms de paramètre sont limités à des caractères ASCII 7 bits et doivent commencer par une lettre ou l'un des caractères @, # ou $. Les caractères suivants peuvent être n'importe quelle combinaison de lettres, de chiffres, de caractères de non-ponctuation et d'un point (.).	Tout
ParameterType	required		DatasetName. Indique un nom de jeu de données. La valeur sera vérifiée pour vérifier l'exactitude de la syntaxe (les mêmes règles que pour les noms de variable), mais elle n'existera pas. La casse est conservée lorsqu'elle est transmise à la fonction Run .
			Integer. Nombre sans partie fractionnaire après la conversion. Vous pouvez éventuellement spécifier un ensemble de valeurs de mot clé autorisées pour un paramètre Integer , à l'aide d'éléments EnumValue .
			IntegerList. Liste de types Integer , séparés par des espaces ou des virgules.
			Keyword. Indique une valeur qui respecte les mêmes règles que l'attribut Name d'un élément Parameter . La valeur est transmise en majuscules à la fonction Run . Vous pouvez spécifier l'ensemble de valeurs autorisées à l'aide des éléments EnumValue . Des valeurs doivent être affectées aux paramètres de type Keyword . Pour spécifier un mot clé sans valeur associée, utilisez le type LeadingToken .
			KeywordList. Spécifie une liste de valeurs séparées par des virgules ou des espaces qui respectent les mêmes règles que l'attribut Name d'un élément Parameter . Pour spécifier une liste de valeurs non liées par ces règles, utilisez le type TokenList . Vous pouvez spécifier l'ensemble de valeurs autorisées à l'aide des éléments EnumValue .
			LeadingToken. Indique un paramètre ayant un nom (donné par l'attribut Name de l'élément Parameter ) mais sans valeur associée. Le nom est transmis en majuscules à la fonction Run .
			Number. Nombre, éventuellement en notation scientifique à l'aide de e ou E. Vous pouvez éventuellement spécifier un ensemble de valeurs de mot clé autorisées pour un paramètre Number , à l'aide d'éléments EnumValue .
			NumberList. Liste de types Number , séparés par des espaces ou des virgules.
			QuotedString. Chaîne entre guillemets simples ou doubles. La casse est conservée lorsqu'elle est transmise à la fonction Run . Vous pouvez éventuellement spécifier un ensemble de valeurs de mot clé autorisées (sans guillemets) pour un paramètre QuotedString , à l'aide d'éléments EnumValue .
			TokenList. Indique une liste de valeurs séparées par des virgules ou des espaces. La casse est conservée lorsque des valeurs sont transmises à la fonction Run . Le type TokenList est similaire au type KeywordList , mais les valeurs TokenList ne sont pas liées par les règles requises des valeurs KeywordList .
			VariableName. Indique un nom de variable. La valeur sera vérifiée pour vérifier l'exactitude de la syntaxe (voir les règles pour les noms de variable dans la référence de syntaxe de commande), mais elle n'existe pas. La casse est conservée lorsqu'elle est transmise à la fonction Run .
			VariableNameList. Indique une liste de noms de variables. Chaque nom de la liste sera vérifié pour s'assurer de l'exactitude de la syntaxe, mais pas de son existence. La casse est conservée lorsque des valeurs sont transmises à la fonction Run . Les mots clés TO et ALL ne sont pas pris en charge.
			InputFile. Spécification de fichier pour un fichier d'entrée. Le fichier spécifié doit exister. La casse est conservée lorsqu'elle est transmise à la fonction Run .
			OutputFile. Spécification de fichier pour un fichier de sortie. Le chemin de répertoire spécifié doit exister et le fichier spécifié n'existe pas ou, s'il existe, il doit être accessible en écriture. La casse est conservée lorsqu'elle est transmise à la fonction Run .

Représentation XML

<xs:element name="Parameter" type="parameter-content"> 
   <xs:sequence maxOccurs="unbounded" minOccurs="0"> 
      <xs:element name="EnumValue"></xs:element> 
   </xs:sequence> 
   <xs:attribute name="Name" use="required"></xs:attribute> 
   <xs:attribute name="ParameterType" use="required"> 
      <xs:simpleType> 
         <xs:restriction base="xs:token"> 
            <xs:enumeration value="DatasetName"></xs:enumeration> 
            <xs:enumeration value="Integer"></xs:enumeration> 
            <xs:enumeration value="IntegerList"></xs:enumeration> 
            <xs:enumeration value="Keyword"></xs:enumeration> 
            <xs:enumeration value="KeywordList"></xs:enumeration> 
            <xs:enumeration value="LeadingToken"></xs:enumeration> 
            <xs:enumeration value="Number"></xs:enumeration> 
            <xs:enumeration value="NumberList"></xs:enumeration> 
            <xs:enumeration value="QuotedString"></xs:enumeration> 
            <xs:enumeration value="TokenList"></xs:enumeration> 
            <xs:enumeration value="VariableName"></xs:enumeration> 
            <xs:enumeration value="VariableNameList"></xs:enumeration> 
            <xs:enumeration value="InputFile"></xs:enumeration> 
            <xs:enumeration value="OutputFile"></xs:enumeration>
         </xs:restriction> 
      </xs:simpleType> 
   </xs:attribute> 
</xs:element>

Eléments parent

Elément de sous-commande

Eléments enfant

ElémentEnumValue