start

This command starts a local server.

Syntax

Enter the command using the syntax shown below. Available options are shown in brackets.

zosadmin start [--dir=] [--jvmargs=] [--javaargs=] [--timeout=] [--upgrade] [--snapshot=]

Options

When you add an option, use the syntax in the command line as shown above (where options are shown in their long form). Short and long options for this command are listed below.

-d, --dir <value>

Specify the working directory for a PlateSpin Orchestrate installation.

-b, --jvmargs <value>

Pass the value as an argument to an invoked JVM process.

-B, --javaargs <value>

Pass the value as an argument to an invoked Java program.

-t, --timeout <value>

Specify the query timeout (in seconds).

-G, --upgrade

Switch upgrade behavior for snapshot handling.

-S, --snapshot=

Upgrade a server using the snapshot directory of an existing server.

-V, --debug

Turn on debug output during this operation.

-v, --verbose

Turn on verbose output during this operation.

-h, --help

Display a help message for this operation.

Examples

Example 1

To start a server instance using the install directory (default), use the following command:

zosadmin start

Example 2

To start a server instance using directory /zos/server/, use the following command:

zosadmin start --dir=/zos/server

Example 3

To start a server instance and upgrade from an existing server snapshot, use the following command:

zosadmin start --upgrade --snapshot=/oldzos/server/snapshot

NOTE:Before you use this option, you must be using the “zosadmin upgrade” command to manually upgrade the server configuration snapshot.

Example 4

To start a server instance setting the JVM maximum memory to be 4 Gb:

zosadmin start --jvmargs=-Xmx4g