updateZOSStartArgs script

If you are running the product on z/OS Version 1.9 or higher, you can use the updateZOSStartArgs script that is provided with the product to control for which of your servers, z/OS can reuse address space identifiers (ASIDs) that are associated with cross-process services when those services end.

The updateZOSStartArgs Jython script adds the REUSASID=YES to the start command arguments for the specified servers in the configuration. Any affected server that is running when you run this script must be restarted after the script finishes before the changes becomes affective. If you are running in a mixed cell environment, this script only affects your Version 6.1 and higher servers.

Avoid trouble:

If you are running the product in a mixed cell environment, even if you enable this function for all of your servers, only Version 6.1 and higher servers can use this function. For example, if you are running some Version 6.0 servers on your system, these servers cannot reuse the ASIDs that are associated with cross-process services.
If you run the updateZOSStartArgs script on z/OS Versions 1.6, 1.7, or 1.8, you will not get an error message. However those versions of z/OS ignore the z/OS Start argument that enables the reusable ASID function because the reusable ASID function is not available on those versions of z/OS.

Syntax

The syntax for this script is as follows:

wsadmin.sh -conntype NONE -lang jython -f /path/to/script/updateZOSStartArgs.py [options]

Running this script with no options enables the reuse ASID function for all of your servers.

Options

The following options are available for the updateZOSStartArgs script:

-node <nodeName>

Specifies that you only want to enable the reuse ASID function for the servers that are associated with the specified node.

-server <serverName>

Specifies that you only want to enable the reuse ASID function for the servers that have the specified name. If you use this option in conjunction with the -node option, this function is only enabled for the server with the specified name that is associated with the specified node.

-remove

Specifies that you want to disable the reuse ASID function for all of your servers. This option removes the REUSASID=YES argument from the start command for the specified servers.

If you include the -node option with the -remove option, this function is only disabled for the servers that are associated with the specified node.

If you include the -server option with the -remove option, this function is only disabled for the specified server

-scripthelp

Specifies that you want to see a description of the syntax and options that are available. A -trace option is also available for debug purposes. Debug output goes to stdout .

-trace

Specifies that you want to create a trace that you can use to debug a problem with the application of this function. The trace output is sent to SYSPRINT.

Usage scenario

The following examples demonstrate correct syntax:

wsadmin.sh -conntype NONE -lang jython -f /path/to/script/updateZOSStartArgs.py -node <nodeName>

This example enables the reuse ASID function for the specified node.

wsadmin.sh -conntype NONE -lang jython -f /path/to/script/updateZOSStartArgs.py -node <nodeName> 
-server <serverName>

This example enables the reuse ASID function for the specified server that is associated with the specified node.

wsadmin.sh -conntype NONE -lang jython -f /path/to/script/updateZOSStartArgs.py -remove -node <nodeName>
 -server <serverName>

This example disables the reuse ASID function for the specified server that is associated with the specified node.