Software AG Products 10.7 | Integrating On-Premises and Cloud Applications | Service Development | Properties | Service Properties | Run Time Properties for Services
 
Run Time Properties for Services
In the Properties view, under Run time, you can specify the following service properties:
*State of a service. You can indicate whether or not you want the server to treat it as a “stateless” service at run time
*Caching of service results. You can cache elements to reduce memory usage in Integration Server.
*Execution locale of a service. You can set the type of locale in which the Integration Server executes at run time.
*Creating a URL alias for a service. You can create an alias for the path portion of the URL used to invoke a service.
*Saving and restoring of the pipeline. You can save the pipeline or restore a previously saved pipeline at run time.
*XML format for the service input. If the service receives an XML document, you can specify the format that Integration Server uses for the document when it passes the document to the service.
*HTTP methods for a service. You can select the HTTP methods that can be configured for a service. This selection overrides the HTTP methods configured for a resource corresponding to the service.
Important:
The Run time properties in the Properties view should only be set by someone who is thoroughly familiar with the structure and operation of the selected service. Improper use of these options can lead to a service failure at run time and/or the return of invalid data to the client program.
Property
Description
Stateless
Specifies whether or not Integration Server is required to maintain state information for this service for the duration of the client session. Select True if the service is a self-contained, atomic unit of work and does not need access to state information. This reduces the number of server resources it consumes at run time. Select False if the service is part of a multi-service transaction or if you are unsure of its state requirements.
The default is True.
Cache results
Indicates whether Integration Server stores the service results in a local cache for the time period specified in the Cache expire property. After the service executes, the server places the entire pipeline contents into a local cache. When subsequent requests for the service provide the same set of input values, the server returns the cached results instead of invoking the service again. Select True to cache the service results. Select False if you do not want to cache service results. Cache results for stateless services only.
The default is False.
Note:
Caching is only available for data that can be written to the repository. Because XML nodes cannot be written to the repository, they cannot be cached.
Note:
This property relates specifically to the caching of service results described in About Service Caching. This property does not affect caching that is performed by the services in the pub.cache folder.
Cache expire
Specifies the amount of time that the pipeline contents stay in memory after they are cached. If you enable the Cache results property, type an integer in this field representing the number of minutes you want a result to remain cached. The expiration timer begins when the server initially caches the results. The server does not restart the expiration timer each time it retrieves the results from cache. The minimum cache expiration time is one minute.
Note:
This property relates specifically to the caching of service results described in About Service Caching. This property does not affect caching that is performed by the services in the pub.cache folder.
Reset cache
Click Reset to clear the cached results for this service.
Note:
This property relates specifically to the caching of service results described in About Service Caching. This property does not affect caching that is performed by the services in the pub.cache folder.
Prefetch
Determines whether Integration Server automatically refreshes a cached result when it expires by re-executing the service using the same inputs. To automatically refresh this service's cached results, set Prefetch to True. (Prefetch can consume a substantial amount of server memory; consult your Server Administrator before using this option.)
The cache may not be refreshed at the exact time specified in Cache expire. It may vary from 0 to 15 seconds, according to the cache sweeper thread. For details, see the watt.server.cache.flushMins setting in Integration Server.
Note:
This property relates specifically to the caching of service results described in About Service Caching. This property does not affect caching that is performed by the services in the pub.cache folder.
Prefetch activation
Specifies the minimum number of times that a cached result must be accessed (hit) with the same inputs in order for the server to prefetch results when it expires. If you enable Prefetch, you must specify an integer representing the minimum number of hits a cached result must receive to be eligible for prefetch. (Entries that do not receive the minimum number hits are released from memory.)
Note:
The cache may not be refreshed at the exact time the last hit fulfills the Prefetch Activation requirement. It may vary from 0 to 15 seconds, according to the cache sweeper thread. For details, see the watt.server.cache.flushMins setting in Integration Server.
Note:
This property relates specifically to the caching of service results described in About Service Caching. This property does not affect caching that is performed by the services in the pub.cache folder.
Execution locale
Specifies the locale in which this service will be executed.
HTTP URL Alias
Specifies an alias for the path portion of the URL used to invoke a service.
For a flow service, the path portion of the URL consists of the invoke directive and the fully qualified service name. For a REST service, the path portion of the URL consists of the rest directive and the location of the REST resource folder in which the service resides.
Pipeline debug
Determines whether Integration Server automatically saves or restores the pipeline after the service executes. This option is useful for testing and debugging the service.
Select...
To...
None
Run the service without saving or restoring the pipeline. This is the default.
Save
Save the entire pipeline contents to a file when the service executes.
Restore (Override)
To restore the pipeline from a file when the service executes.
Restore (Merge)
To merge the pipeline with one from a file when the service executes.
When this option is selected and the input parameters in the file match the input parameters in the pipeline, the values defined in the file are used in the pipeline. If there are input parameters in the pipeline that are not matched in the file, the input parameters in the pipeline remain in the pipeline.
Note:
The options you select can be overwritten at run time by the value of the watt.server.pipeline.processor property, set in the server configuration file. This property specifies whether to globally enable or disable the Pipeline debug feature. The default enables the Pipeline debug feature on a service-by-service basis. For more information on setting properties in the server configuration file, see webMethods Integration Server Administrator’s Guide.
Note:
When using MTOM streaming for SOAP attachments, messageContext variables and/or XOPObject fields will not be available in the saved pipeline. A messageContext variable is used by many pub.soap services to hold the SOAP message on which the service acts. XOPObject fields are Objects that use the com.wm.util.XOPObject Java wrapper type. For more information about MTOM Streaming, see the Web Services Developer’s Guide.
Default xmlFormat
The default XML format for XML documents received by the service.
Note:
You can specify the default XML format for flow services and Java services only. The Default xmlFormat property is not available for C/C++ services, .NET services, or web service connectors.
Select...
To...
<blank>
Specify that Integration Server obtains the default XML format from the watt.server.http.xmlFormat server configuration parameter. This is the default.
For more information about the watt.server.http.xmlFormat server configuration parameter, see webMethods Integration Server Administrator’s Guide.
bytes
Specify that Integration Server uses a byte array as the default XML format. Integration Server passes the XML document directly to the service as a byte array without parsing the XML. Integration Server places the byte array in the input pipeline of the target service in a variable named xmlBytes.
enhanced
Specify that Integration Server uses a node parsed by the enhanced XML parser as the default XML format. Integration Server parses the XML automatically using the enhanced XML parser. Integration Server uses the default options specified for enhanced XML parsing on the Settings > Enhanced XML Parsing page in Integration Server Administrator. Integration Server passes the XML document to the target service as a node that implements the w3c.com.Node interface. Integration Server places the node in the input pipeline of the target service in a variable named node.
Note:Integration Server writes the XML document to a cache during parsing only if caching is configured for enhanced XML parsing. Integration Server uses BigMemory while parsing only if caching is configured and BigMemory is enabled for use with enhanced XML parsing. For more information about configuring a cache andBigMemory for XML parsing, see webMethods Integration Server Administrator’s Guide.
node
Specify that Integration Server uses a node parsed by the legacy XML parser as the default XML format. Integration Server parses the XML automatically using the legacy parser and passes it to the target service as a node. Integration Server places the node in the input pipeline of the target service in a variable named node
stream
Specify that Integration Server uses an InputStream as the default XML format. Integration Server passes the XML document directly to the service as an XML stream without parsing the XML. Integration Server places the XML stream in the input pipeline of the target service as an InputStream named xmlStream.
Allowed HTTP methods
Click to select the HTTP methods that you can configure for a service. The supported methods are GET, HEAD, PUT, POST, PATCH, DELETE, and OPTIONS.
Important:
If the service already has REST resources configured, Designer displays a warning message if you change the selection of the allowed HTTP methods to exclude any method used in the configuration of the resources. In such a situation, any client request invoking the excluded method will fail.
Therefore, you must ensure that the set of HTTP methods configured for a REST resource is always a subset of the methods allowed for the underlying service.