Use this command to deactivate one or more CLAW workstations.
Requirements and Restrictions
- You can enter this command only in 1052 state or higher.
- You can enter this command only from the basic subsystem (BSS).
Format
- WS-wsname
- deactivates the specified CLAW workstation, where wsname is the
1- to 8-character alphanumeric name of the CLAW workstation.
- SDA-sda
- deactivates the CLAW workstation that has the specified symbolic device
address, where sda is the 1- to 4-digit hexadecimal symbolic device
address of the read channel unit on the CLAW workstation.
- Note:
- Symbolic device addresses are always assigned in read/write pairs. In
the TPF system, the symbolic device address assigned to the read channel unit
is always an even hexadecimal number (for example, X'20')
and the write channel unit is always the following odd hexadecimal
number (for example, X'21').
- ALL
- deactivates all of the active CLAW workstations that are defined for this
TPF host processor.
- FORCE
- forces the deactivation of the specified CLAW workstations without
allowing the socket applications to run cleanup routines.
Notes:
- Specify this parameter only if a previous request to deactivate a CLAW
workstation failed.
- Use this parameter only in a test environment because the results cannot
be predicted.
Additional Information
- Online help information is available for this command. To display
the help information, enter one of the following:
ZCLAW HELP
ZCLAW ?
- Use this command to deactivate a CLAW workstation before you delete it
using the ZCLAW DELETE command.
- If the TPF system is cycled below CRAS state, the socket connections are
automatically deactivated, regardless of whether the CLAW workstation is
active or not.
Examples
The following information is displayed in the examples:
- WS
- is the CLAW workstation name.
- HOSTA
- is the CLAW host application name.
- WSA
- is the CLAW workstation application name.
- SDA
- is the symbolic device address of the read channel unit for the CLAW
workstation.
The OS2TCP CLAW workstation is deactivated in the following example.
+--------------------------------------------------------------------------------+
|User: ZCLAW INACT WS-OS2TCP |
| |
|System: CLAW0013I 08.41.25 CLAW DEVICE INACT STARTED |
| WS-OS2TCP HOSTA-TCPIP WSA-API SDA-0200 INACTIVATED |
| CLAW DEVICE INACTIVATION COMPLETED |
+--------------------------------------------------------------------------------+
The CLAW workstation with symbolic device address 220 is deactivated in the
following example.
+--------------------------------------------------------------------------------+
|User: ZCLAW INACT SDA-220 |
| |
|System: CLAW0013I 08.41.25 CLAW DEVICE INACT STARTED |
| WS-OS317202 HOSTA-TCPIP WSA-API SDA-0220 INACTIVATED |
| CLAW DEVICE INACTIVATION COMPLETED |
+--------------------------------------------------------------------------------+
Related Information
See TPF Transmission Control Protocol/Internet
Protocol for more information about deactivating a CLAW workstation and
about TCP/IP offload support.