Command Reference

This chapter describes all of the BDT commands.

The commands are in alphabetic order by abbreviated command name, and each command begins a new page. Each command description contains a brief explanation of the purpose of the command, a syntax diagram, some brief usage notes, messages BDT issues in response to the command, and some examples of the command in use.

If you do not understand terms or rules of command syntax, refer to Writing and Submitting BDT Commands.

C,SNA — Cancel a Session

Purpose

Use this command to cancel a session between a node at your BDT subsystem and another node or nodes. Canceling a session stops all communication.

Format


>>-prefix--+-CANCEL-+--,SNA,NODE=--+-node-name-+---------------->
           '-C------'              +-ALL-------+   
                                   +-FTF-------+   
                                   '-NJE-------'   

   .-,QUIESCE-.   
>--+-,FORCE---+------------------------------------------------><

prefix: is the prefix that is appropriate for your console or terminal. Do not use a prefix when submitting commands in a batch job.
SNA: is required.
node-name: is the name of the node to which communication is to be stopped. Specify only one node name.
ALL: specifies that communication to all nodes is to be stopped. This cancels the BDT SNA manager.
FTF: specifies that all file-to-file communication is to be stopped.
NJE: specifies that all NJE communication is to be stopped.
FORCE: disables the session immediately. Jobs being processed will be terminated.
QUIESCE: disables the system in an orderly fashion. Jobs being processed will be allowed to complete; no new jobs will be begun. If you do not specify FORCE or QUIESCE, QUIESCE is assumed.

Usage Notes

All forms of this command disable automatic session restart (ASR).
When stopping communication between file-to-file nodes, you can issue this command at either the local node or the global node.
You must be authorized to use this command.
To restart sessions terminated with C,SNA,NODE=node-name, C,SNA,NODE=FTF, or C,SNA,NODE=NJE, use the START,SNA or RESTART,SNA command.
To restart sessions terminated with C,SNA,NODE=ALL, use the X,SNA command to reactivate the BDT SNA manager, and the START,SNA command to start the sessions.
The QUIESCE parameter allows jobs on the session to finish, and so saves you from having to resubmit jobs that are being processed when you issue the CANCEL command. The FORCE parameter does not allow jobs on the session to finish. NJE jobs terminated with the FORCE parameter will have to be resubmitted. File-to-file jobs terminated with the FORCE parameter may be restarted from the last checkpoint.
If you issue a CANCEL command with the QUIESCE parameter, but then decide you do not want to wait for an orderly session shutdown, you may issue a second CANCEL command with the FORCE parameter before the first CANCEL has completed.
To suspend the transfer of data without canceling the session, use the V (VARY) command.

Results

BDT issues these messages:

BDT2861 SESSION CANCEL REQUESTED FOR node-name (appl-id)
        TYPE={FTF|NJE}
BDT2866 STOP SESSION INITIATED - node-name (appl-id) -
        ERC=(err codes) - OPERATOR CANCELLED SESSION
BDT2803 SESSION TERMINATED WITH node-name (appl-id)
BDT2820 SCIP  SESSION UNBIND REQUESTED FOR node-name
        (appl-id), TYPE={FTF|NJE}
BDT2803 SESSION TERMINATED WITH node-name (appl-id)

Note: You will only receive all of these messages at your console if you enter the command in a poly-BDT system.

For C,SNA,NODE=ALL, BDT2861 is not issued, and the following additional messages are issued:

BDT2866 STOP SESSION INITIATED - node-name (appl-id) -
        ERC=(err codes)
BDT2805 SNA MANAGER TERMINATED
BDT6006 (0001,SNA) JOB ENDED AT hh:mm:ss ON yyyy.ddd -
        COMP=ZE RO

Note: You will only receive all of these messages at your console if you enter the command in a poly-BDT system.

Examples of canceling a session

Using an F id prefix, stop communication between your node, SYSA1, and node SYSA2. The identifier of BDT (for use in the prefix) is A1.

F A1 CANCEL,SNA,NODE=SYSA2

Result:

BDT2861 SESSION CANCEL REQUESTED FOR SYSA2 (APPLA2)
        TYPE=FTF
BDT2866 STOP SESSION INITIATED - SYSA2 (APPLA2) -
        ERC=(D04,0) - OPERATOR CANCELLED SESSION
BDT2803 SESSION TERMINATED WITH SYSA2 (APPLA2)
BDT2820 SCIP SESSION UNBIND REQUESTED FOR SYSA1
        (APPLA1), TYPE=FTF
BDT2803 SESSION TERMINATED WITH SYSA1 (APPLA1)

Using the *S,BDT prefix, stop all file-to-file communication immediately between your file-to-file node and other nodes.

*S,BDT,CANCEL,SNA,NODE=FTF,FORCE

Result:

BDT2862 SESSION QUIESCE REQUESTED FOR SYSA2 (APPLA2), TYPE=FTF
BDT2861 SESSION CANCEL REQUESTED FOR SYSA2 (APPLA2)
        TYPE=FTF
BDT2866 STOP SESSION INITIATED - SYSA2 (APPLA2) -
        ERC=(D04,0) - OPERATOR CANCELLED SESSION
BDT2803 SESSION TERMINATED WITH SYSA2 (APPLA2)
BDT2820 SCIP SESSION UNBIND REQUESTED FOR SYSA1
        (APPLA1), TYPE=FTF
BDT2803 SESSION TERMINATED WITH SYSA1 (APPLA1)

Using the *S,BDT prefix, stop communication between your node, SYSA1, and all other nodes.

*S,BDT,CANCEL,SNA,NODE=ALL

Result:

BDT2866 STOP SESSION INITIATED - SYSA2 (APPLA2) -
        ERC=(C04,0)
BDT2803 SESSION TERMINATED WITH SYSA2 (APPLA2)
BDT2805 SNA MANAGER TERMINATED
BDT6006 (0001,SNA) JOB ENDED AT 18:56:46 ON 83.152 -
        COMP=ZERO
BDT2820 SCIP SESSION UNBIND REQUESTED FOR SYSA1
        (APPLA1), TYPE=FTF
BDT2803 SESSION TERMINATED WITH SYSA1 (APPLA1)