Attachment: attach

Use the attach command to attach a file to a project.

The attach command returns the ID of the newly created or updated attachment.

Syntax

The syntax for this command is:

stcmd{Ex} attach –p “user:pwd@host:port/project/view” 
[ -epwdile “pathToPasswordFile” ] –type “typeName” –id itemID 
-afp attachmentFilePath  [ -an “attachmentName” ] [ -rmv ]

Parameters

For information about the command parameters, refer to Operation Parameters.

In addition:

Parameter	Description
-id	Can be either the unique item (view member) ID of the item. Find View Member IDs by looking in the property lists of the StarTeam Cross-Platform Client or can be queried using the select command, or the primary descriptor of the item, for example, changerequest, task, or requirement number.
-afp	Provides the fully qualified path to the attachment on disk.
-an	Describes an optional attachment name. If this is not specified, the file name is used as the attachment name. If an attachment with this name already exists, attached to this item, then the original attachment content is replaced.
-rmv	Is an optional parameter that specifies that the attachment with the given name (either from -afp or -an) should be removed.