[z/OS]

Enabling or Disabling the reusable ASID function

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 controllers.

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 the controller 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.

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.

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 run the updateZOSStartArgs script to enable or disable this function for a particular server, a particular node, or for all of your servers. For more information, see the conceptual information about the reusable address space.

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, the ASIDs that are associated with the controllers for these servers cannot be reused.
  • 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.

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.