Make Public: make-public

Use make-public to convert private filters or queries into public filters or queries. This command is available on StarTeam Server 16.1 and later.

The type name is required.

Either one or both of filterName or queryName must be provided. If both are provided, then both the filter and query pair will be made public. If neither one is provided, the command fails with an exception. If only one of the two is provided, then the specified filter or query will be made public.

When working with private filter or query pairs, both filter and query names must be specified. Otherwise, the server will throw an exception.

Syntax

The syntax for this command is:

make-public –type typeName [ -filter filtername] [ -query queryName ] –s “user:[password]@host:port”  [ -epwdfile “path to password file” ]
Parameter
Description
-type
Specifies the type of item. The type is one of the stock type names, such as changerequest, task, requirement, sprint, story, plan or any custom type name that is applicable to the command.
-filter
Specifies a string of one or more characters, each of which represents a file status. Never include spaces or other white space in this string. Only files that currently have the specified status(es) will be actioned. Does not apply to files that are Not In View.
  • C = Current
  • M = Modified
  • O = Out of date
  • N = Not In View
  • I = Missing
  • G = Merge
  • U = Unknown
For example, using CM applies a command only to files with a status of Current or Modified.
-filter takes precedence over -f NCI. If you use G, O, or U, you must also specify -I or -o. Otherwise the G, O, or U is ignored.
-filter also takes precedence over -f NCO. If you use G, M, or U, you must also specify -o to force the checkout operation. Otherwise, the G, M, or U is ignored.
-query
Specifies the query name to make public.
-s

Identifies the StarTeam Server. The full syntax is: -s "userName:password@host:portNumber"

For example: -s "JMarsh:password@orion:49201"

If the user name is omitted, the current user name is used. The user name in the example is “JMarsh”.

If the password is omitted, the user is prompted to enter the password. The password in the example is “password”. If the host name is omitted, the default is localhost. The host name in the example is “orion”.

The port number is required. The default port number, 49201, is used in the example.

-epwdfile

The -epwdfile keyword specifies the path to the file that contains the encrypted password. Like -pwdfile , -epwdfile replaces the password being used as part of the -p or -s option, preventing others from seeing the user's password on the command line. The full syntax is: -epwdfile "filePath" .

The -pwdfile is supported for backward compatibility. Un-encrypted passwords stored using older versions of stcmd are read. However, passwords cannot be stored to files using -pwdfile anymore.

Note: When -epwdfile is used, a password should not be specified as part of the -p or -sparameter.

In this case, the syntax of -p or -s reduces to -p "username@hostname:port/... -epwdfile "fullyQualifiedPathToPasswordFile"".

The following is the syntax of the commands that can be used to store an encrypted password.

Use the following syntax to be prompted for the password that will be encrypted and stored in a file.

stcmd store-password -epwdfile "filePath"
Use the following syntax to include the encrypted password in the command as clear text.
Note: This action does not access the network with the clear value.
stcmd store-password -epwdfile "filePath" -password "password"

After an encrypted password is stored, other stcmd commands can specify -epwdfile "filePath"' as parameters. For example:

stcmd delete-local -p "JMarsh@Orion:1024/StarDraw/StarDraw/SourceCode" -epwdfile "C:\estuff\myfile.txt" -filter "N" "*"
Important:

If -p or -s and -epwdfile are used together, then the parameter :password must be omitted from -p. For example:

-p user@hostname:port/projectName.viewName -epwdfile "pathToPasswordFile"

Example

The following example changes both a private filter and a private query to public.

make-public –type changerequest –filter “my private filter” –query “my private query” –s “Administrator:Administrator@localhost:49201”