Try OpenEdge Now
skip to main content
Startup Command and Parameter Reference
Startup Parameter Descriptions : Service Name (-S)
 

Service Name (-S)

Use Service Name (-S) to specify the service or port number to be used when connecting to a broker process or used by a broker process on the host machine.
Operating system and syntax
UNIX / Windows
-S { service-name | port-number}
Use with
Maximum value
Minimum value
Single-user default
Multi-user default
Client Connection, Database Server
service-name
The name of the service to be used by the broker process.
port-number
The port number of the host; if using OpenEdge Management or OpenEdge Explorer, the port number of the NameServer.
You must use this parameter when starting:
*A broker or server on a machine that will serve remote users
*Multi-user OpenEdge session as a remote user
The system administrator must make an entry in the services file that specifies the server or broker name and port number.
When the broker spawns a server, the server inherits all of the network parameters (except the Service Name parameter) from the broker. Because there is no restriction on the number of brokers you can start, you can have multiple brokers running with different network parameters. See also the Server Group (-servergroup) startup parameter description.
The following table shows how the broker, server, and remote client interpret each of their parameters when you use the -S parameter.
Table 5. Parameter interpretation with Service Name (-S)
Module
Interpretation
Broker
Parameters apply to the connections on which the broker is listening for connection requests from remote clients
Server
Parameters apply to the connection between the server and the remote client
Remote Client
Parameters identify the connection parameters to the broker or the server
To run multi-user OpenEdge from a remote network node, use both the Host Name (-H) and Service Name (-S) parameters.