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.
Before you begin
- Verify that the REUSASID(YES) keyword is included in the z/OS DIAGxx PARMLIB
member. This REUSASID option determines whether z/OS is enabled to reuse all
ASIDs for the operating system image, including those that are associated
with cross-process services. If the REUSASID option is set to NO, the ASIDs
associated with cross-process services will not be reused even if you have
run the updateZOSStartArgs script to enable this function for the product.
- Start the wsadmin tool if it is not already running. The wsadmin has to
be connected to a running deployment manager.
About this task
As stated in the z/OS Version 1.9 publication Communications
Server IP Configuration Guide, SC31-8775-11, the TCP/IP address space
provides cross-process routines, such as PC-entered services, that must be
accessible to all address spaces. This requirement means that the Address
Space Identifier (ASID) that is associated with the TCP/IP address space is
not reusable when the address space is stopped or restarted. If the TCP/IP
address space is terminated enough times, all available ASIDs might be exhausted,
preventing the creation of a new address space on the system. If this situation
occurs, you must stop z/OS and re-IPL.
New feature: z/OS
Version 1.9 and higher includes a reusable ASID function that enables you
to permit the use of all ASIDs, including those that are associated with cross-process
services. If you run z/OS with this function enabled, you can use the updateZOSStartArgs
script to enable or disable this function for a particular server, a particular
node, or for all of your servers.
newfeat
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 are able to 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 updateZOSStartArgsscript 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
Procedure
- Run the updateZOSStartArgs script, from the profile_root/bin directory
for the deployment manager, to enable the reuse ASID function.
The
updateZOSStartArgs script is installed in the config_root/bin
directory for the deployment manager.
There are several options that
can be specified for this script.
For example, issue the following command
to enable this function for all of your servers:
wsadmin.sh -conntype
NONE -lang jython -f /path/to/script/updateZOSStartArgs.py Issue
the following command to enable this function for all of the servers on a
particular node:
wsadmin.sh -conntype NONE -lang jython -f /path/to/script/updateZOSStartArgs.py
-node <nodeName>
- Run the updateZOSStartArgs script, from the profile_root/bin directory
for the deployment manager, to disable the reuse ASID function.
There
are several options that can be specified for this script.
For example,
issue the following command to disable this function for a particular server:
wsadmin.sh
-conntype NONE -lang jython -f /path/to/script/updateZOSStartArgs.py -remove
-node <nodeName> -server <serverName>Issue the following
command to disable this function for any server that has the specified name:
wsadmin.sh
-conntype NONE -lang jython -f /path/to/script/updateZOSStartArgs.py -remove
-server <serverName>
- After you run the script, restart any of the affected deployment
manager, node agents, and servers that were running when you ran the script.
Results
After you run this script, the function remains enabled for the
affected servers until you run the script to explicitly disable it.
If
you enable this function in PARMLIB member DIAGxx for all of your servers,
the function is automatically enabled for any new server that you create.
The
REUSASID parameter is automatically set to YES for any new servers that you
create. You do not need to rerun the updateZOSStartArgs script on newly created
servers unless you want to disable the reuse ASID capability.