Previous Page Contents Page Next Page

3.4 Stopping the RJE Workstation

The snarjestop command stops the RJE workstation.

Sample command: snarjestop -j wks1

You must use this command on the computer on which the workstation is running (the computer for which it is configured). Consult your System Administrator if necessary, or refer to the SNAP-IX Administration Guide for information about RJE workstation configuration.

3.4.1 Syntax

The syntax for the snarjestop command is:

snarjestop [ -sn | -j | -i ] wkst

3.4.2 Options

You can use one of the following options with the snarjestop command:

n

Stop After Inactivity. The workstation continues to process any jobs waiting on the spool. It stops when none of the following have occurred for n minutes (minimum 1):

  • Jobs on the spool waiting to be submitted

  • RJE console commands

  • Output returned from the host

  • Console messages from the host

The workstation also stops, regardless of work waiting to be processed, if it loses contact with the local node and cannot re-establish contact within n minutes. This generally occurs because the local node has been stopped.

Finish Job. If the workstation is currently sending a job to the host, receiving data from the host, or both, it finishes these transactions; it then stops without processing further jobs. Any unprocessed jobs remain on the spool and can be sent during a later run of the workstation.

Immediate. The workstation stops immediately. Any job currently being sent to the host or any output currently being received from the host is abandoned. Use this option only in error conditions, because this option disrupts RJE processing. (If a job was abandoned during sending, you need to cancel and resubmit it in order to send it to the host when the workstation is restarted. Some hosts may try to resend output that was abandoned during receiving.)

You can specify only one of these options. If none is specified, the default is , indicating that the RJE workstation is stopped after one minute of inactivity at that station.

3.4.3 Parameters

You must use the following parameter with the snarjestop command:

wkst

Name of the RJE workstation to stop. This must be the name of a running RJE Workstation. The workstation name is not case sensitive.

3.4.4 Returned Messages

The format of the snarjestop command returned messages is:

RJE Workstation wkst: Stop command issued, level 
level

The level variable indicates the stop option used-'Immediate,' 'Finish Job,' or 'Inactivity.'

Other messages can be sent to standard error, indicating (for instance) the following:

3.4.5 Usage Notes

When using the n option, the workstation may take some time to stop. You can use snarjestop -i or snarjestop -j to override a pending snarjestop -sn if you need to stop the workstation more quickly.

Previous Page Contents Page Top of Page Next page