SDM Prototype Generator (ProtoGen.exe) [SDM]
| Platform SDK: System Definition Model Overview |
SDM Prototype Generator (ProtoGen.exe)
Note: This documentation is preliminary and is subject to change.
The SDM Prototype Generator (ProtoGen.exe) tool generates an initial Distributed System Designer prototype file for an abstract type. The file that is generated can be an application prototype (.adprototype), a logical server prototype (.lddprototype), or an endpoint prototype (.adprototype or .lddprototype).
ProtoGen.exe /File <file> /Layer <layer> /Position <position> /Bitmap <file> /Output <directory>
FakePre-a544c0d56cec4c8f85d7299e8ac28c2d-29e0c7fdade740b0a16c47cf097a4bf0
Arguments
/File <file>
Short form: /FRequired. The name of the .sdmdocument file to process. Prototypes will be created for all valid SDM types in the file.
You can use either the /File switch or the /Type switch with the Protogen tool. If the /File switch is used, no other switches are required.
/Type <type>
Short form: /TRequired. The SDM type.
“System”
“Endpoint”You can use either the /File switch or the /Type switch with the Protogen tool. If the /Type switch is used, the /Layer, /Document, and /TypeName switches are required.
/Layer <layer>
Short form: /LIf the /Type switch is used: Required. The layer for which the prototype is being generated. Specify a value of Application for an Application Designer prototype or Host for a Logical Datacenter Designer prototype.
This value defaults to the layer that is specified in <typeName>. If no layer is specified by <sdmType> or by the /Layer option, an error is returned.
If the /File switch is used: Optional. The default layer for SDM types (endpoints or systems) whose layer is not explicitly specified in the .sdmdocument file. If this switch is not used, the prototypes are not generated for types that are missing the Layer attribute. Valid values: Application or Host.
/Document <name>
Short form: /DRequired. The identity of the .sdm file that contains the SDM type.
/TypeName <sdmTypeName>
Short form: /NRequired. The name of the SDM type.
/Output <file>
Short form: /O- If the /Type switch is used: Optional. The filename for the output prototype. This value defaults to the <sdmTypeName> value specified with <layer> specific extensions (.adprototype or .lddprototype).
- If the /File switch is used: Optional. The directory to which to output the prototypes. The default directory is the working directory.
/Name <name>
Optional. The name of the prototype in the Toolbox. This value cannot contain white space. It is used by Visual Studio as the F1 keyword for the Toolbox item. This value defaults to the <sdmTypeName> value specified./Bitmap <file>
Short form: /BOptional. The filename of a 16x16 pixel bitmap to display as the Toolbox icon. This value defaults to the standard SystemDefinition icon for application and logical server prototypes, and to the standard EndpointDefinition icon for endpoint prototypes.
/Caption <caption>
Short form: /COptional. The tooltip for the prototype in the Toolbox. This value defaults to the <typeName> value specified.
/Position <position>
Short form: /POptional. The integer value used to position the toolbox item. This value defaults to the total number of items in the list of toolbox items (the end of the list).
Example Code
The following example creates the MyLogicalServer.lddprototype file.
ProtoGen /Type System /Layer Application /Document Microsoft.Samples.MyLogicalServer.sdm /TypeName MyLogicalServer /Output /MyLogicalServer.lddprototype
See Also
How to: Create an SDM Endpoint
| Last updated: June 2005 | What did you think of this topic? | Order a Platform SDK CD |
| © Microsoft Corporation. All rights reserved. Terms of use. |