|
|
|
|
The snajobsub command submits a job file to the RJE workstation for transfer to the host. It produces a spool file for the named workstation, and returns the file ID for this spool file. Normally the job file is searched for the ~include command, which specifies a file to be included, and is converted from ASCII to EBCDIC; you can override these options if required.
Sample command: snajobsub wks1 myjob
You must submit the job on the computer for which the RJE workstation is configured (unless your System Administrator has set up the configuration to enable spool commands to be issued from other computers), and the SNAP-IX software must be started on that computer. Consult your System Administrator if necessary, or refer to the SNAP-IX Administration Guide for information about RJE workstation configuration or about starting the SNAP-IX software.
The RJE workstation need not be running when this command is issued; the file is simply added to the spool. When the workstation is run at some later time, it will send the job to the host for processing.
You can also start the workstation at the same time you submit the job; see Options. Note, however, that this does not guarantee immediate sending of this job, because other jobs already spooled for this workstation are processed first.
The syntax for the snajobsub command is:
snajobsub [ -e ] [ -mn ] [ -i | -b ] [ -t n ] [ -r [ -sn ] ] wkst [jobfile]
You can use the following options with the snajobsub command:
Indicates that the job file should be sent as exchange data. If this option is not used, the job file is sent as punch data. See Record Lengths and Exchange Data, for more information.
Indicates that the job file should be sent in records of n bytes (in the range 80-248). If this option is not used, the default record length is 80 bytes for punch data (without the option) or 128 bytes for exchange data (with the option). See Record Lengths and Exchange Data, for more information.
Indicates that the command should ignore embedded commands. SNAP-IX normally searches the supplied job files for embedded ~include commands, which specify a data file to be included within the job file, and lines beginning with the characters ~/, which indicate comment lines. You can override this search by using the option; this can be useful if you want to send the text of an RJE job file to the host as text, leaving the embedded commands in the text. See Contents of a Job File, for more information about embedded commands.
Indicates that SNAP-IX should treat the job file as a binary file. Without this option, the file is assumed to be in ASCII format, and therefore, SNAP-IX translates it to EBCDIC. The option overrides the code conversion, and sends the file as submitted. Note that binary files are not searched for embedded commands.
Indicates that the workstation should attempt to send a job to the host a maximum of n times if it encounters an error, where n is a decimal number from 0-99. The default value of n is 10.
Starts the RJE workstation, if it is not already running, after submitting the job.
Valid only if the option is also specified. The combination of and n is equivalent to the command snarjewks -sn wkst, which specifies that the workstation should start, complete all outstanding jobs, and then time out after n minutes with no RJE activity. See Starting the RJE Workstation, for more information.
You can use the following parameters with the snajobsub command:
The name of the RJE workstation that will process the job. This must be the name of an RJE Workstation in the SNAP-IX configuration file, whether or not the named workstation is currently running.
The file containing the instructions to be sent to the host, including a full path if the file is not in the current directory. The maximum length of the path and filename is 255 characters. This file may contain all the required data, or may use the ~include command to specify further data files to be included. See Contents of a Job File, for more information about the format of job files. If you do not specify a filename, standard input is used.
The format of the snajobsub command returned messages is:
Job spooled as spool-id
The spool-id variable is an identifier for this job; it appears in listings produced by the snajoblst command and is used to identify the job to be canceled when using the snajobcan command. See Listing the Submitted Jobs, and Canceling a Job, for more information about these commands.
Other messages can be sent to standard error, indicating (for instance) the following:
Invalid option was supplied
Invalid job file name was supplied
Invalid workstation name was supplied
Parameter in the workstation style file was invalid
Maximum number of jobs on the spool has already been reached.
If you used the option to start the workstation, you may get a message indicating that the workstation could not be started and giving the reasons for this. However, the job may still be spooled successfully; check for the Job spooled as spool-id message.
|
|
|
 |
|