Modify command

Use the modify command from the MVS console to dynamically modify WebSphere for z/OS operations.

You can use the modify command to display status of various server components and activities, including:

Syntax

f <server>, options

The first argument is required. The argument is the name of the server for which the modify command will be directed.

Parameters

The options for the modify command follow:

CANCEL
Used to cancel a server. server refers to the server short name.

You can specify the following options:

ARMRESTART
Specify if you are using ARM and want ARM to restart the server after it terminates. If you don't specify the ARMRESTART option on the CANCEL parameter, ARM will not restart the server.
HELP
Get help for the CANCEL syntax.

Note: You cannot use the CANCEL parameter to cancel a cluster from the MVS console. Instead, you must cancel each of the servers that make up the cluster.

TRACEALL=n
Use TRACEALL to establish a general trace level for the server.

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

Note: Be careful when using a level of 3 (detailed for all components) because it can potentially yield more data than can be handled reasonably.

TRACEBASIC=n
Specify the WebSphere for z/OS components for which you want to switch on a basic level of tracing.

This command has the ability to override a different tracing level established by TRACEALL for those components.

Note: Do not change this variable unless directed by IBM service personnel.

You can specify one or more of the following options for either TRACEBASIC or TRACEDETAIL:

0
RAS
1
Common Utilities
3
COMM
4
ORB
6
OTS
7
Shasta
9
OS/390 Wrappers
A
Daemon
E
Security
F
Externalization
J
JRAS (internal tracing-via direction from IBM support)
L
J2EE

TRACEDETAIL=n
Specify the WebSphere for z/OS components for which you want to switch on a detailed level of tracing.

This command activates the most detailed tracing for the specified WebSphere for z/OS components and overrides different settings inTRACEALL. The selected components (n,...) are identified by their component-ID (valid values are the same as for TRACEBASIC above. Subcomponents, specified by numbers, receive detailed traces. Other parts of WebSphere for z/OS receive tracing as specified on the TRACEALL variable.

Note: Do not change this variable unless directed by IBM service personnel.

TRACESPECIFIC=xxyyyzzz
Specifies tracing overrides for specific WebSphere for z/OS trace points.

Trace points are specified by 8-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 quotes. The value of the environment variable will be handled as if you had specified that value on TRACESPECIFIC.

Note: Do not use TRACESPECIFIC unless directed by IBM service personnel.

TRACE_EXCLUDE_SPECIFIC=xxyyyzzz
Specifies trace points to exclude.

Trace points to exclude are specified by 8-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 quotes. The value of the environment variable will be handled as if you had specified that value on TRACE_EXCLUDE_SPECIFIC. You can use TRACE_EXCLUDE_SPECIFIC as a mask to turn off otherwise-on traces. For example, use the TRACESPECIFIC command to turn on tracing for a whole part and then use TRACE_EXCLUDE_SPECIFIC to turn off one trace within that part.

Note: Do not use TRACE_EXCLUDE_SPECIFIC unless directed by IBM service personnel.

TRACEINIT
Reset to the initial trace settings.
TRACENONE
Turns off all trace settings.
TRACETOSYSPRINT={YES|NO}
Select whether or not to send the trace to sysprint.

YES specifies to send the trace to sysprint and NO stops sending the trace to sysprint.

TRACETOTRCFILE={YES|NO}
Select whether or not to direct the trace to the TRCFILE DD card.

YES specifies to send the trace to the TRCFILE DD card and NO stops sending 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.

HELP
Display a list of all the keywords you may 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
Prevents work from being accepted into the server. Use this command if you want to shut down the communication listeners and purge any pending work in the work registry.
RESUMELISTENERS
Use this command to restart the communication listeners after issuing a PAUSELISTENERS command. Allows work to be accepted into the server.
DISPLAY | DISPLAY,
Displays the server's name, the system name where it is running, and the current code level.

You can specify the following options:

SERVERS
This command is directed to a server and displays the name, system name, and code level for each active server in the sysplex that is in the same cell.
SERVANTS
Displays a list of ASIDs of servants attached to the server against which you issued the display command.
TRACE
Display trace information for a server controller.

You can further modify this command with one of the following options:

SRS
Display trace information for all servants, one at a time.
ALL
Display trace information for the controller and all servants one at a time.
JAVA
Display the Java trace string settings for a server controller.You can further modify this command with one of the following options:
SRS
Display Java trace information for all servants, one at a time.
ALL
Display Java trace information for the controller and all servants one at a time.
HELP
Display a list of all the keywords you may use with the modify display trace java command.
HELP
Display a list of all the keywords you may use with the modify display trace command.

JVMHEAP
Display the JVM heap information for a server controller.

You can further modify this command with one of the following options:

SRS
Display the JVM heap information for all servants, one at a time.
ALL
Display the JVM heap information for the controller and all servants, one at a time.
HELP
Display a list of all the keywords you may use with the modify display javaheap command.

SESSIONS
Display session information for the server.

You can further modify this command with one of the following options:

LISTENERS
Display the listening port numbers for each protocol. This is actually the default, so the f server,sessions and the f server,sessions,listeners commands would have the same outcome.
SERVER
Display the number of sessions in use for each protocol on the server.

You can further modify this command with one of the following options:

TCPIIOP
Display the number of TCP/IP IIOP sessions active on the server.

You can further modify this command with one of the following options:

LIST
List the server session information for the TCP/IP IIOP protocol.
HELP
Display a list of all the keywords you may use with the modify display session server tcpipiiop command.

Note: The LIST and HELP parameters are also available with the other session protocol display commands.

LOCALIIOP
Display the number of LOCALIIOP sessions active on the server.
SSLIIOP
Display the number of SSLIIOP sessions active on the server.
HTTP
Display the number of HTTP sessions active on the server.
HTTPS
Display the number of HTTPS sessions active on the server.
HELP
Display a list of all the keywords you may use with the modify display session server command.

HELP
Display help for the modify display sessions command.

HELP
Display a list of all the keywords you may use with the modify command.


Related reference
Example: Canceling application clusters and servers with the modify command
Example: Establishing a general level of trace
Example: Setting basic and detailed trace levels
Example: Setting specific trace points
Example: Excluding specific trace points
Example: Resetting to the initial trace settings
Example: Turning off tracing
Example: Sending the trace to sysprint
Example: Displaying servants
Example: Displaying trace settings and Java string trace settings
Example: Displaying JVM heap information
Example: Displaying sessions
Example: Displaying status of a server
Example: Displaying status of clusters
Example: Getting help for the modify command
Example: Modifying the Java trace string



Searchable topic ID:   rxml_mvsmodify
Last updated: Jun 21, 2007 9:56:50 PM CDT    WebSphere Application Server for z/OS, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.websphere.zseries.doc/info/zseries/ae/rxml_mvsmodify.html

Library | Support | Terms of Use | Feedback