Stopping SNA RJP activity *CANCEL,SNARJP

Function

Use the *CANCEL command to halt the SNA RJP network, a SNA RJP workstation, or processing on a SNA RJP device.


>>-+-*CANCEL-+--,--SNARJP--,--T--=--+-wsname-+--+------+-------><
   '-*C------'                      '-ALL----'  '-,--I-'

T =wsname or ALL: Specifies the 5-character workstation name as defined in the N= parameter of the RJPWS initialization statement or all workstations.
I: Specifies immediate checkpoint and cancellation of all current activity at one or all workstations.

If the I parameter is not specified, the workstation will be canceled after all current workstation activity has stopped.
If the I parameter is specified, all communication sessions between JES3 and the specified workstation will be immediately stopped and all DSPs currently using any of the workstation devices will be failed. Any job that was in the process of being read from the workstation at the time of termination may be lost and have to be re-submitted when the workstation is later restarted. All output that was in progress will be restarted at the last checkpoint when the workstation is later restarted.
When the I parameter is used to stop a workstation immediately, it can take up to two minutes for workstation termination to complete depending on the state of the workstation at the time of the cancel. After a *CANCEL command is used to stop a workstation, wait for JES3 to issue either message IAT2807 or IAT2813 and then restart the workstation by issuing a *START command to allow the workstation to log on again.
Use the *CANCEL,SNARJP,T=xxx,I command with caution; the results could be unpredictable depending on the status of the workstation. The entire SNARJP application could be shut down by VTAM® for reasons of data integrity as seen in the VTAM environment. It is suggested that this command not be used to shut down a workstation while a signon is in progress and that a simple *C,SNARJP,T=xxx command be issued without the immediate (I) option.