Edit Service

Accepting Listeners Add Associated Handler Associated Package Available Handlers Available Listeners Available Packages Configuration Information Current Status Description Logging | Name New Status Remove Search Order Select Handler Select Package Service Class Transaction Management Version

Edit Service

  Use this page to change configurable attributes of a service.

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

  Top

Name

  Specify the name of the service, up to 255 characters. You cannot include angle brackets (<>) or ampersands (&) in the name.

  A service name can consist of a service namespace and an operation name, separated by a special character. The character depends on which request handler is being used, MFRHSOAP or MFRHBINP.

  If there is no separating character, the name of the operation is considered to be the same as the service namespace.

  If the service will be using the MFRHSOAP request handler, the text before the first pound character (#) in the name is considered to be the service namespace and the text after is considered to be the name of the operation.

  If the service will be using the MFRHBINP request handler, the text before the last period character (.) in the name is considered to be the service namespace and the text after is considered to be the name of the operation.

  Note: You can change the name of a service only when the server has a status of "Stopped".

  Top

Search Order

  Specify the search order of the service. If more than one service object has the same name, then a program client can use Search Order to decide which service to use. The lower the search order is, the higher the search priority.

  Top

Service Class

  Specify the service class of the service (optional). This field provides a means of grouping services, so that a client program can ask for a class of service rather than a specific named service. Service classes beginning with MF are reserved for Micro Focus use. Service Class can be up to 32 characters in length.

  Top

Version

  Specify the version string of the service. This consists of three elements in decreasing order of significance: major version, minor version, build version. This can be used to distinguish between services of the same name or class.

  Top

Logging

  Check this to request that for each request for this service the request and response blocks are written to the enterprise server dump data set. Only use this option if you need diagnostics as it degrades performance.

  Top

Transaction Management

  Click one button to choose the type of transaction management that this service uses:

  - Application for a service in which the COBOL application manages their own transactions.
  - Container for a service in which the COBOL application leaves transaction management to the application container.

  If the client is transactional, such as a J2EE transactional request, this setting is ignored and the service is forced to be container-managed. Container-managed services should not make any explicit transactional requests, for example, EXEC SQL COMMIT WORK statements.

  Top

Current Status

  Shows the current status of the service. The possible statuses are:

  Available | The service is available.
  Invalid | An error has occurred such that it has not been possible to set the status to any other value
  Disabled | The service is disabled.

  Top

New Status

  Choose a status from the list. The possible statuses are:

  Available | The service is available.
  Disabled | The service is disabled.

  Top

Accepting Listeners

  Shows the listeners that will accept incoming client requests.

  Top

Available Listeners

  Lists the listeners that are available to be allocated to this service. Click a listener to select it for adding to Accepting Listeners. A service can have more than one listener.

  Top

Remove

  Click this to remove the selected listener from Accepting Listeners. There must be more than one listener in Accepting Listeners before you can click this.

  Top

Add

  Click this to add the selected listener to Accepting Listeners.

  Top

Available Handlers

  Lists the available request handlers. Click a request handler to select it to become the Associated Handler. You must add a listener before you can see Available Handlers and associate a handler with the service.

  Top

Select Handler

  Click this to make the selected request handler the Associated Handler.

  Top

Associated Handler

  Shows the request handler that is associated with this service, if any.

  Top

Available Packages

  Lists the available implementation packages. Click a package to select it to become the Associated Package. You must add a listener before you can see Available Packages and associate a package with the service.

  Top

Select Package

  Click this to make the selected package the Associated Package.

  Top

Associated Package

  Shows the implementation package that is associated with this service, if any.

  Top

Configuration Information

  Specify textual configuration information that determines the startup and run-time behavior of the service. Optional. For details of the valid entries, see the section Configuration Information in the chapter Services, Packages and Request Handlers in your Configuration and Administration Guide.

  Top

Description

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

  Top