(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 you 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 the Version 6.1 and higher servers.
Avoid trouble:
- If we are running the product in a mixed cell environment, even if you enable this function for all of the servers, only Version 6.1 and higher servers can use this function. For example, if you are running some Version 6.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, 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.
gotcha
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>
- Specifies that you only want to enable the reuse ASID function for the servers 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 we 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 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
- Specifies 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 to create a trace that 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 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.
Related tasks
Use command-line tools