zosconnect command syntax

Syntax

Parameters

<action>

The task that you want to perform:

create

Creates a IBM z/OS Connect server. Specify the server name and optionally, the name of a template.

For example, zosconnect create <serverName> --template=<template_name>

start

Launches the named server as a USS background process. Progress can be seen in the messages.log file. You can optionally specify the --clean option to clear the cache. For more information, see Starting and stopping IBM z/OS Connect.

Note: Do not use start when running IBM z/OS Connect as a started procedure.

For example, zosconnect start <serverName> [--clean]

serverName

The name of the server on which the action is performed. When serverName is not provided the name defaultServer is used.

options

--clean

Deletes all persistent cached information that is related to the specified server instance, which includes OSGi resolver metadata and persistent OSGi bundle data. If you use this option, the server will be required to recompute any cached data at the next startup, which might take more time than a restart that can reuse cached data.

Use only with the start parameter.

The --clean option is not necessary for normal operation. IBM service might request that you use this option when providing an interim fix, or if there is a suspected problem with the cached data. This option might also be necessary if you are developing a product extension, and you are either updating OSGi manifests or planning to clear persistent OSGi bundle data.

--template=templateName

Use only with the create parameter.

Specifies the name of the template to be used to create the server. See Supplied server templates for a description of the templates that are supplied with IBM z/OS Connect .