Use FileSubmit to submit a file for processing by the host operating system.
FileSubmit may also be entered as FileSub[mit], SubmitFile, SubFile, or Sub[mit].
FileSubmit is supported for BIM and PDS files only. It is not supported for workstation or VSE files.
Optional Operands
FILE is the BIM or PDS file to be submitted for processing. FILE can also be $Stack to submit the contents of the clipboard or / to submit the current session.
Default: last referenced file.
CLASS [Relevant only for VSE hosts.] is the job class.
DISP [Relevant only for VSE hosts.] is the job disposition.
USER [Relevant only for VSE hosts.] is the job user information.
LSTCLASS [Relevant only for VSE hosts.] the class assigned to the list output.
LSTDISP [Relevant only for VSE hosts.] is the disposition assigned to the list output.
PUNCLASS [Relevant only for VSE hosts.] is the class assigned to the punch output.
PUNDISP [Relevant only for VSE hosts.] is the disposition assigned to the punch output.
FileSubmit is often called through the FileProcess command, which in turn is invoked from either the command line or the ContextProcess command. Submitting the current session is useful to process temporary modifications to standard files. Simply 'SessionClose nosave' after the FileSubmit. You may abort a long submit by pressing Ctrl-Break.
For VSE hosts, the operands CLASS, DISP, USER, LSTCLASS, LSTDISP, PUNCLASS, and PUNDISP are relevant only where the file being submitted does not begin with a POWER JOB line. Defaults for these operands are determined in the host Submit procedure (BIPSUBM), and are usually unique to a BIM-EDIT site.
FileSubmit sets the last referenced file. The above information describes the functional operation of FileSubmit as distributed with BIM-EDIT. FileSubmit is often modified for a particular site's needs. Check with your System Administrator regarding the operation of FileSubmit at your site.
When Valid
The user must have LIST access level for the FILE directory. FILE must not be currently undergoing editing. Check with your System Administrator to determine any other restrictions on FileSubmit at your site.
Return Codes
OK Successful.
AT Command interrupted by Ctrl-Break.
ED File is being edited.
NF File not found.
SC Inadequate access level.
Procedure Notes
FileSubmit sets the TXM variables to the attributes of FILE. On the host, FileSubmit is implemented as the system procedure BIPSUBM.
Examples
Submit the BIM file OMJBKPG:
=> sub omjbkpg