Writer instructions
Page title	For most spaces, this page must be titled Space announcements. For spaces with localized content, this page must be titled Space announcements l10n.
Purpose	Provide an announcement banner on every page of your space.
Location	Move this page outside of your home branch.
Guidelines	Adding-a-banner-announcement-to-a-space

Terminating Subzero address spaces and tasks

Use the following procedures to manually terminate Subzero address spaces and tasks on the LPAR in which you enter the command.

Tip

The information that precedes the BMCBRD message number in the BMCPRINT listing displays the:

ID of the LPAR on which you should enter the BRD,STOP or BRD,KILL command
Address space ID that is running the address space or task to be terminated

For example, the following message shows that the LPAR ID is SYSM, and the address space ID is 0129:

13:36:40 SYSM ASID(0129): BMCBRD0350W IMS Thread waiting for DBCTL response ...

For waiting or suspended Subzero tasks, Subzero messages provide information that you can use in a BRD,KILL command to terminate the task. These messages identify the waiting or suspended thread and its associated Subzero task number.

In the Subzero subsystem server, the server monitors thread connections between itself and the supported IBM IMS or DB2 subsystem. Subzero issues message BMCBRD0350W or BMCBRD0351W (for IMS or DB2, respectively) when both of the following conditions exist:
- A thread has issued a subsystem request (for example, an IMS database request).
- The thread has waited for a response for longer than 10 seconds.
In the Subzero controlling agent, the agent monitors client thread connections between the client address space (IBM CICS) and its remote Subzero subsystem server. Subzero issues message BMCBRD0352W if a client thread has waited for more than 60 seconds for a response from the remote server.

Warning

Before you terminate a Subzero address space, execute the processes and procedures that properly terminate a connection between a client and its connected subsystem. If a server shuts down while active connections exist between the client and its remote subsystem, abends can occur in the Subzero, client, and subsystem address spaces.

BMC recommends using the STOP,FORCE commands only if all previous attempts to stop the address space have failed. Terminating a process that is still in use can have unpredictable results.

To stop all Subzero address spaces

Enter the following command to tell DBC to stop executing all Subzero controlling agents and subsystem servers on this LPAR: / dbcssid BRD,STOP

The forcible STOP command format is: / dbcssid BRD,STOP,FORCE

This command is useful for terminating all Subzero activity on an LPAR. If no Subzero address spaces are running on this LPAR, DBC ignores the command.

To stop the Subzero controlling agent task that handles clients

Enter the following command to tell the Subzero controlling agent to stop execution of the task that handles clients on this LPAR: / dbcssid BRD,STOP,CLIENT

The forcible STOP command format is: / dbcssid BRD,STOP,FORCE,CLIENT

This command is useful if you need to stop the task without stopping the controlling agent. This command terminates redirection for all clients. If the task is not running on this LPAR, the controlling agent ignores the command.

To stop a specified Subzero subsystem server

Enter the following command to tell DBC to stop executing a specified subsystem server on this LPAR: / dbcssid BRD,STOP,subsytemType=subsytemID

The forcible STOP command format is: / dbcssid BRD,STOP,FORCE,subsytemType=subsytemID

In this command, subsytemType indicates the type of the target subsystem (DB2ID, or IMSID) that is associated with this subsystem server. subsytemID specifies the IMS or DB2 subsystem ID (or DB2 group ID) of the target subsystem.

This command is useful if you need to stop the subsystem server without stopping the controlling agent or the associated target subsystem; for example, you might use this command because a subsystem server problem occurred. This command stops redirection between the client application and the target subsystem. If the application is still sending requests, it receives a failure. If the subsystem server is not running on this LPAR, the controlling agent ignores the command.

To stop a specified Subzero address space

Enter the following command to tell DBC to stop executing a specified Subzero address space on this LPAR: / dbcssid BRD,STOP,IDType=ID

The forcible STOP command format is: / dbcssid BRD,STOP,FORCE,IDType=ID

The variables are as follows:

IDType indicates the type of identifier you are entering (PIID or ASIDX).
ID specifies the product instance ID or hexadecimal address space ID of the address space that you want to stop.

This command is useful if you need to stop the specified address space. If that address space is not running on this LPAR, DBC ignores the command.

To terminate (kill) a waiting task in a Subzero subsystem server

Enter the following command to terminate execution of a waiting thread (task) in a Subzero subsystem server on this LPAR: / dbcssid BRD,KILL,IDType=subsystemID,TASK=SubzeroTaskNumber

The variables are as follows:

IDType indicates the type of identifier you are entering product instance ID (PIID) or hexadecimal address space ID (ASIDX).
subsystemID specifies the PIID or ASIDX of the task to be terminated.
SubzeroTaskNumber specifies the internal task identifier of the Subzero task in the subsystem server.

You can obtain the PIID and ASIDX and Subzero task number from message BMCBRD0350W (for an IMS thread) or BMCBRD0351W (for a DB2 thread).

This command is valid for terminating the specified task if that task is in a wait state, as indicated by message BMCBRD0350W or BMCBRD0351W. If that task is not in a wait state or is not running on this LPAR, the address space ignores the command.

To terminate (kill) a waiting task in a Subzero controlling agent

Enter the following command to terminate execution of a waiting thread (task) in the Subzero controlling agent on this LPAR: / dbcssid BRD,KILL,CLIENT,TASK=SubzeroTaskNumber

SubzeroTaskNumber specifies the internal task number of the Subzero task in the controlling agent. You can find the task number in the BMCBRD0352W message.

This command is valid for terminating the specified task if that task is in a wait state, as indicated by message BMCBRD0352W. If that task is not in a wait state or is not running on this LPAR, the controlling agent ignores the command.