Edit ServerWarning:Note:

Add Handler

Add Listener

Add Package

Add Service

Advanced

Application Container

Auxiliary Trace Active

Cold Start Diagnostics File

Communications

Configuration Information

Copy

Delete

Description

Dump on System Abend

Handlers

Handlers entry field

Listeners

Listeners entry field

Local Trace Size

Mainframe Transaction Option

Maximum Diagnostics File Size

Name

Packages

Packages entry field

Requested Licenses

Request Handler

RM Interface

Save

Server Address

Servers

Service Execution Processes

Services

Services entry field

Shared Memory Cushion

Shared Memory Pages

Show Local Console

Startup Options

Storage Control

System Directory

Table Management

Task Control

Trace Flags

Trace Table Size

Edit ServerWarning:Note:

Use this page to change configurable attributes of a server.

Warning: Changing the properties of a registered server may cause application connection errors and loss of data.

Note: For more information about the configurable attributes of servers, see the chapter Configuration in your Configuration and Administration Guide.

Top

Servers

Click this to return to the list of all the servers registered with this Directory Server, on the Home page.

Top

Listeners

Click this to view a list of all the registered listeners registered with this server.

Top

Services

Click this to view a list of all the registered services registered with this server.

Top

Handlers

Click this to view a list of all the registered request handlers registered with this server.

Top

Packages

Click this to view a list of all the registered packages registered with this server.

Top

Name

Specify the unique name of the server, up to 8 characters. You can change the name only if the server has the status "Stopped". You cannot include angle brackets (<>) or ampersands (&) in the name.

Top

Server Address

Shows the network address used by the server to accept incoming client requests. The format is:

protocol:ip-address:port

where:

If this network address is not unique in the repository, this may cause enterprise server startup problems.

Top

Handlers entry field

Shows the number of request handlers registered with this server.

Top

Add Handler

Click this to add a request handler.

Top

Listeners entry field

Shows the number of service listeners registered with this server.

Top

Add Listener

Click this to add a service listener.

Top

Services entry field

Shows the number of services registered with this server.

Top

Add Service

Click this to add a service.

Top

Packages entry field

Shows the number of implementation packages registered with this server.

Top

Add Package

Click this to add a package.

Top

System Directory

Specify the location for system work files output by the Directory Server, such as trace and dump diagnostics files. This directory cannot be shared between enterprise servers. On Windows the default is install-dir\base\workarea\es-name if Enterprise Server is installed as part of Net Express or install-dir\workarea\es-name if Enterprise Server is installed standalone, where es-name is the name of the enterprise server. On UNIX the default is /var/mfcobol/es es-name, where es-name is the name of the enterprise server.

Top

Startup Options

Use these fields to specify the server configuration you want when the server first starts up. Any changes you make to these fields while a server is running do not take effect until the next time you start the server.

Top

Shared Memory Pages

Specify the number of shared pages in memory to be reserved for all the processes that run in the Directory Server. Each page is 4 KB long.

Top

Service Execution Processes

Specify the number of service execution processes that are to be started at server initialization.

Top

Shared Memory Cushion

Specify the number of 4KB pages that should be reserved from the shared memory pages to allow the server to continue processing when the shared memory allocation is too small for the operational requirements of the server. The range is 1 through the number of shared memory pages.

Top

Trace Table Size

Specify the number of entries the trace buffer can hold before it wraps back to the start. (The trace buffer is also written to disk at this point if you checked Auxiliary Trace Active.) A value of 2 means that there is space for only one entry, and if you checked Auxiliary Trace Active each entry is written straight out to disk. Each entry is 24 bytes long.

Top

Local Trace Size

Specify the number of entries the local trace table can hold before it wraps back to the start. A value of 0 (zero) means that no local trace table is allocated. Each service execution process has its own local trace table. Each entry is 24 bytes long.

Top

Maximum Diagnostics File Size

Specify the maximum size of the auxiliary trace and dump file in kilobytes. A value of 0 (zero) means that there is no maximum size.

Top

Requested Licenses

Specify the number of licenses this enterprise server requires.

Top

Cold Start Diagnostics File

Check this to indicate that the auxiliary trace and dump files are to be deleted when the server starts.

Top

Dump on System Abend

Check this to indicate that the server should produce a dump if one of its own processes, such as a service execution process, terminates abnormally. The dump information can help you to determine the cause of the abnormal termination

Top

Auxiliary Trace Active

Check this to indicate that trace records are to be flushed to disk before the trace table is overwritten. You should do this only if you have adequate disk space available, since the file can become very big very quickly. If you have a high-activity system use this field in conjunction with Maximum Diagnostics File Size to limit the disk usage. Writing out to a file also degrades performance.

Top

Show Local Console

Check this if you want to see a text window containing enterprise server messages while the server is running. the messages are written to a file called console.log, in the directory specified in System Directory. You can see the text window only on the machine running the enterprise server. The system messages are also available on the Enterprise Server Console page.

Top

Mainframe Transaction Option

Check this to indicate that this server is an MTO-enabled server, that is, a server that can run CICS applications.

Top

Trace Flags

Use these flags to control what information is written to the trace file for this server. Any changes you make to these fields while a server is running take effect immediately.

Top

Task Control

Check this to indicate that the server is to trace its task control component.

Top

Storage Control

Check this to indicate that the server is to trace its storage control component.

Top

Table Management

Check this to indicate that the server is to trace its table management component.

Top

Application Container

Check this to indicate that the server is to trace its application container component.

Top

Request Handler

Check this to indicate that the server is to trace its request handler component.

Top

RM Interface

Check this to indicate that the server is to trace its resource manager interface component.

Top

Communications

Check this to indicate that the server is to trace its communications component.

Top

Advanced

Click this if you want to specify the details of an external resource manager that the server needs to communicate with on behalf of container-managed applications.

Top

Configuration Information

Specify textual configuration information that determines the startup and run-time behavior of the server. Optional.

Top

Description

Specify a text description of the server, for example, its purpose and owner. Optional.

Top

Save

Click this to save information about this server and the objects it contains in a specified location.

Top

Delete

Click this to delete this server.

Top

Copy

Click this to create a new server that is identical to this server apart from its name.

Top