.enable substitution
.;  change the following line to reflect the UIC
.;  for your site's utility task files
.sets outuic "[2,54]"
f77 batch=batch/notr
.open batchbld.cmd
.enable data
;	comment out the next line if the F77 OTS is contained in SYSLIB
lb:'outuic'batch/fp/-cp=batch,lb:[1,1]f4pots/lb:$short,f4pots/lb
;	uncomment the next line if the F77 OTS is contained in SYSLIB
;lb:'outuic'batch/fp/-cp=batch,lb:[1,1]syslib/lb:$short
/
units=3
actfil=3
asg=ti:2
task=...BAT
uic=[1,1]
;	comment out the next line if your system
;	does not include a resident FCS library
libr=fcsres:ro
.disable data
.close
tkb @batchbld
pip batch.obj;*/de,batchbld.cmd;*
.testfile lb:[1,2]batch.hlp
.if <filerr> eq 1 .exit
.disable substitution
.open lb:[1,2]batch.hlp
.enable data
 The BATch command controls the BATCH job processor and BATCH Job Queue,
 allowing users to have indirect command files executed unattended from a
 system BATCH output terminal at a user-specified time of day, rather than
 from the user's own terminal.
 Further HELP is available for COMMANDS, EXAMPLES, STATUS, and CONTROL.

2 COMMANDS
BAT /LI		(lists all BATCH job command files in queue)

BAT /DE:nn	(requests deletion from the BATCH queue of the job with queue
			entry number 'nn'.  Non-priviliged users may only
			delete jobs queued from their UIC).

BAT /KIL	(aborts the currently active job - nonpriviliged users may only
			abort jobs queued from their UIC). 

BAT ggg/mmm/paswrd commandfilespec/timespec[/DEL][/PRI=nn]
	'ggg/mmm/paswrd' specifies the account to log on to to run the job;
	'commandfilespec'   is the name of an indirect command file (a file
		 containing any legal MCR command(s), and/or indirect command
		 file processor directives).  The default extension is ".CMD"
	'timespec' can be:"hh:mm" for the time of day to execute the job, or
				"IM" to execute the BATCH job file immediately
	/DEL (optional) requests automatic deletion of the commandfile after
				successful execution.
	/PRI=nn ,where 'nn' is a number from 1 to 250, requests execution of
				the BATCH job file at other than the default
				priority of 40.  Non-priviliged users may only
				request execution at a priority of 50 or lower.
2 EXAMPLES
	Examples of use of the BATch command:
  BAT /LI			- lists all command files queued for execution

  BAT /DEL:15		- requests removal of the job with BATCH queue entry 15
				  
  BAT 123/472/DOODAH DOITALL.JOB/14:30		- requests execution of the
			file DOITALL.JOB from the user's account at 2:30pm
			after logging the BATCH log terminal on with
			"HELLO 123/472/DOODAH<cr>"  (the account to log on to
			is [123,472], and the account's password is "DOODAH"

  BAT 23/6/XYZ SY:[105,10]BATCHJOB./2:00/DEL	- requests execution of the
			file BATCHJOB. in account [105,10] on device SY: at
			2:00am after logging on with "HELLO 23/6/XYZ<cr>"
			After the job executes successfully, the disk file
			BATCHJOB. will be deleted

  BAT 106/16/ MYJOB/IM	- requests execution immediately of the file
			  MYJOB.CMD after logging on with
			  "HELLO 106/16/<cr>"   (password is a carraige return)

  BAT 14/106/NWM BJOB/IM/PRI=45   - requests immediate execution of the file
			  BJOB.CMD.  Any queued jobs with a priority higher
			  than 45 will be allowed to execute first.
2 STATUS
 The possible job status shown by the BAT/LI command are:
	Future - job queued for execution at a later time.
	Active - the currently executing job.  A job is marked Active only
		 after the BATCH output terminal is logged on.
	Pending - a job waiting for a currently Active job to complete before
		 it can execute.
	Crashed - a job which was executing when the BATCH Queue Manager task
		 was abnormally aborted, as in a system crash.  The job marked
		 Crashed is not restarted when the BATCH processor is restarted,
		 as it may have been aborted at an indeterminate state.
	Timed out - a job which was aborted by the BATCH system after the
		 pre-configured job time limit interval expired.
	Killed - a job which was aborted by the BATCH Queue Manager task in
		 response to either a BAT/KILL or BAT/STOP:IM request.
2 CONTROL
	The priviliged system manager commands for the BATch command are:

  BAT/STArt - starts the BATCH Queue Manager task.

  BAT/STOp - cause the BATCH Queue Manager to exit after completing any
		currently active job.
  BAT/STOp:IM - cause the BATCH Queue Manager to exit after aborting 
		any currently active job.

  BAT/ENAble[/TERM=TTnn:] - enables execution of queued BATCH jobs.  The
		terminal specification is optional.  If included, the specified
		terminal will be used as the BATCH log terminal for execution
		of BATCH jobs.  If omitted, it will default to either the
		terminal last ENAbled, or to TT0: if no ENAble command has
		specified a terminal since the BATCH Queue Manager was STArted.

  BAT/DISable - disables processing of pending queued jobs after any currently
		executing job finishes.  Jobs may still be queued, removed from
		the BATCH queue, and listed.
  BAT/DISable:IM - aborts any active job and disables processing of any other
		pending jobs.  Jobs may still be queued, removed from the
		BATCH queue, and listed.
.DISABLE DATA
.CLOSE
PIP LB:[1,2]BATCH.HLP/PR/WO:R
;
; A help file for the BATch command has been placed in account LB:[1,2].
; You should add the lines
;
;	1 BATCH
;	@BATCH
;
; to the file LB:[1,2]HELP.HLP (RSX11M v4.0) or 
;	      LB:[1,2]MCR.HLP and LB:[1,2]DCL.HLP (RSX11M v4.1),
; and the BATCH command to the list in LB:[1,2]HELPMAI.HLP (RSX11M v4.0) or
;	      LB:[1,2]MCR.HLP and LB:[1,2]DCL.HLP (RSX11M v4.1).
;
