HTTP reception definition file
Format
[urecp-http.context-root=Context root of HTTP reception] |
Function
Specify the operating information of HTTP reception. The contents that you specify in HTTP reception definition file become effective when HTTP reception starts.
Create HTTP reception definition file with the file name "cscurecphttp.properties".
File saving destination
<Service platform installation directory>\CSC\custom-reception\http\config\templates\cscurecphttp.properties
Properties that can be set
(1) HTTP reception related
urecp-http.context-root=Context root of HTTP reception ~<<Reception ID of HTTP reception>>
Specify the context root of HTTP reception with one-byte alphanumeric characters and single byte symbols shown as follows:
An error will occur if you specify symbols other than those mentioned above and in case of the following:
If you do not specify this property, reception ID of HTTP reception is set.
urecp-http.max-threads= Max. threads in HTTP reception ~<Number>((1-1024))<<10>>
Specify the maximum number of threads in HTTP reception. The value you specify for this property must be larger than the HTTP reception occupied threads count (value specified in the property urecp-http.exclusive-threads).
urecp-http.exclusive-threads=HTTP reception occupied execution threads count~<Number>((0-1024))<<0>>
Specify the HTTP reception occupied threads count. The value you specify for this property must not exceed the max. threads in HTTP reception (value specified in the property urecp-http.max-threads).
urecp-http.queue-size=size of waiting queue of HTTP reception~<Number>((0 - 2147483647))<<8192>>
Specifies the size for pending queue of HTTP reception.
urecp-http.pooled-instance.minimum=minimum number of the instances within the pool of HTTP reception~<Number>((0 or 1 - 2147483647))<<0>>
Specify the minimum number of instances in the pool of HTTP reception, in integers. If you specify 0 for this property, the minimum number of instances in the pool of HTTP reception is not restricted.
Specify a value which is smaller than the value specified in the property urecp-http.pooled-instance.maximum (maximum number of instances in the pool of HTTP reception). If the specified value is larger than the value specified in the property urecp-http.pooled-instance.maximum, there will be an error during execution of operating command.
urecp-http.pooled-instance.maximum=maximum number of instances within the pool of HTTP reception<number>((0 or 1-2147483647))<<0>>
Specify the maximum number of instances in the pool of HTTP reception, in integer. If you specify 0, the maximum number of instances is not restricted.
Specify a value that is greater than the value of the property urecp-http.pooled-instance.minimum (minimum number of instances in the pool of HTTP reception). If the specified value is smaller than the value specified in the property urecp-http.pooled-instance.minimum, an error occurs during the execution of operating command.
urecp-http.ejb-transaction-timeout=EJB transaction timeout time of HTTP reception~<number>((0 or 1-2147483647))<<0>>
Specify the EJB transaction timeout time of HTTP reception, in seconds. If you specify 0, operation is performed with the default timeout value specified in J2EE server.
(2) Properties related to reception settings
httprecp.switchover.pass-through.mode={true|false} ~<<false>>
Specify the mode that generates body variable at the time of passing message body to business process. This property is not case-sensitive.
httprecp.switchover.file-transfer.mode={true|false} ~<<false>>
Specify if work folder is to be created during request reception by HTTP reception. This property is not case-sensitive.
This property is valid for requests other than multi-part type requests. For multi-part type data, work folder is always created.
httprecp.http.charset={Shift_JIS|UTF-8} ~<<UTF-8>>
Specify the character code to be used for encoding message body and query. This property is not case-sensitive.
httprecp.response.ignore-bodymsg={true|false} ~<<false>>
Specify if the response message (body) received from business process is to be ignored by HTTP reception (Do not set the response message in HTTP response). This property is not case-sensitive.
httprecp.response.header.filename=HTTP response header definition file name
Specify the name of HTTP response header definition file. This property is case-sensitive.
httprecp.system-exception.status-code=status code in case of system exception~<Number>((000-999))<<500>>
Specify the status code during system exception with a 3 digit number..
httprecp.response.generate.content-length={true|false} ~<<true>>
Specify whether to generate the contents length in HTTP reception. This property is not case-sensitive.
httprecp.file-trans.temp-file.partsize-threshold=threshold size to output the temporary file~<Number>((0 or 1 - 2147483647))<<0>>
Specify the size serving as the threshold size during the output of HTTP request in temporary file, in case of a multi-part type HTTP request, in bytes unit.
If the size of HTTP request received by HTTP reception exceeds the value of this property, the received HTTP request is output in a temporary file. Temporary file is always generated when you have specified 0 in this property.
httprecp.file-trans.maxsize.part=size limit of 1 file of the file data that can be received~<number>((0 or 1-2147483647))<<2147483647>>
Specify the size limit for 1file in file data that can be received through HTTP reception, in bytes unit.
If the size of a part which is to be handled in file format, from among all the parts of multi-part HTTP request received by HTTP reception, exceeds the value specified for this property, a system exception occurs.
httprecp.file-trans.maxsize.request=size limit of HTTP request body that can be received~<number>((0 or 1-2147483647))<<2147483647>>
Specify the size limit for HTTP request body that can be received through HTTP reception, in bytes unit.
If the size of HTTP request body received by HTTP reception exceeds this value, a system exception occurs.
httprecp.work-dir.auto-delete={true|false} ~<<true>>
Specifies if work folder is to be deleted automatically after process completion. This property is not case-sensitive.
If you specify a value other than false or do not specify a key or a value, value is considered as true is considered. Specify false in this property, when business process is asynchronous type.
httprecp.response.download.disposition-type=value to be specified in the Content-Disposition header of HTTP response header~<<attachment>>
Specify a value which is to be set for Content-Disposition header of HTTP response header when sending data from HTTP reception to HTTP client. This property is not case-sensitive. Note that the validity of specified value is not verified.
The header value set in this property is used only when 1 file is to be downloaded by HTTP client.
httprecp.pass-through.parameter-use={true|false} ~<<true>>
Specify whether to use msg key for HTTP request body, in pass-through mode. This property is not case-sensitive.
This property is enabled only when you have specified true for the httprecp.switchover.pass-through.mode property.
Example described
An example of description is as follows:
urecp-http.max-threads=10 |