(ZOS) updateZOSStartArgs script

If we are running the product on z/OS Version 1.9 or higher, we can use the updateZOSStartArgs script provided with the product to control for which of the servers, z/OS can reuse address space identifiers (ASIDs) 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 running when we run this script must be restarted after the script finishes before the changes becomes affective. If we are running in a mixed cell environment, this script only affects our v6.1 and higher servers.

• If we are running the product in a mixed cell environment, even if we enable this function for all of the servers, only Version 6.1 and higher servers can use this function. For example, if we are running some v6.0 servers on the system, these servers cannot reuse the ASIDs associated with cross-process services.

• If we run the updateZOSStartArgs script on z/OS Versions 1.6, 1.7, or 1.8, we 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 the servers.

Options

The following options are available for the updateZOSStartArgs script:

-node nodeName

That we only want to enable the reuse ASID function for the servers associated with the specified node.

-server serverName

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

-remove

To disable the reuse ASID function for all of the servers. This option removes the REUSASID=YES argument from the start command for the specified servers.

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

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

-scripthelp

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

-trace

To create a trace we 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 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 associated with the specified node.

Use command-line tools