Modify command

Parameters

The following parameters are valid for the modify command:

DISABLEFAILOVER,'<JNDI Name>'

Used to manually disable resource failover support for the resource identified by the supplied JNDI name. The supplied JNDI name identifies the primary resource, and it must be surrounded by single quotes to preserve its case.

ENABLEFAILOVER,'<JNDI Name>'

Used to manually enable resource failover support for the resource identified by the supplied JNDI name. The supplied JNDI name identifies the primary resource, and it must be surrounded by single quotes to preserve its case.

FAILOVER,'<JNDI Name>'

Used to manually route requests that are destined for the primary resource to its configured alternate resource. The supplied JNDI name identifies the primary resource, and it must be surrounded by single quotes to preserve its case. To failback requests to the primary resource, issue the modify command with the parameter, FAILBACK,'<JNDI name>'.

FAILBACK,'<JNDI Name>'

Used to manually route requests to the configured primary resource that is identified by the supplied JNDI name. The supplied JNDI name identifies the primary resource, and it must be surrounded by single quotes to preserve its case. This command automatically enables automatic failover. If automatic failover is not wanted after failback, issue the modify command with the parameter, DISABLEFAILOVER,'<JNDI Name>'.

Attention: The JNDI name input is case sensitive.

CANCEL

Used to cancel the specified server.

You can specify the following options for the CANCEL parameter:

ARMRESTART

Specifies whether you are using the application response management (ARM) agent and want ARM to restart the server after it terminates. If you do not specify the ARMRESTART option on the CANCEL parameter, ARM does not restart the server.

HELP

Specifies that you want to see the help information that describes the CANCEL syntax.

Avoid trouble: You cannot use the CANCEL parameter to cancel a cluster from the MVS console. You must individually cancel each of the servers that make up the cluster.

DPM,[IIOP=nnn | HTTP=nnn | HTTPS=nnn | MDB=nnn | SIP=nnn | CRA=nnn | SIPS=nnn | OLA=nnn | INTERVAL=nnn | dump_action={SVCDUMP|JAVACORE|HEAPDUMP|TRACEBACK|JAVATDUMP|NONE|RESET} | clear_all | reset_all]

The nnn placeholder specifies, in seconds, the length of the time interval for a specific protocol type. The value for the nnn placeholder must be an integer 0 - 255, or reset. A value of 0 illustrates that the protocol has no interval and that DPM is disabled for requests that use that protocol. A value of reset illustrates that the control of the DPM interval is returned to the dpm_interval classification attribute in the workload classification file.

The DPM INTERVAL modify command overrides the dpm_interval classification attribute. The DPM dump_action modify command overrides the dpm_dump_action classification attribute and the server_region_dpm_dump_action server-wide property.

Specifying RESET on the dump action deactivates the dump action for the modify command. The settings for the dpm_dump_action classification attribute and the server_region_dpm_dump_action server-wide property are again in effect.

A value specified on the INTERVAL parameter sets the DPM interval for all six protocols to the same value.

The clear_all value sets the time intervals for all related request protocols to 0 and the dump action to None.

The reset_all value resets all the DPM intervals and the dump_action parameter. Control of the DPM intervals and the dump action is returned to the WLM classification file.

HEAPDUMP

Used to generate a JVM heap dump for the controller, and for all the servants that are associated with that controller.

JAVACORE

Used to generate a JVM core dump for the controller, and for all the servants that are associated with that controller.

JAVATDUMP

Used to generate a JVM-initiated TDUMP for all the servant address spaces. You can also use the JAVA_DUMP_TDUMP_PATTERN native environment variable to specify the TDUMP data set name.

JAVAOOM,[INTERVAL=nnn | ACTION=xxx | RESET]

Used to dynamically alter the diagnostic action that is taken if a Java Virtual Machine (JVM) out-of-memory condition occurs in this server. It is also used to dynamically alter the time interval within which the diagnostic action is repeated.

Specifying INTERVAL sets the amount of time, in seconds, during which a diagnostic action is not repeated. This attribute overrides the value specified for the ras_java_oom_interval environment variable.

Specifying ACTION sets the diagnostic action that is taken when a JVM out-of-memory condition occurs in this server. This attribute overrides the value specified for the ras_java_oom_action environment variable. One of the following values can be specified as the value for xxx:

NONE

No diagnostic action is performed.

WTO

A BBOO0404E error message is written to hardcopy.

SVCDUMP

An SVCDUMP of the affected address space is taken, with minor code C9C2704B.

Specifying RESET Resets the diagnostic action and interval to the values specified for the ras_java_oom_action and ras_java_oom_interval environment variables.

MSGROUTE,{ERRORLOG|HARDCOPY|CONSOLE|COPYERRORLOG|COPYHARDCOPY|COPYCONSOLE|NONE}{[=xxx][,RESET][,CLEAR]}

Used to dynamically alter the output location of message IDs.

The xxx placeholder is a comma delimited list of product message IDs for the application server to route. Messages can be routed to more than one location.

The first time that you issue the command for a location and a set of messages, the message list for the location is the message list of the first command. If the environment variable for the location has messages defined, those messages are appended to the message list of the location. When you later issue the command for the same location and another set of messages, the application server appends the messages of the subsequent command to the existing list of messages.

Specifying ERRORLOG routes the messages to the error log instead of the default location.

Specifying HARDCOPY routes the messages to the SYSLOG system log, also known as hardcopy, instead of the default location.

Specifying CONSOLE routes the messages to the MVS operator console instead of the default location.

Specifying COPYERRORLOG copies the messages to the error log as well as the default location.

Specifying COPYHARDCOPY copies the messages to the SYSLOG system log, also known as hardcopy, as well as the default location

Specifying COPYCONSOLE copies the messages to the MVS operator console as well as the default location.

Specifying NONE suppresses the routing of the messages. A value of NONE takes precedence over routing of messages to the error log, the system log, or the MVS operator console.

Specifying RESET with ERRORLOG, HARDCOPY, CONSOLE, COPYERRORLOG,COPYHARDCOPY,COPYCONSOLE or NONE means that the messages that are routed or suppressed come form the was.env file instead of the MSGROUTE modify command.

• Specifying RESET with ERRORLOG routes messages specified on the ras_message_routing_errorlog environment variable to the error log instead of the default location.
• Specifying RESET with HARDCOPY routes the messages specified on the ras_message_routing_hardcopy environment variable to the SYSLOG system log instead of the default location.
• Specifying RESET with CONSOLE routes the messages specified on the ras_message_routing_console environment variable to the MVS operator console instead of the default location.
• Specifying RESET with COPYERRORLOG copies messages specified on the ras_message_routing_copy_errorlog environment variable to the error log as well as the default location.
• Specifying RESET with COPYHARDCOPY copies the messages specified on the ras_message_routing_copy_hardcopy environment variable to the SYSLOG system log as well as the default location.
• Specifying RESET with COPYCONSOLE copies the messages specified on the ras_message_routing_copy_console environment variable to the MVS operator console as well as the default location.
• Specifying RESET with NONE suppresses the routing of messages specified on the ras_message_routing_hardcopy environment variable.

Specifying CLEAR with ERRORLOG, HARDCOPY, CONSOLE, COPYERRORLOG,COPYHARDCOPY,COPYCONSOLE or NONE means that the messages are routed to a default location or are no longer suppressed.

• Specifying CLEAR with ERRORLOG, HARDCOPY, CONSOLE, COPYERRORLOG, COPYHARDCOPY, COPYCONSOLE or NONE means that the messages are routed to a default location or are no longer suppressed.
• Specifying CLEAR with ERRORLOG or COPYERRORLOG routes messages to the default location instead of the error log.
• Specifying CLEAR with HARDCOPY or COPYERRORLOG routes the messages to the default location instead of to the SYSLOG system log.
• Specifying CLEAR with CONSOLE or COPYCONSOLE routes the messages to the default location instead of to the MVS operator console.
• Specifying CLEAR with NONE cancels the suppression of messages.

RECLASSIFY[,FILE=['/path/to/file.xml']]

Used to dynamically reload the workload classification document without having to restart the server. The reloaded workload classification settings take effect immediately.

Specifying RECLASSIFY performs reclassification using the workload classification file specified on the wlm_classification_file variable.

Specifying a file name with the reclassify parameter such as RECLASSIFY,FILE='/path/to/newfile.xml' performs reclassification using the classification file specified. The value for the wlm_classification_file variable changes to the file specified on the FILE option. Any subsequent reclassify modify commands that use the wlm_classification_file variable reload the new file specified on the variable, not the original file.

Specifying RECLASSIFY,FILE= disables classification. The wlm_classification_file variable is set to null. Any subsequent reclassify modify commands that use the wlm_classification_file variable do not affect the server since the wlm_classification_file variable has no value.

Attention: If the new workload classification file cannot be loaded, then the application server discards the reloaded classification settings. The application server continues to run with the classification settings in effect before the reclassify modify command being issued.

Tip: Whenever the workload classification file loads successfully, the application server issues to the system log, SYSLOG, a message like the following message. The message is also displayed on the operator console in response to the DISPLAY,WORK,CLINFO display command.

BBOJ0129I: The /tmp/wlm4.class.xml workload classification file 
was loaded at 2009/07/14 19:33:35.297 (GMT)

ROLL_LOGS

Used to reissue a redirect of servant output logs to the USS file system. A new set of output log files will be created under the same output directory, and older log files will be preserved. Messages will be written to the end of previous logs and to the beginning of new logs, thereby creating a logical link between the files.

STACKTRACE

Used to log the Java stack traceback for all Java threads in the server to the error log.

SMF,REQUEST,{ON|OFF|RESET}

Used to control the creation of SMF 120-9 records.

The SMF,REQUEST modify command overrides the SMF_request_activity_enabled classification attribute and the server_SMF_request_activity_enabled server-wide property.

Specifying ON turns on the creation of SMF 120-9 records.

Specifying OFF turns off the creation of SMF 120-9 records.

Specifying RESET deactivates the modify command setting for the creation of SMF 120-9 records. The settings for the SMF_request_activity_enabled classification attribute and the server_SMF_request_activity_enabled server-wide property at the time of the reset are in effect.

SMF,REQUEST,ASYNC,{ON|OFF|RESET}

Used in the collection of data for the Formatted ASYNC Section of the SMF 120-9 record whenever that record is created.

The SMF,REQUEST,ASYNC modify command overrides the server_SMF_request_activity_async server-wide property.

Specifying ON turns on the collection of the data.

Specifying OFF turns off the collection of the data. When this value is specified, records that are created have zeros for this section in the location triplets at the beginning of the record.

Specifying RESET deactivates the modify command setting for the collection of the data. The settings for the the server_SMF_request_activity_async server-wide property at the time of the reset are in effect.

SMF,REQUEST,CPU,{ON|OFF|RESET}

Used in the collection of data for the CPU Usage Breakdown Section of the SMF 120-9 record whenever that record is created.

The SMF,REQUEST,CPU modify command overrides the SMF_request_activity_CPU_detail classification attribute and the server_SMF_request_activity_CPU_detail server-wide property.

Specifying ON turns on the collection of the data.

Specifying OFF turns off the collection of the data. When this value is specified, records that are created have zeros for this section in the location triplets at the beginning of the record.

Specifying RESET deactivates the modify command setting for the collection of the data. The settings for the SMF_request_activity_CPU_detail classification attribute and the server_SMF_request_activity_CPU_detail server-wide property at the time of the reset are in effect.

SMF,REQUEST,SECURITY,{ON|OFF|RESET}

Used in the collection of data for the Security Data Section of the SMF 120-9 record whenever that record is created.

The SMF,REQUEST,SECURITY modify command overrides the SMF_request_activity_security classification attribute and the server_SMF_request_activity_security server-wide property.

Specifying ON turns on the collection of the data.

Specifying OFF turns off the collection of the data. When this value is specified, records that are created have zeros for this section in the location triplets at the beginning of the record.

Specifying RESET deactivates the modify command setting for the collection of the data. The settings for the SMF_request_activity_security classification attribute and the server_SMF_request_activity_security server-wide property at the time of the reset are in effect.

SMF,REQUEST,TIMESTAMPS,{ON|OFF|RESET}

Used in the collection of data for the Formatted Timestamps Section of the SMF 120-9 record whenever that record is created.

The SMF,REQUEST,TIMESTAMPS modify command overrides the SMF_request_activity_timestamps classification attribute and the server_SMF_request_activity_timestamps server-wide property.

Specifying ON turns on the collection of the data.

Specifying OFF turns off the collection of the data. When this value is specified, records that are created have zeros for this section in the location triplets at the beginning of the record.

Specifying RESET deactivates the modify command setting for the collection of the data. The settings for the SMF_request_activity_timestamps classification attribute and the server_SMF_request_activity_timestamps server-wide property at the time of the reset are in effect.

SMF,OUTBOUND,ON

Used to turn on the creation of SMF 120-10 records.

SMF,OUTBOUND,OFF

Used to turn off the creation of SMF 120-10 records..

SMF,OUTBOUND,RESET

Used to have the creation of SMF 120-10 records controlled by the value specified on the server_SMF_outbound_enabled environment variable.

TIMEOUT_DELAY=n

Used to dynamically alter the timeout delay option variable, control_region_timeout_delay, to n seconds. This modify command is used with the TIMEOUTDUMPACTION modify command to set a timeout delay that enables the specified dump action, such as JAVACORE, to complete when a timeout occurs. The dump actions specified on the TIMEOUTDUMPACTION modify command require a timeout delay that enables the servant to complete the dump action before the servant terminates.

After the specified dump is processed, you can reissue this command to change the value of the control_region_timeout_delay variable back to its previous setting without recycling the server.

TIMEOUTDUMPACTION=n

Used to indicate which of the following actions is performed whenever a timeout occurs for work that has been dispatched to a servant when the control_region_timeout_delay property is set to a non-zero value:

• If NONE, or none is specified, no dump is taken.
• If JAVACORE or javacore is specified, a Java core dump is taken.
• If SVCDUMP or svcdump is specified, an SVC dump is taken.
• If JAVATDUMP or javatdump is specified, a JVM-initiated TDUMP is taken.
  Note: The control_region_timeout_delay property must be configured to a length of time that is long enough for the servant to collect the JAVATDUMP before the controller terminates the servant. The TIMEOUT_DELAY modify command can be used to dynamically change the value of the control_region_timeout_delay property.

TIMEOUTDUMPACTIONSESSION=n

Used to indicate which of the following actions is performed whenever a timeout occurs for an HTTP, HTTPS, SIP, or SIPS request that has been dispatched to a servant, and the corresponding recovery property is set to SESSION:

• If NONE, or none is specified, no dump is taken.
• If JAVACORE or javacore is specified, a Java core dump is taken.
• If SVCDUMP or svcdump is specified, an SVC dump is taken.
• If JAVATDUMP or javatdump is specified, a JVM-initiated TDUMP is taken

Following is a list of the corresponding recovery properties:

• protocol_http_timeout_output_recovery
• protocol_https_timeout_output_recovery
• protocol_sip_timeout_output_recovery
• protocol_sips_timeout_output_recovery

TRACEALL=n

Used to establish a general trace level for the server.

The following values are valid trace levels. Typically, you specify a value of 1.

• 0: no tracing is performed
• 1: tracing is performed when an exception occurs
• 2: basic tracing is performed
• 3: detailed tracing for all components is performed.

Avoid trouble: Be careful when using a level of 3 because this level of tracing might yield more data than is practical for you to review.

TRACEBASIC=n

Used to specify the product components for which you want to turn on a basic level of tracing.

This command can override a different tracing level established by TRACEALL for those components.

Avoid trouble: Do not change this variable unless directed to do so by IBM® Support.

The following table includes the values that you can specify for this parameter. You can specify one or more of these values for either TRACEBASIC or TRACEDETAIL:

Value	Product component
0	RAS
1	Common Utilities
3	COMM
4	ORB
6	OTS
7	Shasta
9	z/OS® Wrappers
A	Daemon
E	Security
F	Externalization
J (Should be used only under the direction of IBM Support)	JRas
L	Java EE

TRACEDETAIL=n

Used to specify the product components for which you want to turn on a detailed level of tracing.

This command activates the most detailed tracing for the specified product components and overrides different settings inTRACEALL. The selected components are identified by their component IDs, which are the same IDs as the ones listed for the TRACEBASIC parameter. Subcomponents, specified by numbers, receive detailed traces. Other parts of the product receive tracing as specified on the TRACEALL parameter.

Avoid trouble: Do not change this variable unless directed to do so by IBM Support.

TRACESPECIFIC=xxyyyzzz

Used to specify tracing overrides for specific product trace points.

Trace points are specified by eight-digit, hexadecimal numbers. To specify more than one trace point, use parentheses and separate the numbers with commas. You can also specify an environment variable name by enclosing the name in single quotation marks. The value of the environment variable is processed as if you had specified that value on the TRACESPECIFIC parameter.

Avoid trouble: Do not use TRACESPECIFIC unless directed by IBM Support.

TRACE_EXCLUDE_SPECIFIC=xxyyyzzz

Used to specify product trace points to exclude.

Trace points to exclude are specified by eight-digit, hexadecimal numbers. To specify more than one trace point, use parentheses and separate the numbers with commas. You can also specify an environment variable name by enclosing the name in single quotation marks. The value of the environment variable is processed as if you had specified that value on the TRACE_EXCLUDE_SPECIFIC parameter. You can use the TRACE_EXCLUDE_SPECIFIC parameter as a mask to turn off traces that are currently turned on. For example, use the TRACESPECIFIC parameter to turn on tracing for a whole part of the product, and then use the TRACE_EXCLUDE_SPECIFIC parameter to turn off one trace within that part of the product.

Avoid trouble: Do not use TRACE_EXCLUDE_SPECIFIC parameter unless you are directed to do so by IBM Support.

TRACEINIT

Used to reset to the initial trace settings.

TRACENONE

Used to turn off all trace settings.

TRACETOSYSPRINT={YES|NO}

Used to select whether to send the trace to SYSPRINT.

Specifying YES sends the trace to SYSPRINT, and specifying NO stops the sending of the trace to SYSPRINT.

TRACETOTRCFILE={YES|NO}

Used to specify whether to direct the trace to the TRCFILE DD card.

Specifying YES sends the trace to the TRCFILE DD card, and specifying NO stops the sending of the trace to the TRCFILE DD card.

TRACEJAVA

Modify the Java trace string.

The Java trace specification is used to control Java tracing and conforms to the Java trace specification rules. *=all=enabled means to enable all types of tracing for all registered trace components.

TRACERECORD,{ON|OFF|RESET}

Used to control the writing of trace records. The parameter is used with the classification_only_trace attribute defined in the workload classification file.

Specifying ON causes trace records to be written based on the current trace specification. Any classification_only_trace attributes are ignored.

Specifying OFF prevents trace records from being written.

CAUTION:

Trace records based on the current trace specification or produced as part of normal runtime processing are not written.

Specifying RESET causes trace records to be written for the current trace specification as follows:

• If no classification_only_trace attributes are defined, then trace records are written for all processing threads. This situation is functionally equivalent to setting TRACERECORD to ON.
• If one or more classification_only_trace attributes are defined, then trace records are only written for processing threads whose classification contains a classification_only_trace attribute of 1.

The default value is RESET.

HELP

Used to display a list of all the keywords that you can use with the modify command.

You can also use the HELP parameter after the CANCEL, and DISPLAY parameters to display lists of all the keywords you can use with either of these parameters.

PAUSELISTENERS

Used to prevent work from being accepted into the server. Use this parameter to shut down the communication listeners and purge any pending work in the work registry.

Avoid trouble: The MODIFY server,PAUSELISTENERS command stops the controller from listening on all ports except IIOP (ORB_TCP_SECURE and ORB_TCP_LISTENER). For IIOP, when this modify command is issued, the daemon stops sending requests to the IIOP transport channels. However, if you are running client applications that do caching, such as bean caching, it is possible for requests from these applications to be sent directly to the open IIOP port. This situation might occur because the IIOP listeners start early in the server startup process, thereby possibly opening the IIOP port before this modify command is issued.

WLM_MIN_MAX=min,max

Used to dynamically modify the minimum and maximum number of servants settings (wlm_minimumSRCount and wlm_maximumSRCount). WLM dynamically adjusts the current number of active servants to fit within the new constraints. The new settings do not necessarily take effect immediately; WLM works toward the new minimum and maximum targets as quickly as possible, considering factors such as resource availability and workload.

Avoid trouble: The WLM_MIN_MAX command is ignored for a server that is configured with a single server dynamic application environment, that is the wlm_dynapplenv_single_server property is set to 1.

WORKERTHREADMAX=n

Used to increase the controller region worker thread pool maximum. The value specified on the modify command overrides the value specified for the control_region_thread_pool_maximum_size environment variable. The maximum can only be increased. Requests to decrease the maximum will be rejected. When specifying a maximum ensure that there will be enough resources available to support the specified maximum. An example of a resource to consider is the JVM heap size.

RESUMELISTENERS

Used to restart the communication listeners after issuing a modify command that includes the PAUSELISTENERS parameter. This parameter allows new work to be accepted into the server.

DISPLAY

Used to display the name of the server, the system name where the server is running, and the current code level.

You can specify the following options for this parameter:

• SERVERS displays the name of the server at which the command is directed, the system name, and the code level for each active server in the sysplex that is in the same cell.
• SERVANTS: displays a list of the address space identifiers (ASIDs) of the servants that are attached to the server against which you issued the display command.
• TRACE displays trace information for a server controller. You can further modify this command with one of the following options:
  • SRS displays trace information for all servants, one at a time.
  • ALL displays trace information for the controller and all servants one at a time.
  • JAVA displays the Java trace string settings for a server controller. You can further modify this command with one of the following options:
    • SRS displays Java trace information for all servants, one at a time.
    • ALL displays Java trace information for the controller and all servants one at a time.
    • HELP displays a list of all the keywords that you can use with the modify display trace Java command.
  • HELP displays a list of all the keywords that you can use with the modify display trace command.
• JVMHEAP displays the JVM heap information for a server controller. You can further modify this command with one of the following options:
  • SRS displays the JVM heap information for all servants, one at a time.
  • ALL displays the JVM heap information for the controller and all servants, one at a time.
  • HELP displays a list of all the keywords that you can use with the modify display Javaheap command.
• LISTENERS displays the connection instance name, associated IP address, and listening port number. The associated IP address can display an asterisk (*) as a wildcard.
• CONNECTIONS displays each connection instance name and a count of the number of connections. Each connection instance is on a separate line. You can further modify this command with one of the following options:
  • NAME='name' displays the number of associated connections for the specified connection instance 'name'. If the connection name is located but has zero connections, the command returns a count of zero. If the connection name is not found, the command returns an error message.
  • LIST displays the remote host information for all the connections of each of the connection instances. If a connection instance name has no connections, the command returns only the connection instance name.
  • LIST, NAME='name' displays the remote host information for all connections of a specified connection instance 'name'.
• HELP displays a list of all the keywords that you can use with the modify command.
• ERRLOG displays the last 10 entries in the error log. You can further modify this option with one of the following options:
  • SRS displays the last 10 entries in the error log for all servants, one at a time.
  • HELP displays a list of all the keywords you can use with the modify display error log command.
• MODE displays the run bit mode.
• MSGROUTE displays the list of messages for all routing locations and for messages to suppress. Routing locations can be the error log, the system log, or the MVS operator console.
  • ERRORLOG displays a list of messages to route to the error log.
  • HARDCOPY displays a list of messages to route to the SYSLOG system log, also known as hardcopy.
  • CONSOLE displays a list of messages to route to the MVS operator console.
  • NONE displays a list of messages to suppress.
• SMF displays the status of SMF 120-9 record creation for a server.
  • ASYNC displays the status of SMF 120-9 record creation for asynchronous work on all servants, one servant at a time.
  • HELP displays a list of all the keywords you can use with the modify display SMF command.
• WORK displays the work element counts for the server. You can further modify this option with one of the following options:
  • CRA displays CRA message-driven bean (MDB) request count information. You can further modify this command with one of the following options:
    • SRS displays CRA request count information for all servants, one at a time.
    • HELP displays a list of all the keywords you can use with the modify display work CRA command.
  • ASYNCSERVLET displays the total number of asynchronous servlet requests and the current number of asynchronous servlet requests being processed. The total number of asynchronous servlet requests consists of only requests made since the latest start or restart of the entire server. However, the total can decrease if one or more of the servants has been stopped or restarted.
    • SRS displays for each servant the total number of asynchronous servlet requests and the current number of asynchronous servlet requests being processed. The total number is the number of asynchronous servlet requests since the last start or restart of the servant.
    • HELP displays a list of all the keywords you can use with the modify display work asyncservlets command.
  • EJB displays Enterprise JavaBeans (EJB) request count information. You can modify this option with one of the following options:
    • SRS displays EJB request count information for all servants, one at a time.
    • HELP displays a list of all the keywords you can use with the modify display work EJB command.
  • SERVLET displays servlet request count information. You can modify this option with one of the following options:
    • SRS displays servlet request count information for all servants, one at a time.
    • HELP displays a list of all the keywords you can use with the modify display work servlet command.
  • MDB displays message-driven bean (MDB) request count information. You can further modify this command with one of the following options:
    • SRS displays MDB request count information for all servants, one at a time.
    • HELP displays a list of all the keywords you can use with the modify display work MDB command.
  • SIP displays Session Initiation Protocol (SIP) request count information. You can modify this option with one of the following options:
    • SRS displays SIP request count information for all servants, one at a time.
    • HELP displays a list of all the keywords you can use with the modify display work SIP command.
  • SUMMARY displays summary request count information.
    • SRS displays summary request count information for all servants, one at a time.
    • HELP displays a list of all the keywords you can use with the modify display work summary command.
  • ALL displays all request count information.
    • SRS displays all request count information for all servants, one at a time.
    • STATS displays all detailed statistics.
    • HELP displays a list of all the keywords you can use with the modify display work all command.
  • CLINFO displays work classification information.
  • HELP displays a list of all the keywords you can use with the modify display work command.
  • OLA displays inbound Optimized Local Adapter (OLA) requests driven by services BBOA1INV and BBOA1SRQ. You can further modify this command with one of the following options:
    • SRS displays OLA request count information for all servants, one at a time.
    • HELP displays a list of all the keywords you can use with the modify display work all command.

• Fast Response Cache Accelerator (FRCA). Display FRCA cache statistics as follows:
  • f <servername>,display,frca
  • f <servername>,display,frca,content
  • f <servername>,display,frca,stats
• ADAPTER
  • STATUS displays the status of the optimized local adapters component.
  • REGISTRATIONS displays a list of optimized local adapters clients connected to this server.
  • DAEMONRGES displays a list of optimized local adapters clients connected to any server in this daemon group.
  • SEARCHRGES displays a list of optimized local adapters clients connected to any server in this daemon group, matching search criteria.

ASIDX=

Add ASIDX= after the modify command with the appropriate ASID (in hex) of a servant region you want to dump.

For example:

MODIFY server,JAVACORE,ASIDX=F4

In this example, the command takes a JAVACORE of the servant region whose (hex) ASID is 'F4'.

Example: Establishing a general level of trace using scripting

f server,traceall=n

Valid trace levels are 0 (none), 1 (exception), 2 (basic), and 3 (detailed tracing). Under normal conditions and in production, use 1 (exception).

f bbo6acr,traceall=1

f bbo6acr,traceall=1
BBOO0211I MODIFY COMMAND TRACEALL=1 COMPLETED SUCCESSFULLY

Example: Setting basic and detailed trace levels for the WebSphere z/OS components

f server,tracebasic=(n,...)

f bbo6acr,tracebasic=a

f bbo6acr,TRACEBASIC=A
BBOO0211I MODIFY COMMAND TRACEBASIC=A COMPLETED SUCCESSFULLY

f server,tracedetail=(n,...)

f bbo6acr,tracedetail=e

f bbo6acr,TRACEDETAIL=E
BBOO0211I MODIFY COMMAND TRACEDETAIL=E COMPLETED SUCCESSFULLY

Example: Setting specific trace points using scripting

f server,tracespecific=n | (n,...)

f bbo6acr,tracespecific=04006001

f bbo6acr,tracespecific=(04006001,04006027)

f bbo6acr,tracespecific='tracepoints'

Example: Excluding specific trace points using scripting

f server,trace_exclude_specific=n | (n,...)

f bbo6acr,tracespecific=04006000

f bbo6acr,trace_exclude_specific=04006031

Example: Resetting to the initial trace settings using scripting

f server,traceinit

Example: Command to turn off tracing using a command line

f server,tracenone

Example: Sending the trace to SYSPRINT using scripting

f server,tracetosysprint=yes

f server,tracetosysprint=no

Example: Canceling application clusters and servers with the modify command

This example demonstrates how to cancel application clusters and servers with the modify command.

Before you begin: You cannot cancel a cluster from the MVS console. Instead, you must cancel each of the servers that make up the cluster.

f bbo6acr,cancel

f bbo6acr,cancel,armrestart

Example: Getting help for the modify command

You can get syntax help for the various levels of the modify command.

f bbo6acr,help

F bbo6acr,HELP
BBOO0178I THE COMMAND MODIFY MAY BE FOLLOWED BY ONE OF THE FOLLOWING KEYWORDS:
BBOO0179I CANCEL - CANCEL THIS CONTROL REGION
BBOO0179I TRACEALL - SET OVERALL TRACE LEVEL
BBOO0179I TRACEBASIC - SET BASIC TRACE COMPONENTS
BBOO0179I TRACEDETAIL - SET DETAILED TRACE COMPONENTS
BBOO0179I TRACESPECIFIC - SET SPECIFIC TRACE POINTS
BBOO0179I TRACEINIT - RESET TO INITIAL TRACE SETTINGS
BBOO0179I TRACENONE - TURN OFF ALL TRACING
BBOO0179I TRACETOSYSPRINT - SEND TRACE OUTPUT TO SYSPRINT (YES/NO)
BBOO0179I TRACETOTRCFILE - SEND TRACE OUTPUT TO TRCFILE DD CARD (YES/NO)
BBOO0179I DISPLAY - DISPLAY STATUS
BBOO0179I TRACE_EXCLUDE_SPECIFIC - EXCLUDE SPECIFIC TRACE POINTS
BBOO0179I TRACEJAVA - SET JAVA TRACE OPTIONS
BBOO0179I TRACETOTRCFILE - SEND TRACE OUTPUT TO TRCFILE (YES/NO)   
BBOO0179I MDBSTATS - MDB DETAILED STATISTICS                       
BBOO0179I PAUSELISTENERS - PAUSE THE COMMUNICATION LISTENERS       
BBOO0179I RESUMELISTENERS - RESUME THE COMMUNICATION LISTENERS           
BBOO0179I STACKTRACE - LOG JAVA THREAD STACK TRACEBACKS              
BBOO0179I TIMEOUTDUMPACTION - SET TIMEOUT DUMP ACTION               
BBOO0179I TIMEOUTDUMPACTIONSESSION - SET TIMEOUT DUMP ACTION SESSION
BBOO0179I WLM_MIN_MAX - RESET WLM MIN/MAX SERVANT SETTINGS 

f bbo6acr,display,help

 F BBOS001,DISPLAY,HELP                                                   
 BBOO0178I THE COMMAND DISPLAY, MAY BE FOLLOWED BY ONE OF THE FOLLOWING   
 124                                                                      
 KEYWORDS:                                                                
 BBOO0179I SERVERS - DISPLAY ACTIVE CONTROL PROCESSES                     
 BBOO0179I SERVANTS - DISPLAY SERVANT PROCESSES OWNED BY THIS CONTROL 126 
 PROCESS                                                                  
 BBOO0179I LISTENERS - DISPLAY LISTENERS                                  
 BBOO0179I CONNECTIONS - DISPLAY CONNECTION INFORMATION                   
 BBOO0179I TRACE - DISPLAY INFORMATION ABOUT TRACE SETTINGS               
 BBOO0179I JVMHEAP - DISPLAY JVM HEAP STATISTICS                          
 BBOO0179I WORK - DISPLAY WORK ELEMENTS                                   
 BBOO0179I ERRLOG - DISPLAY THE LAST 10 ENTRIES IN THE ERROR LOG          
 BBOO0179I MODE - DISPLAY THE EXECUTION BITMODE                           
 BBOO0188I END OF OUTPUT FOR COMMAND DISPLAY,HELP

f bbos001,timeoutdumpactionsession=help

BBOO0178I THE COMMAND MODIFY TIMEOUTDUMPACTIONSESSION= MAY BE FOLLOWED BY
ONE OF the FOLLOWING KEYWORDS:   
BBOO0179I SVCDUMP - SVC DUMP  
BBOO0179I JAVACORE - JAVA CORE DUMP   
BBOO0179I NONE - NO DUMP                   

f bbos001,dpm,help                                                  

BBOO0178I THE COMMAND MODIFY DPM, MAY BE FOLLOWED BY ONE OF THE  
FOLLOWING KEYWORDS:    
BBOO0179I IIOP - IIOP DISPATCH PROGRESS MONITOR INTERVAL         
BBOO0179I HTTP - HTTP DISPATCH PROGRESS MONITOR INTERVAL         
BBOO0179I HTTPS - HTTPS DISPATCH PROGRESS MONITOR INTERVAL       
BBOO0179I MDB - MDB DISPATCH PROGRESS MONITOR INTERVAL           
BBOO0179I SIP - SIP DISPATCH PROGRESS MONITOR INTERVAL           
BBOO0179I SIPS - SIPS DISPATCH PROGRESS MONITOR INTERVAL         
BBOO0179I INTERVAL - ALL DISPATCH PROGRESS MONITOR INTERVALS     
BBOO0179I OLA - OLA DISPATCH PROGRESS MONITOR INTERVAL   
BBOO0179I DUMP_ACTION - DISPATCH PROGRESS MONITOR DUMP ACTION    
BBOO0179I CLEAR_ALL - CLEAR ALL DISPATCH PROGRESS MONITOR SETTINGS
BBOO0179I RESET_ALL - RESET ALL DISPATCH PROGRESS MONITOR SETTINGS
BBOO0211I MODIFY COMMAND DPM, COMPLETED SUCCESSFULLY 

BBOO0178I THE COMMAND MODIFY DPM, MAY BE FOLLOWED BY ONE OF THE   
FOLLOWING KEYWORDS:  
BBOO0179I IIOP - IIOP DISPATCH PROGRESS MONITOR INTERVAL  
BBOO0179I HTTP - HTTP DISPATCH PROGRESS MONITOR INTERVAL   
BBOO0179I HTTPS - HTTPS DISPATCH PROGRESS MONITOR INTERVAL 
BBOO0179I MDB - MDB DISPATCH PROGRESS MONITOR INTERVAL            
BBOO0179I SIP - SIP DISPATCH PROGRESS MONITOR INTERVAL  
BBOO0179I SIPS - SIPS DISPATCH PROGRESS MONITOR INTERVAL   
BBOO0179I OLA - OLA DISPATCH PROGRESS MONITOR INTERVAL   
BBOO0179I INTERVAL - ALL DISPATCH PROGRESS MONITOR INTERVALS     
BBOO0179I DUMP_ACTION - DISPATCH PROGRESS MONITOR DUMP ACTION     
BBOO0179I CLEAR_ALL - CLEAR ALL DISPATCH PROGRESS MONITOR SETTINGS
BBOO0179I RESET_ALL - RESET ALL DISPATCH PROGRESS MONITOR SETTINGS
BBOO0179I CRA - MDB CRA DISPATCH PROGRESS MONITOR INTERVAL 
BBOO0211I MODIFY COMMAND DPM, COMPLETED SUCCESSFULLY        

Example: Modifying the Java trace string

This example shows how to use a console command to modify a Java trace string.

f server, tracejava='trace specification'

f bbo6acr,tracejava='*=all'

Example: Modifying the diagnostic action that is taken if a JVM out-of-memory condition occurs

This example shows how to use a console command to modify the diagnostic action that is taken if a Java Virtual Machine (JVM) out-of-memory condition occurs, use the following command:

f server,javaoom,[interval=xxx | action=xxx]

f bbo6acr,,javaoom,[interval=1200 | action=svcdump]