|
|
|
|
The RJE workstation is the program responsible for taking jobs from the spool and sending them to the host for processing. It also receives host output returned by the host and routes it as required; see Output Routing, for more information.
Your SNAP-IX system may be configured for more than one RJE workstation. Each RJE workstation is configured to run on a particular Solaris computer (which can be either a server or a client). A workstation can be started only on its configured computer, and other RJE commands related to the workstation (stopping the workstation, displaying the workstation's status, sending host commands, or starting the console program) must be issued on the same computer. Spool commands to submit, list, or cancel jobs for the workstation must also be issued on the same computer, unless your System Administrator has set up the configuration to enable them to be issued from other computers.
In general, a group of users is assigned to each workstation; your System Administrator tells you which workstations you are to use.
The workstation does not need to be run at the same time as the spool commands; you can use the spool commands at any time to add, list, or delete jobs on the spool, and you can run the workstation at any time to process any jobs that are waiting on the spool. The only restriction is that the SNA software must be started in order for the workstation to run.
While the workstation is running, the reader device takes jobs from the spool in the order in which they were submitted, and sends them to the host. When it has sent a job to the host, the job is deleted from the spool. When you first submit a job to the spool, you can specify a maximum retry count (the default is ten). If the workstation encounters an error while sending the job (for example, a session failure), it retries up to this maximum number of times. If all these attempts to send the same job fail, the workstation logs an error message and continues with the next job. The files from the failed job are left in the spool directory; you should remove them after checking the reason for the failure and resubmitting the job.
Before starting an RJE workstation, be sure that the SNAP-IX software is running. Consult your System Administrator if necessary, or refer to the SNAP-IX Administration Guide.
Also be sure that your user ID is in the group configured for this workstation. Consult your System Administrator if necessary.
Use the snarjewks command to start the workstation.
Sample command: snarjewks -s2 wks1
For more information about this command, see RJE Commands.
Normally, once the workstation is started, it continues to run until it is stopped by the snarjestop command (see Stopping the Workstation). Alternatively, you can specify a time-out parameter with the option when starting the workstation. In this case, the workstation stops when one of the following conditions occurs:
All the spooled jobs have been sent to the host, and the specified time (in minutes) has elapsed with no RJE activity-no jobs submitted, no console commands entered, and no output or console messages received.
The workstation lost contact with the local node, and the specified time (in minutes) has elapsed without re-establishing contact. This generally occurs because the local node has been stopped.
If you need to stop the workstation more quickly, without waiting for RJE activity to end, you can stop it using the snarjestop command.
To display a workstation's status information, be sure that your user ID is in the group configured for the workstation. Consult your System Administrator if necessary.
Use the snarjestat command to display the workstation's status.
Sample command: snarjestat -d wks1
For more information about this command, see RJE Commands.
Depending on the options you specify, you can view information about the workstation's LUs, devices, or both. Devices are printers, punches, the console, and the reader. See Device Types, RJE Workstation, and RJE Console Program, for more information about these devices.
To stop an RJE workstation, be sure that your user ID is in the group configured for the workstation.
Use the snarjestop command to stop the workstation.
Sample command: snarjestop wks1
For more information about this command, see RJE Commands.
You can specify one of the following options when stopping a workstation:
The workstation continues sending any spooled jobs. It stops only when the spool is empty and no jobs have been submitted or output received from the host for a specified time. This is the default option, with a one-minute time-out; that is, if no option is specified, the workstation stops after one minute without RJE activity.
Because jobs can be submitted at any time regardless of whether the workstation is running, further jobs may be added to the spool after the stop command has been issued; the workstation continues to send these jobs, and does not stop until the spool is empty. It may therefore take some time for the stop command to take effect. If necessary, you can override this by issuing the stop command again with one of the other options.
The workstation also stops, regardless of work waiting on the spool, if it loses contact with the local node and cannot re-establish contact within the specified time-out period. (This generally occurs because the local node has been stopped.)
The workstation finishes sending the current job, if any, and then stops; any other spooled jobs remain on the spool and can be sent during a later run.
The workstation stops immediately, even if it is currently sending a job to the host or receiving data. Use this option only in error situations, because this option disrupts both the sending and receiving of RJE data.
The snajoblst command lists jobs that have been spooled for a particular RJE workstation, and enables you to check their status (waiting, sending in progress, or failed). Normally, when SNAP-IX has successfully sent a job to the host, it removes the stored status information for the job, so that the snajoblst command no longer returns it.
If you prefer, you can set up the workstation to retain status information on sent jobs, so that you can use options on the snajoblst command to view the information and check that the jobs have been sent. To do this, use the list_sent_jobs option in the RJE workstation style file; see The RJE Workstation Style File, for more information.
If you use this option, SNAP-IX retains the stored status information until you purge it using the snajobpur command. Use this command regularly, because retaining the status information for large numbers of files uses up disk space and can affect the performance of RJE programs.
For more information about the snajoblst and snajobpur commands, see RJE Commands.
SNAP-IX creates several files and directories for each RJE workstation on the computer for which each workstation is configured. One of these directories is named /var/opt/sna/rje/ WKST, where WKST is the name of the RJE workstation (in uppercase). The directory contains files and further subdirectories as follows:
Default output directory. This is the default path for file output or directory output.
Output intended for a program is stored in this directory until it can be passed to the program.
Spool directory. Jobs that have been submitted are stored in this directory until they are sent to the host.
This directory contains log files that provide the information required by the console program.
A pipe used by the console program to send commands to the host.
A lock file that indicates the workstation's status to other RJE components.
Apart from the subdirectory output (see Output Routing), these files and directories cannot be accessed directly. They are for internal use by RJE programs.
When a workstation is started, or when a job is submitted for the workstation, SNAP-IX creates the required files and directories (if they do not already exist from a previous run of the workstation). They are not removed when the workstation is stopped, since they may be required later; for example, jobs may be spooled for the workstation while it is not running.
To remove all the files and directories associated with a workstation, use the snarjeclr command.
Sample command: snarjeclr wks1
This command is for System Administrator use only. Use it only if a workstation is no longer being used and has been removed from the configuration or if a serious error has occurred. Clearing the directories removes any spooled jobs, stored status information for sent jobs, files on the default output directory, and stored history of console activity. See Clearing a Workstation's Directories, for more information.
To remove files from directories other than the output directory (for example, to clean up after a serious error condition), you must be logged on as root. If you do not have the necessary privileges, consult your System Administrator.
|
|
|
 |
|