This topic applies only on the z/OS operating system.

Application server custom properties that are unique for the z/OS platform

There are some application server custom properties that only apply to the z/OS platform. Use this page to configure these custom properties.

To specify a value for one of these custom properties for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for one of these custom properties for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

To set one of these custom properties for either an application server or a deployment manager, in the administrative console, click Environment > WebSphere Variables, select the appropriate server, node, or cell from the pull-down list of available servers, nodes and cells, and then click New.

allow_large_SAF_groups

[Fix Pack 39 or later]

Specifies that you want to allow the application server to do lookups on large SAF groups.

If you set this property to 1, the size of the buffer that is used to do lookups is tripled from 8192 bytes to 24576 bytes.

You can also set this property to a specific number off bytes up to and including 2147483647. If you specify an integer, other than 1, as the value for this property, the buffer size becomes that number of bytes. For example, if you specify allow_large_SAF_groups=21400000, the size of the buffer used to do lookups on SAF groups is 21400000 bytes.

If you do not specify a value for this property, or specify a value of 0, the buffer size is 8192 bytes.

Data Type Integer
Range 1 - 2147483647
Default 0

com.ibm.ws.sib.ra.inbound.impl.MessageLockExpiry

When a message arrives on the queue that a message-driven bean (MDB) is consuming from, the message is locked and passed to the MDB in the servant region. If the servant region is disabled, or if there is an error processing the message on the servant region, this property defines how long the messaging engine waits before unlocking the message so that it can be re-delivered.

Data Type Integer
Units milliseconds
Default 300000
Range A positive integer. The value 0 indicates that the message lock never expires and the messaging engine waits indefinitely for the servant region to process and unlock the message.

control_region_dreg_on_no_srs

Specifies whether the controller rejects requests for dispatch within a servant when it detects that there are no servants available to process requests.

When this property is set to 1, the controller detects that there are no servants available to process requests, the controller rejects requests for dispatch within the servants, de-registers the application server with Workload management (WLM), and stops the HTTP and message-driven bean (MDB) listeners. If this property is set to 0 (zero), then the function is disabled.

When a minimal number of servants become available again, the controller registers the application server with WLM again, starts the HTTP and MDB listeners, and allows requests to be dispatched to the servants.

Data Type Integer
Acceptable values 0 or 1
Default 0

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

com.ibm.ws.sib.ra.inbound.impl.MessageLockExpiry

When a message arrives on the queue that a message-driven bean (MDB) is consuming from, the message is locked and passed to the MDB in the servant region. If the servant region is disabled, or if there is an error processing the message on the servant region, this property defines how long the messaging engine waits before unlocking the message so that it can be re-delivered.

Data Type Integer
Units milliseconds
Default 300000
Range A positive integer. The value 0 indicates that the message lock never expires and the messaging engine waits indefinitely for the servant region to process and unlock the message.

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

control_region_confirm_recovery_on_no_srs

Specifies whether requests are dispatched to servants following the detection of a no-servants situation. This property is ignored if the control_region_dreg_on_no_srs custom property is set to 0.

When this property is set to 1, the controller does not dispatch requests to the servants until it receives a response to message BBOO0297A. This message is issued following a no-servant situation when the sever detects that the required minimal number of servants are available to process requests.

When this property is set to 0 (zero), the controller determines when to allow requests to be dispatched to the servants after a no-servant condition is detected.

Data Type Integer
Acceptable values 0 or 1
Default 0

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

control_region_mdb_request_timeout

Specifies the time, in seconds, that the server waits for a message-driven bean (MDB) request to receive a response. If the response is not received within the specified amount of time, the server removes the MDB request.

This property only applies for application servers.

Set this value to 0 (zero) to disable the function.

Data Type Integer
Units Seconds
Default 120

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

control_region_timeout_delay

Specifies the number of seconds a controller waits after detecting a timeout before it terminates the servant. This time delay gives work that is currently running in the servant a chance to complete before the servant is terminated.

The specified length of time period starts when a timeout occurs. When a servant thread completes its current work item and determines that the servant is being terminated, the servant thread waits for the specified length of time instead of selecting a new work item.

When this field is set to 0 the controller terminates a servant as soon as the controller detects a timeout.

Data Type Integer
Units Seconds
Default 0
This property is affected by the setting for the server_use_wlm_to_queue_work property:

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

control_region_timeout_save_last_servant

Specifies whether the controller terminates the last available servant when a timeout situation occurs. If the controller does not terminate the last available servant when a timeout situation occurs, other work continues to be processed until a new servant is initialized. However, not terminating the last available servant might cause the loss of system resources if the dispatched servant thread that encountered the timeout situation continues to loop or stops functioning. For example, if timeouts keep occurring, the system might consume a high percentage of the available servant threads.

The functionality of this property depends on the values that you specify for other custom properties:
Data Type Boolean
Default 0

protocol_bboc_log_response_failure

Specifies that if the BBOO0168W message is issued, then the failure detected when attempting to send a response to a client is recorded. The message is sent to the error log. The message text contains the request method name, the reply status, and routing information identifying the client.

Data Type Boolean
Default false
Used by Daemon yes

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

protocol_bboc_log_return_exception

Used to indicate that if the BBOO0169W message is issued, then the response that contains the SystemException is recorded. The message is sent to the error log. The message text contains the exception identifier and minor code, the request method name, and routing information identifying the client.

Data Type Boolean
Default false
Used by Daemon yes

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

protocol_giop_level_highest

Specifies the CORBA General Inter-ORB Protocol (GIOP) protocol version level that is used by the application server object request broker (ORB). Valid values are 1.1 and 1.2. Interoperable object references (IORs) exported from this server use the GIOP level indicated.

You might need to change this property from the default if you use a non-WebSphere Application Server client ORB that supports a lower version of the CORBA standard. For example, you might need to change from the default protocol version level of 1.2 to 1.1 to support an older version, non-WebSphere Application Server client ORB.

Avoid trouble: The maximum GIOP level that the daemon address space supports is 1.1. The GIOP level has of the daemon has no effect on the GIOP levels of the application servers that connect to the daemon.gotcha
Data Type String
Default 1.2
Used by Daemon Yes

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

protocol_http_backlog

Specifies the maximum length for the queue of pending connections using HTTP. The value used can be limited by the specification of the SOMAXCONN statement in the TCP/IP profile.

Data Type Integer
Default 10
Used by Daemon No

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

protocol_http_defaultIdentity

Specifies the user identity associated with unauthenticated HTTP requests. This property is pre-configured at the cell level.

The initial setting for this property is configured through the ISPF Customization Dialog. You should only change this initial setting if unauthenticated users are permitted through the Global Security settings.

To change the value specified for this property, in the administrative console click Environment > WebSphere Variables > New and specifyprotocol_http_defaultIdentity in the Name field and the appropriate user identity in the Value field.

Data type String
Default WSADMIN

protocol_http_defaultIdentity

Specifies the user identity associated with unauthenticated HTTP requests. This property is pre-configured at the cell level.

The initial setting for this property is configured through the ISPF Customization Dialog. You should only change this initial setting if unauthenticated users are permitted through the Global Security settings.

To change the value specified for this property, in the administrative console click Environment > WebSphere Variables > New and specifyprotocol_http_defaultIdentity in the Name field and the appropriate user identity in the Value field.

Data type String
Default WSADMIN

protocol_https_cert_mapping_file

Specifies the name of a file containing entries that map IP addresses to server certificate labels. You can set this property at the cell, node, or server level.

When an HTTP SSL connection request is received, the application server checks the IP address against entries in the file specified for this property. If the application server finds a match, the certificate mapped to the IP address is used for the connection. If the application server does not find a match, it checks the protocol_https_default_cert_label property for the name of a certificate. If a certificate name is specified, the application server uses that certificate to establish the connection. If a certificate name is not specified, the default server certificate specified in the RACF SSL keyring, that is owned by the application server, is used to establish the HTTP SSL connection.

To set this property at the cell level, in the administrative console click Environment > WebSphere Variables > New and specify protocol_https_cert_mapping_file in the Name field and the appropriate file name in the Value field.

To set this property at the node level, in the administrative console click System administration > Nodes > node_name > Custom properties > New and specify protocol_https_cert_mapping_file in the Name field and the appropriate file name in the Value field.

To set this property at the server level, in the administrative console click Servers > Application servers > server_name > Web container settings > Web container > Custom properties > New and specify protocol_https_cert_mapping_file in the Name field and the appropriate file name in the Value field.

Following is the syntax for entries in a certificate mapping file:

SSLServerCert label ipaddress 

where:

label
Is the label of the server certificate in single or double quotes. If the label itself contains a single quote, double quotes are required as the delimiter.
ipaddress
Is the IP address of the server from which the request was received.

Examples:

SSLServerCert 'My Certificate Label' 9.57.4.29

SSLServerCert "My Co.'s Certificate" 9.57.4.30 

protocol_https_default_cert_label

Specifies the label of the server certificate that the application server uses when establishing HTTP SSL connections with the application server. You can set this property at the cell, node, or server level.

If the name of a certificate is note specified for this property, the default server certificate specified in the RACF SSL keyring, that is owned by the application server, is used to establish the HTTP SSL connection.

To set this property at the cell level, in the administrative console click Environment > WebSphere Variables > New and specify protocol_https_default_cert_label in the Name field and the appropriate certificate label in the Value field.

To set this property at the node level, in the administrative console click System administration > Nodes > node_name > Custom properties > New and specify protocol_https_default_cert_label in the Name field and the appropriate certificate label in the Value field.

To set this property at the server level, in the administrative console click Servers > Application servers > server_name > Web container settings > Web container > Custom properties > New and specify protocol_https_default_cert_label in the Name field and the appropriate certificate label in the Value field.

protocol_http_large_data_inbound_buffer

Specifies, in bytes, the limit of the size of incoming HTTP requests. For example, if you set the property to 15728640, any requests over 15 megabytes are rejected. Specify 0 (zero) if you want to reject any requests that are larger than 10

Data Type Integer
Default 0
Used by Daemon No

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

protocol_http_large_data_response_buffer

Specifies, in bytes, the maximum length of the response buffer used for HTTP requests. Responses larger than this value are rejected. Specify a value of 0 if you do not need a large response buffer because all of your HTTP responses are less than 10 MB.

Data Type Integer
Default 104857600
Used by Daemon No
Avoid trouble: This property only applies for application servers. It does not apply for a deployment manager.gotcha

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

protocol_http_timeout_output_recovery

Specifies the action for the timer expiration. Set the value to SESSION to send the client a message stating that the server timed out and let the server continue running.

Data Type String
Default SERVANT
Used by Daemon No

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

protocol_https_backlog

Specifies the maximum length for the queue of pending connections using HTTPS. The value used can be limited by the specification of the SOMAXCONN statement in the TCP/IP Profile.

Data Type Integer
Default 10
Used by Daemon No

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

protocol_iiop_backlog

Specifies the maximum length for the queue of pending connections using the CORBA Internet Inter-ORB protocol (IIOP). The value used might be limited by the specification of the SOMAXCONN statement in the TCP/IP profile.

Data Type Integer
Default 10
Used by Daemon Yes

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

protocol_iiop_backlog_ssl

Specifies specify the maximum length for the queue of pending connections using IIOP Secure Sockets Layer (SSL). The value used can be limited by the specification of the SOMAXCONN statement in the TCP/IP Profile.

Data Type Integer
Default 10
Used by Daemon Yes

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

protocol_iiop_local_propagate_wlm_enclave

Specifies whether to propagate the workload management (WLM) enclave that is associated with the currently dispatched request on an outbound IIOP request that was made to another server on the same z/OS system over local inter-address space communication protocols.

Data Type Boolean
Default 1
Used by Daemon No

protocol_iiop_resolve_foreign_hostname

Specifies whether to perform Domain Name Server (DNS) resolution of the IP address of a foreign client to a DNS registered host name for each established IIOP session. If this property is set to 1, then the DNS host name resolution is performed. If this property is set to 0, then the DNS host name resolution is not performed, and a textual representation of the IP address of the foreign client is used instead of the DNS host name.

Data Type boolean
Default 1
Used by Daemon Yes

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

protocol_iiop_send_timeout

Specifies the maximum amount of time, in seconds that the controller waits for an IIOP TCP/IP send() to complete. The value specified for this custom property applies to all IIOP send requests over TCP/IP, including IIOP send requests that are using the SSL protocol.

IIOP sends are serialized outside of TCP/IP for SSL or within TCP/IP for non-SSL IIOP. If a large number of general worker threads are tied up waiting for sends to complete, the controller is unable to handle new work. Setting a time limit for the completion of IIOP sends enables the controller to end a send request that do not complete within the specified length of time, and assign other work to the worker thread that was handling that request.

Data Type Integer
Default 30
Used by Daemon Yes

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

ras_debugEnabled

Specifies to use an external debugger tool with the application server for tracing and debugging client and server application components such as JavaServer Pages (JSP) files, servlets, and enterprise beans.

Data Type Boolean
Default false
Used by Daemon Yes

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

ras_default_msg_dd

Specifies whether to redirect write-to-operator (WTO) messages that use the default routing to hard copy. These messages are redirected to the location identified through the DD card on the job control language (JCL) start procedure for the server. These write to operator (WTO) messages are usually issued during initialization.

Data Type String
Default empty string
Used by Daemon Yes

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

ras_dumpoptions_dumptype

Specifies dump options use with a CEE3DMP dump. If you want more than one option, then separate each option with a blank space. Do not change this property unless directed by IBM service personnel.

0 No dump is generated.
1 A ctrace dump is taken.
2 A cdump dump is taken.
3 A csnap dump is taken.
4 A CEE3DMP dump is taken.
Data Type Integer
Default 3
Used by Daemon Yes

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

ras_dumpoptions_ledumpoptions

Specifies the dump options to use with a CEE3DMP dump. If you want more than one option, separate each option with a blank space. Do not change this property unless directed by IBM service personnel.

Data Type String
Default THREAD(ALL) BLOCKS
Used by Daemon Yes

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

ras_hardcopy_msg_dd

Specifies to redirect write to operator (WTO) messages that are routed to hard copy. These messages are redirected to the location that is identified through the DD card on the server JCL start procedure. These WTO messages are primarily audit messages issued from Java code during initialization.

Data Type String
Default empty string
Used by Daemon Yes

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

ras_log_logstreamName

Specifies the log stream that the product uses for error information. If the specified log stream is not found or not accessible, a message is issued and errors are written to the server job log. If this variable is not specified, WebSphere Application Server for z/OS uses the STDERR stream.

Data Type String
Default empty string
Used by Daemon Yes

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

ras_minorcode_action

Specifies the default behavior for gathering documentation about system exception minor codes.

Data Type String
Default NODIAGNOSTICDATA
Used by Daemon Yes
You can also specify:

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

ras_stderr_ff_interval

Specifies the interval of time, in minutes, that the system waits before writing the next form-feed character to standard error (SYSOUT).

Avoid trouble: [sep2010] If you are using JES2, this environment setting can be combined with the SEGMENT= parameter on the SYSPRINT DD statement if you want to segment the output. The value of the SEGMENT= parameter is the number of form-feeds required before the first segment is closed and a new segment is allocated. Due to special circumstances concerning the SYSOUT DD statement, additional JCL updates are required to exploit the SEGMENT option for SYSOUT. The SEBMENT= parameter is not supported on JES3.
The recommended method to enable segmenting of the SYSOUT DD statement is to define a new DD statement named SYSERR. Define the SYSERR DD statement exactly as you would define the SYSOUT DD statement. Apply the SEGMENT= option to the new SYSERR DD statement. Finally, add this SYSERR DD statementto the PARM= setting, as the following example illustrates:
PARM='2>DD:SYSERR'
Another method that enables segmenting of the SYSOUT DD statement is to define a new DD statement named CEEMSG. The CEEMSG DD statement is defined exactly as the SYSOUT DD statement would be. Apply the SEGMENT= option to the SYSOUT DD statement. Finally, add this CEEMSG DD statement to the PARM= setting, as the following example illustrates:
PARM='MSGFILE(CEEMSG)/2>DD:SYSOUT'
[sep2010]
sep2010
gotcha
Data Type Integer
Default 0
Used by Daemon Yes

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

ras_stdout_ff_interval

Specifies the interval of time, in minutes, between the writing of a form-feed character to standard output, or SYSPRINT.

Avoid trouble: [sep2010] If you are using JES2, this environment setting can be combined with the SEGMENT= parameter on the SYSPRINT DD statement if you want to segment the output. The value of the SEGMENT= parameter is the number of form-feeds required before the first segment is closed and a new segment is allocated. The SEBMENT= parameter is not supported on JES3. [sep2010]
sep2010
gotcha
Data Type Integer
Default 0
Used by Daemon Yes

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

ras_time_local

Specifies whether time stamps in the error log display is in local time or Greenwich Mean Time (GMT). The time stamp is in GMT if this property is set to false.

Data Type Boolean
Default false
Used by Daemon Yes

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

ras_trace_basic

Specifies tracing overrides for particular product subcomponents. Subcomponents, specified by numbers, receive basic and exception traces. If you specify more than one subcomponent, use parentheses and separate the numbers with commas.Do not change this property unless directed by IBM service personnel.

Data Type String
Default null (empty string)
Used by Daemon Yes

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

ras_trace_BufferCount

Specifies the number of trace buffers to allocate.

Data Type Integer
Valid values 4 through 8
Default 4
Used by Daemon Yes

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

ras_trace_BufferSize

Specifies the size of a single trace buffer in bytes. You can use the letters K, for kilobytes, or M, for megabytes.

Data Type String
Valid values 128K through 4M
Default 1M
Used by Daemon Yes

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

ras_trace_ctraceParms

Specifies the identify of the CTRACE PARMLIB member. The value can be either a two-character suffix, which is added to the CTIBBO string to form the name of the PARMLIB member, or the fully specified name of the PARMLIB member. For example, you can use the 01 suffix, which the system resolves to CTIBBO01. A fully specified name must conform to the naming requirements for a CTRACE PARMLIB member. For details, see z/OS MVS Diagnosis: Tools and Service Aids, GA22-7589.

If this property is specified and the PARMLIB member is not found, then the default PARMLIB member, CTIBBO00, is used. If neither the specified nor the default PARMLIB member is found, then tracing is defined to CTRACE, but no connection is available to a CTRACE external writer.

Data Type String
Default null (empty string)
Used by Daemon Yes

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

ras_trace_defaultTracingLevel

Specifies the default tracing level for the product. Use this variable with the ras_trace_basic and ras_trace_detail variables to set tracing levels for product subcomponents. Do not change this property unless directed by IBM Support personnel.

0 No tracing
1 Exception tracing
2 Basic and exception tracing
3 Detailed tracing, including basic and exception tracing
Data Type Integer
Default 1
Used by Daemon Yes

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

ras_trace_detail

Specifies tracing overrides for particular product subcomponents. Subcomponents, specified by numbers, receive detailed traces. If you specify more than one subcomponent, use parentheses and separate the numbers with commas. Do not change this property unless directed by IBM Support personnel.

Data Type String
Default null (empty string)
Used by Daemon Yes

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

ras_trace_exclude_specific

Specifies product trace points to exclude from tracing activity.

Trace points are specified by 8-digit, hexadecimal numbers. Do not use this property unless directed by IBM service personnel. If IBM service personnel directs you to specify more than one trace point, use parentheses and separate the numbers with commas. You also can specify a variable name by enclosing the name in single quotes.

Data Type String
Default null (empty string)
Used by Daemon Yes
Avoid trouble: Sometimes results depend on the ras_trace_minorCodeDefault environment variable. If you code ras_trace_minorCodeTraceBacks=ALL and ras_minorcode_action=NODIAGNOSTICDATA, you get a traceback. But, if you code ras_trace_minorCodeTraceBacks=(null value) and ras_minorcode_action=TRACEBACK, you also get a traceback. So, specifying ras_trace_minorCodeTraceBacks=(null value) causes TRACEBACK data to be collected. instead of cancelling the traceback.gotcha

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

ras_trace_outputLocation

Specifies where to send trace records. You can send trace records to the following locations:

For servers, you can specify one or more values, separated by a space.

Data Type String
Default SYSPRINT BUFFER
Used by Daemon Yes

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

ras_trace_specific

Specifies tracing overrides for specific product trace points. Trace points are indicated by 8-digit, hexadecimal numbers. To specify more than one trace point, use parentheses and separate the numbers with commas. You can also specify tracing on a specific environment variable by using the name enclosed in single quotes. Do not use this property unless directed by IBMSupport personnel.

Data Type String
Default null (empty string)
Used by Daemon Yes

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

security_SMF_record_first_auth_user

Specifies whether to record the first authenticated user under request dispatch in the SM120CRE field in the System Management Facility (SMF) server activity record.

If this property is set to 1, then the first authenticated user under request dispatch is written to the SM120CRE field. If this property is set to 0, then the ID of the user under which the server activity began is written to the SM120CRE field.

Data Type Boolean
Default 0
Used by Daemon No

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

server_region_connect_to_wlm_early

Specifies whether the servant should connect to Workload Manager (WLM) at the beginning or the end of servant initialization.

Data Type Boolean
Default 0
Used by Daemon No

Setting this property to 1 enables the servant to connect to WLM at the beginning of servant initialization. After the servant connects to WLM, WLM is able to classify asynchronous work that is started during the remainder of the servant initialization process. A consequence of enabling the servant to connect to WLM at the beginning of servant initialization is that when there are multiple servants defined, the servants will all start almost concurrently. Concurrent initialization of multiple servants might cause high CPU usage that needs to be taken into consideration.

Setting this property to 0 prevents any asynchronous work that is started during servant initialization from being classified by WLM because the servant does not connect to WLM until the end of the servant initialization process.

server_region_jvm_localrefs

Do not use this property unless directed by IBM Support personnel.

Data Type Integer
Default 128
Used by Daemon No

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

server_region_jvm_logfile

Specifies the Hierarchical File System (HFS) file in which Java Native Interface (JNI) and class debug messages from the Java Virtual Machine (JVM) are logged. Use this variable only in a single-server environment. If you use this property in a multiple-server environment, then all of the servers write to the same file, and you might have difficulty using the file for diagnostic purposes.

Data Type String (file name)
Default empty string (no file name)
Used by Daemon No

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

server_region_recycle_count

Specifies the number of transactions processed by a servant process after which the servant process is recycled. Workload management (WLM) ends the servant after all affinity requirements have been met. Specify a nonzero value to enable recycling.

You might want to enable recycling if, after running for an extended period of time, your application is experiencing out-of-memory exceptions. Out-of-memory exceptions can result from memory leakage by your application.

Data Type Integer
Default 0
Used by Daemon No

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

server_start_wait_for_initialization_Timeout

Specifies how long the startServer.sh command processing waits for WebSphere Application Server initialization to complete. By default, startServer.sh command processing waits indefinitely until initialization is complete.

Use this property if you want to:
Data Type Integer
Default 0
Used by Daemon No

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

server_use_wlm_to_queue_work

Specifies whether WLM for z/OS is used for workload queuing.

Set this property to 1 if you are using stateless application models. With these models, application objects, such as Enterprise JavaBeans (EJBs) and HTTP sessions, are only resident in memory for the life of an individual request. In this situation, you want WLM to dynamically balance individual requests. This configuration allows linear scalability and consistent, repeatable response times.

Set this property to 0 (zero) if you are using conversational application models. With these models, a client might hold, and periodically interact with, a reference to a stateful object which is pinned in the memory of one of the JVMs for a period of time that is greater than the duration of an individual request. For example, the client might be using HTTP sessions, stateful session beans or entity beans that are maintained in memory instead of being stored in a database or file system between requests, as is done in stateless application models.

Conversational application models prevent WLM from dynamically routing individual requests in a clustered environment because the client has affinity to a specific JVM. In this situation, a round robin algorithm is used to handle the initial request from the client . This algorithm evenly distributes creation of long term affinities and is the best technique for achieving a balanced utilization of system resources under these conditions.

If you set this property to 0 for conversational application models, you must also set the server_work_distribution_algorithm property to 1.

If you want to exploit the round robin capability that WLM provides, instead of the previously described product round robin capability, seeWorkload management (WLM) for z/OS . The differences between the round robin capability that WLM provides and the product round robin capability is explained in the following scenario.

Scenario: A customer starts two clients to talk to a server. The server has two servants, and each servant has multiple threads. The customer expects one client to go to one servant, and the second client to go to the other servant. The product provided round robin, initiated by specifying server_use_wlm_to_queue_work=0 and server_work_distribution_algorithm=1, acts this way. However, the WLM provided round robin goes through all of the threads in the first servant before moving to the threads in the next servant.

When the server_use_wlm_to_queue_work property is set to 0 (zero), the wlm_minimumSRCount and wlm_maximumSRCount properties are set to the same value. Because the work is not going through WLM, WLM only starts the number of servants that are specified for the wlm_minimumSRCount property.

0 (zero) WLM for z/OS is not used.
1 WLM for z/OS is used.
Default 1
Used by Daemon No

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

server_work_distribution_algorithm

Specifies the type of work distribution algorithm that the application server uses for workload balancing. This property is only used if the server_use_wlm_to_queue_work property is set to 0. If the server_use_wlm_to_queue_work property is set to 1, then the value specified for this property is ignored.

0 (zero) The hot thread algorithm is used. This option is not recommended.
1 The round robin algorithm is used. This value must be specified if the server_use_wlm_to_queue_work custom property is set to 0 for conversational application models.
Default 0
Used by Daemon No

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

transaction_recoveryTimeout

Specifies the time, in minutes, that this controller uses to attempt to complete all restarted transactions before issuing a write-to-operator-with-reply (WTOR) message to the console, requesting whether to:

If the operator replies to continue the recovery process, then the controller attempts recovery for the specified amount of time before reissuing the write-to-operator message. After all the transactions are resolved, the controller terminates. This variable applies only to controllers that are running in peer restart and recovery mode.

Data Type Integer
Default 15
Used by Daemon No

To specify a value for this custom property for an application server, in the administrative console, click Application servers > server_name > Server infrastructure > Administration > Custom Properties.

To specify a value for this custom property for a deployment manager, in the administrative console, click System administration > Deployment manager, and then under Server Infrastructure, click > Administration > Custom Properties.

wlm_classification_file

You can use the wlm_classification_file property to specify the location of your workload classification document. You can set this property at the cell, node, or server level.

The workload classification document is a common XML file that classifies inbound HTTP, IIOP, and message-driven bean (MDB) work. Any rules that are defined in this XML file override the old format HTTP classification. The rules in the common XML file also override any rules that are in the MDB classification file defined by the endpoint_config_file property.

Example

For example, your configuration has the common XML file defined in a server that also has the old format HTTP classification document specified. There are no HTTP classification rules defined in your common XML file, so the old format file is used to classify inbound HTTP requests. However, if your common XML file contains HTTP rules, these classification rules are used instead of classification rules that you defined in the old style HTTP classification document.

To set this property at the cell level, in the administrative console click Environment > WebSphere Variables > New and specify wlm_classification_file in the Name field and the location of your workload classification document in the Value field.

To set this property at the node level, in the administrative console click System administration > Nodes > node_name > Custom properties > New and specify wlm_classification_file in the Name field and the location of your workload classification document in the Value field.

To set this property at the server level, in the administrative console click Servers > Application servers > server_name > Web container settings > Web container > Custom properties > New and specify wlm_classification_file in the Name field and the location of your workload classification document in the Value field.

wlm_stateful_session_placement_on

Specifies whether round robin queuing of HTTP sessions is enabled among servants. You can set this property at the cell, node, or server level.

Set this property to true if you want round robin queuing of HTTP sessions enabled among servants. Set this property to false if you do not want round robin queuing of HTTP sessions enabled among servants.

See the use of the custom property, WLMStatefulSession, for more information on the effect of using wlm_stateful_session_placement_on.

Data Type Boolean
Default true
Used by Daemon No

To set this property at the cell level, in the administrative console click Environment > WebSphere Variables > New and specify wlm_stateful_session_placement_on in the Name field and 1 in the Value field.

To set this property at the node level, in the administrative console click System administration > Nodes > node_name > Custom properties > New and specify wlm_stateful_session_placement_on in the Name field and 1 in the Value field.

To set this property at the server level, in the administrative console click Servers > Application servers > server_name > Web container settings > Web container > Custom properties > New and specify wlm_stateful_session_placement_on in the Name field and 1 in the Value field.




Subtopics
Certificate mapping file entries
Related concepts
Workload management (WLM) for z/OS
Related tasks
Using the WebSphere Application Server administrative console to enable properties for specific SMF record types
Classifying z/OS workload
Configuring an application server to use the WLM even distribution of HTTP requests function
Defining WebSphere variables
Related reference
Repository service custom properties
HTTP transport custom properties
Reference topic    

Terms of Use | Feedback

Last updated: Sep 20, 2010 10:03:57 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=vela&product=was-nd-zos&topic=urun_rproperty_custproperties
File name: urun_rproperty_custproperties.html