.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 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" (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" 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/" (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). ;