About the windchill Command

PTC has provided a command, windchill, to invoke Windchill actions. For example, the command can be used to stop and start Windchill, check the status of the Windchill server, and create a new shell and set the environment variables. It can also be used as a Java wrapper. In that regard, it can accept a Class file as an argument, just like Java, and execute it without a predefined environment (Windchill classes in CLASSPATH, Java in PATH, and so on).

The windchill command should be used to execute any server-side Windchill Java code. This will ensure that the environment that the command is executed in is properly setup. The environment that actions are executed within, including the windchill shell action, is defined by the wt.env properties in the wt.properties file. For example, the wt.env.CLASSPATH property will set the CLASSPATH environment variable for the action that is being invoked.

The windchill command is a Perl script that has also been compiled into a Windows binary executable. For UNIX systems, Perl 5.0 or greater must be installed. The windchill script assumes that Perl is installed in the standard install location of /usr/bin/perl. If Perl is not installed at this location, you can either create a symbolic link (recommended method) to the Perl install location or edit the windchill script to reference the Perl install location. To modify the windchill script, edit the <Windchill>/bin/windchill file. Locate the #! entry (for example, #!/usr/bin/perl -w) and change the Perl directory to the location where Perl is installed.

The windchill command is located in the <Windchill>/bin directory. If you receive a command not found message when you execute the windchill command, add the <Windchill>/bin directory to your PATH environment variable. The syntax of the windchill command is:

Arguments (optional)

Description

-h, --help

Displays help and exits.

-v, --[no]verbose

Explains what is being done when a command is executed. Default is:

-- noverbose

-w, --wthome=DIR

Sets the Windchill home directory. Default is the parent directory containing the windchill script.

On UNIX systems where you have multiple instances of Windchill installed under the same user account, settings made to WT_HOME and SQLPATH environment variables by using this -w option are overridden by any settings to these same variables in the user's .cshrc, .login, and .profile shell initialization files.

--java=JAVA_EXE

The Java executable. Default is the wt.java.cmd variable value specified in the $WT_HOME/codebase/wt.properties file.

-cp,

--classpath=PATH

Java classpath. Default is the wt.java.classpath variable value specified in the $WT_HOME/codebase/wt.properties file.

--javaargs=JAVAARGS

Java command line arguments.

Action	Description
shell	Sets up a Windchill environment in a new instance of the currently running shell.
start	Starts the Windchill server.
stop	Stops the Windchill server.
status	Retrieves the status of the Windchill server.
version	Displays the Windchill installation version.
properties <resource> [,...][?key[&key2]...]	Displays the properties as seen by Windchill for the given resource with substitution and other actions executed. It can be limited to a given set of keys. For example: windchill properties wt.properties – lists all wt.properties windchill properties wt.properties?wt.server.codebase – lists server codebase windchill properties wt.properties?wt.env.* – lists all the environment variables use by windchill shell windchill properties – generates the help report with no arguments
CLASS [CLASS_ARGS]	Run a Windchill class with optional class arguments. For example: windchill wt.load.Developer -UAOps