>>-VARY-- --NET--,--CFS--,--ACTION--=--+-CONNECT----+-----------> '-DISCONNECT-' >--,--STRNAME--=--+-ALL------------+--------------------------->< '-structure_name-'
Abbreviations
| Operand | Abbreviation |
|---|---|
| VARY | V |
| ACTION=CONNECT | CONNECT |
| ACTION=CONNECT | CONN |
| ACTION=DISCONNECT | DISCONN |
| ACTION=DISCONNECT | DISC |
Purpose
The VARY CFS command is used to connect to a VTAM® coupling facility structure or disconnect from a VTAM coupling facility structure. Normally, connecting or disconnecting to a coupling facility structure is handled automatically by VTAM. Using the VARY CFS command, an operator can perform these functions outside normal VTAM processing.
If VTAM is unable to connect to a coupling facility structure or loses its connection to a coupling facility structure, it will use the event notification facility to know when to attempt a reconnection to the coupling structure. The event notification facility will notify VTAM when changes occur in coupling facility resources. This reconnection process is automatic and requires no operator intervention. However, if VTAM disconnects because of the VARY CFS,ACTION=DISCONNECT command, VTAM will ignore event notifications for the particular structure. The VARY CFS,ACTION=CONNECT command must be issued to cause VTAM to reconnect to the structure and also enable event notification for the structure.
To determine if VTAM is using the event notification for a disconnected structure, issue the D NET,STATS,TYPE=CFS command. Message IST1368I will be issued if VTAM is receiving event notifications for the structure.
Operands
- ACTION
- Specifies that VTAM is
to attempt to connect to or disconnect from the coupling facility
structure specified by the STRNAME parameter.
- ACTION=CONNECT
- Specifies that VTAM is to attempt to connect to the coupling facility structure specified by the STRNAME parameter.
- ACTION=DISCONNECT
- Specifies that VTAM is to disconnect from the coupling facility structure specified by the STRNAME parameter.
- STRNAME
- Specifies the name of the structure to connect to or disconnect
from.
- STRNAME=ALL
- Specifies that VTAM will disconnect from all coupling facility structures. STRNAME=ALL can be specified for ACTION=DISCONNECT only.
- STRNAME=structure_name
- Specifies the name of the structure to connect to or disconnect from.