Additional Administrative Tasks

Starting Rochade Server

The Rochade Server is controlled through an initialization file and, therefore, can be started in the same way under all operating systems.

Format

<server> [/noservice] [<section> [<inifile>]][<setting>=<val> ...]

Parameters

<server>	Name of the Rochade Server
/noservice	Windows-specific parameter for calling the server
<section>	Name of the section in the initialization file where processing starts
<inifile>	Name of the initialization file that the component accesses
<setting>	Name of a setting for the Rochade Server
<val>	Value of the setting

Description

• The <server> accesses a <section> in the initialization file <inifile>.
• To run the Rochade Server under z/OS, you must activate the UNIX System Services by setting the run-time option POSIX(ON) in the server start jobs.
• When using Kerberos authentication, you also must set the run-time option POSIX(ON) in the client start jobs.
• The parameter /noservice is only useful for the server start under Windows.

You can specify this parameter if you do not want to start the server as a Windows service. In this case, there will be no check as to whether the server was started as a service, and the server startup time will be reduced by about 15 seconds.

• The <section> parameter specifies the name of the start section in the initialization file. The start section contains the required settings for Rochade Server. If the <section> parameter is not specified, the value ROSRV is used.
• The <inifile> parameter specifies the file name for the initialization file.

Since different operating systems search for files in a different order, ASG recommends that you specify a fully qualified path name for the initialization file and that you use different file names for different initialization files. See also Specifying Files under z/OS.

If the setting <inifile> is not specified, these default values are used depending on the operating system:

Operating System	Default Name of the Initialization File
Windows	rochade.ini
UNIX	./rochade.ini
z/OS	Member name ROINI (in preallocated PO dataset with fixed ddname ROINI)

Under Windows, if you do not specify the initialization file or if you specify only the file’s name but not its path, Rochade Server searches for the file in certain directories using this search sequence:

• Current directory
• Windows directory
• Windows system directory
• The directory that holds the component to be executed
• The path
• The <section> and <inifile> parameters must not contain equal signs (=) since these would be interpreted according to the <setting>=<val> syntax.
• It is also possible to define settings on the command line by passing command line parameters with the syntax <setting>=<val>. For z/OS, note what is said about this in Passing Parameters under z/OS.