1 EXPORT

		    The EXPORT Command


The EXPORT command is similar to the SUBMIT command with the
following differences:

  1. After the job is submitted, EXPORT waits until the job
     finishes.  If the job ends with a non-successful status
     code, EXPORT displays the message for the code.

  2. There is a /STATUS=symbol qualifier you can use to put
     the submitted job's final status into a DCL symbol for
     later testing.

  3. If you supply no 'file-spec', EXPORT builds the command
     procedure from the following lines of SYS$INPUT.  The pro-
     cedure file is deleted after the job(s) have run.  In the
     procedure file:

	If column 1 of a line contains an underscore, the under-
	score is removed.  This helps prevent problems with
	dollar signs in column 1.

	If column 1 of a line contains a tilde ( ~ ), the tilde
	is removed, and any DCL symbols in the line are substi-
	tuted for in the context of the EXPORTing process.
	     
	Example:  $ EXPORT /QUEUE=FASTBATCH /NOLOG /STATUS=JST
		  ~$ ANALYZE/DISK 'p1'
		  _$ EXIT
		  $ IF .NOT. JST THEN . . .

  4. You are required to either:
	(a) supply a queue name using the /QUEUE qualifier, or
	(b) use the /CLUSTER qualifier (see below).

  5. You can only use the following SUBMIT qualifiers:

	/QUEUE		/[NO]LOG_FILE		/[NO]PRINTER
	/PARAMETERS	/USER			/[NO]KEEP
	/NAME		/DELETE

     You cannot use /DELETE with the /CLUSTER or /COPIES qualifiers
     (discussed below).

  6. You cannot submit a list of files.

You can use the /COPIES=n qualifier to submit multiple copies
(up to 16) of a job to the same queue.  The P8 parameter in
each job will be the ordinal of the job ("1", "2", etc.).
If the /STATUS qualifier is used, one DCL symbol is defined
for each job submitted; the job ordinal is appended to the
end of the specified symbol name.  For example:

		$ EXPORT XXX /COPIES=2 /STATUS=AZ

Would create DCL symbols AZ_1 and AZ_2.

You can use the /CLUSTER qualifier to submit a batch job to
all accessible cluster nodes except the originating node.
The /QUEUE and /COPIES qualifiers must not be used.  If the
/STATUS qualifier is used, one DCL symbol is defined for each
node submitted to; the node name is appended to the end of
the specified symbol name.  For example:

		$ EXPORT ZZZ /CLUSTER /STATUS=AZ

would create DCL symbols AZ_HUEY, AZ_DEWEY, AZ_LOUIE.

How does EXPORT know what node names and queue names to use with
the /CLUSTER option?  See EXPORT.CLD for details.

If you use the /CLUSTER or /COPIES qualifiers, an additional DCL
symbol, EXPORT_STATUS, is created.  It contains the value of the
worst severity of any of the batch jobs' final statuses.

RESTRICTION:  EXPORT queues one AST for each batch process, so
	      use of /CLUSTER or /COPIES could use up ASTLM if
	      set too low; 24 seems to be fine.

