zosconnect command syntax

Use the zosconnect command to create a IBM® z/OS® Connect server, or perform other tasks on that server.

Tip: Enter the zosconnect command from the <installation_path>/bin directory. For example, /usr/lpp/IBM/zosconnect/v3r0/bin

Syntax

zosconnect  <action>  <serverName>  <options>

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.

Examples

zosconnect create myserver --template=zosconnect:default
zosconnect start myserver --clean