home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / bmdemov3.zip / BMFILES.ZIP / CC1706.HLP (.txt) < prev    next >
OS/2 Help File  |  1995-09-12  |  34KB  |  994 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Help for Batch Manager version 3.0 ΓòÉΓòÉΓòÉ
  3.  
  4. The purpose of "BATCH MANAGER" is to provide a vehicle to submit, monitor, and 
  5. control jobs (OS/2 and DOS command files and executables) under the IBM OS/2 
  6. operating system.  Three job queues are provided and the user can control the 
  7. status of these queues.  This product is patterned after other OS/2 products 
  8. and is designed to be SAA/CUA compliant. 
  9.  
  10. "BATCH MANAGER" is translatable.  Consult the vendor for details. 
  11.  
  12. The sub-system provides the following functions: 
  13.  
  14.      Submission and execution of jobs, either immediately or delayed to a 
  15.       later time/date.  The jobs can be submitted either from this user 
  16.       interface, from the OS/2 command line using the BMSUBMIT facility 
  17.       provided by this sub-system or by using the OS/2 "drag and drop" facility 
  18.       to drop a job(s) (.CMD, .BAT or .EXE) upon the Monitor.  Jobs can be 
  19.       submitted for either a single or recurring execution. 
  20.  
  21.      Control over the status of the queues which are responsible for 
  22.       controlling jobs. 
  23.  
  24.      Control over the status of the jobs, such as cancel, hold, release, 
  25.       change queue, change priority, etc. 
  26.  
  27.  When "BATCH MANAGER" is started, two programs will be visible either on the 
  28.  desktop or in the minimized window viewer: 
  29.  
  30.      Batch Manager Monitor - The graphical user interface which allows the 
  31.       user to control the actions of the Batch Manager, including submitting 
  32.       and updating jobs, cancelling, requeuing, etc. 
  33.  
  34.      Batch Manager Scheduler - The program which actually manages the queues 
  35.       and jobs.  Users communicate with the scheduler either by using the 
  36.       monitor or the Command Line Interface. 
  37.  
  38.      Command Line Interface 
  39.  
  40.  The BM Scheduler must be started as a foreground session using BMSTART2.CMD in 
  41.  order to process applications with screen/keyboard I/O.  (This is the default 
  42.  startup procedure after "BATCH MANAGER" is installed.) 
  43.  
  44.  To run the scheduler as a detached process use BMSTART.CMD  In this case jobs 
  45.  submitted to "BATCH MANAGER" cannot have any screen/keyboard I/O capability, 
  46.  and the scheduler will not be visible on the desktop. 
  47.  
  48.  In either case the full path to the directory where "BATCH MANAGER" is 
  49.  installed must be provided as a parameter, e.g.: BMSTART2.CMD C:\MBABATCH 
  50.  
  51.  A journal of all "BATCH MANAGER" activity is maintained in BMJOB.LOG in the 
  52.  "BATCH MANAGER" work directory (e.g., C:\MBABATCH).  The log can be viewed 
  53.  from the Options Action Bar Choice.  It is the users responsibility to clear 
  54.  this file on a regular basis.  The log file is copied to a back-up version of 
  55.  the file (BMJOB.BAK) whenever "BATCH MANAGER" is initiated. 
  56.  
  57.  A queue file is maintained by the "BATCH MANAGER" Scheduler for each of the 
  58.  three job queues (BMQUEUE1.DAT, BMQUEUE2.DAT, and BMQUEUE3.DAT). These files 
  59.  are read by the Scheduler at startup in order to restore the queues to the 
  60.  status existing when "BATCH MANAGER" was closed.  In the event that a hardware 
  61.  or software problem causes "BATCH MANAGER" to terminate while a job(s) is 
  62.  active it may be necessary to delete these files before restarting "BATCH 
  63.  MANAGER".  This action is usually required if the user has the following entry 
  64.  in the 'CONFIG.SYS' file: 
  65.  
  66.    SET RESTARTOBJECTS=STARTUPFOLDERSONLY
  67.  
  68.  The product is licensed for use on a single OS/2 computer.  For full terms of 
  69.  licensing, consult the license agreement accompanying the product package. 
  70.  Address any other questions, including pricing, to the vendor (see "About..." 
  71.  under the HELP action-bar-choice. 
  72.  
  73.  This facility is typically executed at each computer and the jobs controlled 
  74.  by the individual user.  The installation process adds "BATCH MANAGER" startup 
  75.  details to the 'STARTUP.CMD' file so that "BATCH MANAGER" is initiated when 
  76.  the user boots the computer.  If "BATCH MANAGER" is terminated for any reason 
  77.  it can be restarted using either of the commands detailed previously. 
  78.  
  79.  The BM Monitor, which is the Graphical User Interface (GUI) for the facility, 
  80.  is a window programmed around OS/2's "Presentation Manager."  The window 
  81.  consists of the following action bar choices: 
  82.  
  83.      QUEUE - Provides the means to control the status of the queues. 
  84.  
  85.      JOB - Provides the means to control the actions of the job(s), including 
  86.       submitting and updating jobs, cancelling, requeuing, etc. 
  87.  
  88.      OPTIONS - Provides the means to display the Job Execution Log and 
  89.       suppress the end of job execution display and/or beep. 
  90.  
  91.      HELP - Provides guidance throughout facility.  Pertinent pop-up windows 
  92.       are invoked as required to guide the user through the selected action. 
  93.  
  94.  The main window displays the job queues, along with the jobs submitted to each 
  95.  queue.  Each job is listed by Job Id, Job Name (as submitted by the user), 
  96.  scheduled Start Date, scheduled/actual Start Time, Job Status (Active, 
  97.  Pending, Holding, Delayed).  A code is also displayed indicating whether the 
  98.  batch job is Single or Recurring (repetitive). 
  99.  
  100.  The "BATCH MANAGER" queues are refreshed automatically whenever activity 
  101.  occurs.  Because of this, the screen is always current. 
  102.  
  103.  JOB FILES 
  104.  
  105.  To submit a job, the user must submit a user specified job file (.CMD, .BAT or 
  106.  .EXE).  This file must exist prior to job submission and must contain the full 
  107.  file\directory path name (no default directories are assumed) for any file 
  108.  specified in this command file.  The 'EXIT' statement in a .CMD file may cause 
  109.  a return error message from OS/2 at the end of the job execution even though 
  110.  the the job is actually executed successfully. 
  111.  
  112.  SUBMITTING JOBS FROM OS/2 COMMAND LINE 
  113.  
  114.  The Command Line Interface is provided as an alternative for users to manage 
  115.  jobs and queues without interacting with the Graphical User Interface.  This 
  116.  is primarily used to enable job submission from an external source (e.g., 
  117.  another user application or command procedure). 
  118.  
  119.      Command Line Interface 
  120.      BMSUBMIT - submit new jobs 
  121.      BMCHSTAT - change job status 
  122.      BMJOB - get job status 
  123.      BMLIST - list all jobs 
  124.      BMGETQ - get the current status of queues 
  125.      BMCHQ - change queue status 
  126.      BMTERM - terminate the Scheduler 
  127.      TERMPID - terminate a process 
  128.  
  129.  JOB COMPLETION 
  130.  
  131.  Upon completion of the batch job, a beep is sounded and a dialog box is 
  132.  displayed notifying the user whether or not the batch job was successfully 
  133.  executed.  The user can remove the dialog by pressing the Ok button or the 
  134.  dialog will remove itself after 60 seconds.  The user can suppress the beep 
  135.  and/or the dialog from the Options Action Bar Choice. 
  136.  
  137.  A journal of all job completion messages is maintained in BMJOB.LOG in the 
  138.  "BATCH MANAGER" work directory (e.g., C:\MBABATCH).  The log can be viewed 
  139.  from the Options Action Bar Choice.  It is the users responsibility to clear 
  140.  this file on a regular basis. 
  141.  
  142.  MESSAGES 
  143.  
  144.  When a job is completed, a variety of messages may appear in the BMJOB.LOG) to 
  145.  indicate completion status; either ERROR or NO ERRORS.  Some OS/2 Termination 
  146.  and Return Codes may also be displayed.  Consult IBM OS/2 documentation for 
  147.  their meaning (e.g., "OS/2 Control Program Programming Reference"). 
  148.  
  149.  SHUTDOWN 
  150.  
  151.  If a batch job is ACTIVE in the job queue, the user will be unable to close 
  152.  the "BATCH MANAGER" Monitor and Scheduler.  Should the computer SHUTDOWN 
  153.  (either through the OS/2 Desktop or power failure, the active batch job will 
  154.  abort execution). 
  155.  
  156.  COMPUTER CLOCK 
  157.  
  158.  Execution of "BATCH MANAGER" is based on the computer's clock.  Should the you 
  159.  wish to change the settings on the clock, the user is advised to first HOLD 
  160.  the queues before changing the clock.  After the clock has been changed, the 
  161.  user can then RELEASE the queues. 
  162.  
  163.  Note:  It may be necessary to UPDATE the time settings for the various jobs in 
  164.         the queues.  Use the UPDATE/REQUEUE JOB window to update the time/date 
  165.         settings of each job before RELEASING the queues. 
  166.  
  167.  TRADEMARK ACKNOWLEDGEMENTS 
  168.  
  169.  IBM, OS/2, SAA, CUA are registered trademarks of the International Business 
  170.  Machines Corporation. 
  171.  
  172.  
  173. ΓòÉΓòÉΓòÉ 2. Help for Queue ABC ΓòÉΓòÉΓòÉ
  174.  
  175. Use the Queue action-bar-choice (ABC) to manage the queues. 
  176.  
  177. The pull-down-choices for individual queues are available only after you have 
  178. selected a queue.  (If you are using a mouse, click on the queue to select it. 
  179. If you are using a keyboard, press the Up or Down Arrow key and ENTER to select 
  180. it.)  The following pull-down-choices are provided: 
  181.  
  182.      Hold queue 
  183.      Release queue 
  184.      Hold all queues 
  185.      Release all queues 
  186.  
  187.  
  188. ΓòÉΓòÉΓòÉ 3. Help for Hold Queue PDC ΓòÉΓòÉΓòÉ
  189.  
  190. Use the Hold Queue pull-down-choice (PDC) to change the status of the selected 
  191. queue so none of the jobs in it can be executed.  This choice is not valid if 
  192. the queue is already being held. 
  193.  
  194. Holding a queue when a job is executing (ACTIVE) does not stop the job. The job 
  195. is allowed to finish, but the next job in the queue cannot start. 
  196.  
  197. Use Release queue to allow the jobs in the queue to execute. 
  198.  
  199.  
  200. ΓòÉΓòÉΓòÉ 4. Help for Release Queue PDC ΓòÉΓòÉΓòÉ
  201.  
  202. Use the Release Queue pull-down-choice (PDC) to change the status of a queue 
  203. HOLDING so that jobs in it can be executed. This choice is valid only if the 
  204. queue is HOLDING. 
  205.  
  206. Releasing a queue allows the jobs in the queue to be executed. 
  207.  
  208. Use the Job pull-down-choices if you want to change the order jobs are 
  209. executed. 
  210.  
  211.  
  212. ΓòÉΓòÉΓòÉ 5. Help for Hold all Queues PDC ΓòÉΓòÉΓòÉ
  213.  
  214. Use the Hold All Queues pull-down-choice (PDC) to change the status of the all 
  215. queues so no jobs can be executed.  This choice is not valid if all the queues 
  216. are already being held. 
  217.  
  218. Holding a queue when a job is executing (ACTIVE) does not stop the job. The job 
  219. is allowed to finish, but the next job in the queue cannot start. 
  220.  
  221. Use Release all queues to allow the jobs in all the queues to execute. 
  222.  
  223.  
  224. ΓòÉΓòÉΓòÉ 6. Help for Release all Queues PDC ΓòÉΓòÉΓòÉ
  225.  
  226. Use the Release All Queues pull-down-choice (PDC) to change the status of all 
  227. queues HOLDING so jobs can be executed. This choice is only valid if any queues 
  228. are HOLDING. 
  229.  
  230. Releasing a queue allows the jobs in the queue to be executed. 
  231.  
  232. Use the Job pull-down-choices if you want to change the order jobs are 
  233. executed. 
  234.  
  235.  
  236. ΓòÉΓòÉΓòÉ 7. Help for Hold all Jobs PDC ΓòÉΓòÉΓòÉ
  237.  
  238. Use the Hold all Jobs pull-down-choice (PDC) to change the status of the jobs 
  239. in all the queues.  All the jobs are held so they cannot be executed. 
  240.  
  241. Jobs submitted after this will not be held. 
  242.  
  243. If the jobs are already HOLDING, this choice has no effect. 
  244.  
  245. Active jobs will continue executing. 
  246.  
  247.  
  248. ΓòÉΓòÉΓòÉ 8. Help for Release all Jobs PDC ΓòÉΓòÉΓòÉ
  249.  
  250. Use the Release all Jobs pull-down-choice (PDC) to change the status of any 
  251. jobs HOLDING in all queues.  All the held jobs are released so they can be 
  252. executed. 
  253.  
  254. If there are no jobs HOLDING, this choice has no effect. 
  255.  
  256.  
  257. ΓòÉΓòÉΓòÉ 9. Help for Cancel all Jobs PDC ΓòÉΓòÉΓòÉ
  258.  
  259. Use the Cancel all Jobs pull-down-choice (PDC) to remove all the jobs from all 
  260. the queues. 
  261.  
  262. When you select this choice, a message is displayed asking you to confirm 
  263. cancellation of the jobs. 
  264.  
  265. You cannot recover canceled jobs.  You have to submit the jobs again if you 
  266. want to execute them. 
  267.  
  268. Note:  This cancels ALL jobs including active jobs.
  269.  
  270.  
  271. ΓòÉΓòÉΓòÉ 10. Help for Job ABC ΓòÉΓòÉΓòÉ
  272.  
  273. The Job action-bar-choice (ABC) is used to control the action of job(s). 
  274.  
  275. A job identification number is created when you submit a batch job to the queue 
  276. (whether ACTIVE, PENDING, DELAYED, or HOLDING). 
  277.  
  278. Use the following pull-down-choices (PDC) to control the execution of a job. 
  279. These choices (except Submit new job) are available only after you have 
  280. selected a job.  (If you are using a mouse, click on the job or queue to select 
  281. it.  If you are using a keyboard, press the Up or Down Arrow keys to select 
  282. it.) 
  283.  
  284.      Submit new job 
  285.      Update/requeue job 
  286.      Job details 
  287.      Hold job 
  288.      Release job 
  289.      Cancel job 
  290.      Hold all jobs 
  291.      Release all jobs 
  292.      Cancel all jobs 
  293.  
  294.  
  295. ΓòÉΓòÉΓòÉ 11. Help for Job Details PDC ΓòÉΓòÉΓòÉ
  296.  
  297. Use the Job Details pull-down-choice (PDC) to display the details of the 
  298. selected job. 
  299.  
  300.  
  301. ΓòÉΓòÉΓòÉ 12. Help for Cancel Job PDC ΓòÉΓòÉΓòÉ
  302.  
  303. Use the Cancel Job pull-down-choice (PDC) to remove the selected job from the 
  304. queue.  If the job is executing, it is stopped. 
  305.  
  306. Note:  Cancelling a recurring job will cancel all future executions of this 
  307.        job.  To restart a recurring job, the user will have to use the SUBMIT 
  308.        PDC and reset the parameters.
  309.  
  310.  When you select this choice, a message is displayed, asking you to confirm 
  311.  cancelling the job. 
  312.  
  313.  
  314. ΓòÉΓòÉΓòÉ 13. Help for Hold Job PDC ΓòÉΓòÉΓòÉ
  315.  
  316. Use the Hold Job pull-down-choice (PDC) to change the status of the selected 
  317. job so it does not execute.  If the job is executing when you hold it, this 
  318. choice has no effect. 
  319.  
  320. Holding one job does not affect the other jobs in the queue; they are executed 
  321. as usual.  Use RELEASE when you want to allow the job to execute. 
  322.  
  323.  
  324. ΓòÉΓòÉΓòÉ 14. Help for Release Job PDC ΓòÉΓòÉΓòÉ
  325.  
  326. Use the Release Job pull-down-choice (PDC) to change the status of the selected 
  327. job so it can be executed. 
  328.  
  329.  
  330. ΓòÉΓòÉΓòÉ 15. Help for Submit new Job PDC ΓòÉΓòÉΓòÉ
  331.  
  332. Use the Submit new Job pull-down-choice (PDC) to invoke a pop-up window to 
  333. initiate a new job. 
  334.  
  335. Note:  This will be the same window as used under the Update/requeue job pull-down-choice.
  336.  
  337.  
  338. ΓòÉΓòÉΓòÉ 16. Help for Update/Requeue Job PDC ΓòÉΓòÉΓòÉ
  339.  
  340. Use the Update/Requeue Job pull-down-choice (PDC) to invoke a pop-up window to 
  341. change the variables associated with a job and/or to requeue the job. 
  342.  
  343. Note:  This will be the same window as used under the Submit new Job pull-down-choice.
  344.  
  345.  
  346. ΓòÉΓòÉΓòÉ 17. Help for Options ABC ΓòÉΓòÉΓòÉ
  347.  
  348. The Options action-bar-choice (ABC) is used to access the "BATCH MANAGER" 
  349. Options. 
  350.  
  351. Use the following pull-down-choices (PDC) to select the desired option: 
  352.  
  353.      Display job log 
  354.      Job end options 
  355.  
  356.  
  357. ΓòÉΓòÉΓòÉ 18. Help for Display Job Log PDC ΓòÉΓòÉΓòÉ
  358.  
  359. Use the Display Job Log pull-down-choice (PDC) to display the log of all 
  360. activity since the log was last cleared.  Use the Clear pushbutton to clear the 
  361. current job log file. 
  362.  
  363.  
  364. ΓòÉΓòÉΓòÉ 19. Help for Job End Options PDC ΓòÉΓòÉΓòÉ
  365.  
  366. Use the Job End Options pull-down-choice (PDC) to suppress/activate the end of 
  367. job execution display and beep. 
  368.  
  369.  
  370. ΓòÉΓòÉΓòÉ 20. Help for Help ABC ΓòÉΓòÉΓòÉ
  371.  
  372. The Help action-bar-choice (ABC) is used to access the various CUA compliant 
  373. Help facilities. Help index General help Using help Keys help About... 
  374.  
  375.  
  376. ΓòÉΓòÉΓòÉ 21. Help for Using Help PDC ΓòÉΓòÉΓòÉ
  377.  
  378. Use the Using Help pull-down-choice (PDC) to describe all of the available help 
  379. facilities. 
  380.  
  381. In general, help is provided for every action-bar-choice, pull-down choice, and 
  382. other selections. 
  383.  
  384.  
  385. ΓòÉΓòÉΓòÉ 22. Help for General Help PDC ΓòÉΓòÉΓòÉ
  386.  
  387. This pull-down-choice is used to display general help text regarding the use of 
  388. this facility. 
  389.  
  390.  
  391. ΓòÉΓòÉΓòÉ 23. Help for Keys Help PDC ΓòÉΓòÉΓòÉ
  392.  
  393. Use the Keys Help pull-down-choice (PDC) to access the standard help keys.  The 
  394. list of keys is arranged in groups. 
  395.  
  396.      HELP KEYS to get help. 
  397.  
  398.      SYSTEM KEYS to switch between programs. 
  399.  
  400.      WINDOW KEYS to move around in a program window. 
  401.  
  402.      POP-UP WINDOW KEYS to make a selection in a pop-up window. 
  403.  
  404.      EDITING KEYS to make changes in a pop-up window. 
  405.  
  406.  When two key names are joined by a plus sign (+), use these two keys together. 
  407.  Hold down the first key and press the second key. 
  408.  
  409.  HELP KEYS 
  410.  
  411.  F1 
  412.       Get help. 
  413.  
  414.  F11 
  415.       Go to the help index (from within any help window). 
  416.  
  417.  Esc 
  418.       Cancel help. 
  419.  
  420.  Alt+F4 
  421.       Close the help window. 
  422.  
  423.  Alt+F6 
  424.       Go to/from help and programs. 
  425.  
  426.  Shift+F10 
  427.       Get help for help. 
  428.  
  429.  SYSTEM KEYS 
  430.  
  431.  Alt+Esc 
  432.       Switch to the next program, including full-screen programs. 
  433.  
  434.  Alt+Tab 
  435.       Switch to the next windowed program. 
  436.  
  437.  Ctrl+Esc 
  438.       Switch to the Task List. 
  439.  
  440.  WINDOW KEYS 
  441.  
  442.  F3 
  443.       Close a program window. 
  444.  
  445.  F10 
  446.       Go to/from the action bar. 
  447.  
  448.  Arrow keys 
  449.       Move among choices. 
  450.  
  451.  End 
  452.       Go to the last choice in a pull-down. 
  453.  
  454.  Esc 
  455.       Cancel a pull-down or the system menu. 
  456.  
  457.  Home 
  458.       Go to the first choice in a pull-down. 
  459.  
  460.  PgUp 
  461.       Scroll the contents of the window up one page. 
  462.  
  463.  PgDn 
  464.       Scroll the contents of the window down one page. 
  465.  
  466.  Underlined letter 
  467.       Move among the choices on the action bar and pull-downs. 
  468.  
  469.  Alt 
  470.       Go to/from the action bar. 
  471.  
  472.  Alt+F4 
  473.       Close the window. 
  474.  
  475.  Alt+F5 
  476.       Restore the window. 
  477.  
  478.  Alt+F7 
  479.       Move the window. 
  480.  
  481.  Alt+F8 
  482.       Size the window. 
  483.  
  484.  Alt+F9 
  485.       Minimize the window. 
  486.  
  487.  Alt+F10 
  488.       Maximize the window. 
  489.  
  490.  Ctrl+PgDn 
  491.       Scroll the contents of the window right one page. 
  492.  
  493.  Ctrl+PgUp 
  494.       Scroll the contents of the window left one page. 
  495.  
  496.  Shift+Esc or Alt+Spacebar 
  497.       Go to/from the system menu. 
  498.  
  499.  Shift+Esc or Alt 
  500.       Go to/from the system menu of a text window. 
  501.  
  502.  POP-UP WINDOW KEYS 
  503.  
  504.  Enter 
  505.       Complete the pop-up window. 
  506.  
  507.  Esc 
  508.       Cancel the pop-up window. 
  509.  
  510.  Spacebar 
  511.       Set a check box on/off or perform the task described on the selected 
  512.       pushbutton. 
  513.  
  514.  Tab 
  515.       Move to the next entry field or check box. 
  516.  
  517.  EDITING KEYS 
  518.  
  519.  Backspace (left arrow delete) 
  520.       Delete the character to the left of the cursor. 
  521.  
  522.  Del 
  523.       Delete the character to the right of the cursor. 
  524.  
  525.  End or Ctrl+Right Arrow key 
  526.       Move to the end of a field. 
  527.  
  528.  Home or Ctrl+Left Arrow key 
  529.       Move to the beginning of a field. 
  530.  
  531.  
  532. ΓòÉΓòÉΓòÉ 24. Help for Help Index PDC ΓòÉΓòÉΓòÉ
  533.  
  534. This pull-down-choice is used to display the Help Index.  The help index lists 
  535. all of the titles of the available help information. 
  536.  
  537.  
  538. ΓòÉΓòÉΓòÉ 25. Help for About the Vendor PDC ΓòÉΓòÉΓòÉ
  539.  
  540. Use the About the Vendor pull-down-choice (PDC) to access the name and address 
  541. of the vendor. 
  542.  
  543.  
  544. ΓòÉΓòÉΓòÉ 26. Help for Job Details ΓòÉΓòÉΓòÉ
  545.  
  546. This panel displays the following job details: 
  547.  
  548.      The Job Identification number. 
  549.  
  550.      The Job Name (as assigned by the user). 
  551.  
  552.      The Joe Queue - The queue controlling the job. 
  553.  
  554.      The Job Priority - The job execution priority. 
  555.  
  556.      The Start Date - either scheduled or actual. 
  557.  
  558.      The Start Time - either scheduled or actual. 
  559.  
  560.      The status of the job (ACTIVE, PENDING, DELAYED, or HOLDING). 
  561.  
  562.      The Single/Recurring indicator.  A job may be submitted to execute either 
  563.       once (single) or repetitively (recurring). 
  564.  
  565.      The Recurring Period - if applicable. 
  566.  
  567.      The Elapsed Time - if the job is active. 
  568.  
  569.      The name of the command file (.CMD, .BAT or .EXE) used to execute the 
  570.       job. 
  571.  
  572.  Press OK to exit the panel. 
  573.  
  574.  
  575. ΓòÉΓòÉΓòÉ 27. Help for Job Termination Details ΓòÉΓòÉΓòÉ
  576.  
  577. This panel appears when a job is terminated.  It displays the following 
  578. details: 
  579.  
  580.      The Queue Name 
  581.  
  582.      The Job Identification number. 
  583.  
  584.      The Job Name (as assigned by the user). 
  585.  
  586.      An End of job message This advises whether the job completed with errors 
  587.       or not. 
  588.  Press OK to close the panel.  It will remove itself after 60 seconds if no 
  589.  action is taken. 
  590.  
  591.  
  592. ΓòÉΓòÉΓòÉ 28. Help for Submit/Update/Requeue Job ΓòÉΓòÉΓòÉ
  593.  
  594. This panel is used to either submit a new job, update the parameters for an 
  595. existing job, and/or requeue an existing job. 
  596.  
  597. To SUBMIT a new job, the user must enter the following: 
  598.  
  599.      Enter Job Name - enter a user defined name to identify the job.  If this 
  600.       field is left empty, the job file name will be used as the job name. 
  601.  
  602.      Enter Command File Name - Submit the name of a valid OS/2 or DOS command 
  603.       file or EXE to execute the job.  The user can either enter the full 
  604.       directory\path\file name directly in the data field or select from the 
  605.       DIRECTORY and FILE selection lists shown. 
  606.  
  607.       Note:  If an invalid job file is given, an error message will be 
  608.              displayed.  THE JOB FILE MUST PROVIDE FULL DIRECTORY\FILE PATHS; 
  609.              DEFAULTS ARE NOT ASSUMED. 
  610.  
  611.       Note:  The total text length for command file name and optional 
  612.              parameters must not exceed 123 characters. 
  613.  
  614.      The user can specify optional parameters for the job to be executed; 
  615.       e.g., a file name which needs to be passed to the job.  If no parameters 
  616.       are needed, leave this field blank. 
  617.  
  618.      Select the desired queue from the queue selection list. 
  619.  
  620.       Note:  Queue 1 is the default. 
  621.  
  622.      Select the required job priority from the priority selection list. 
  623.  
  624.       Note:  Regular priority is the default. 
  625.  
  626.      Indicate if the job is to be executed SINGLE or RECURRING  Single means 
  627.       one execution of the job; Recurring means to execute the job 
  628.       repetitively. 
  629.  
  630.      For single jobs, enter the starting date and time.  The default is to 
  631.       execute immediately.  The user can override this by submitting a date as 
  632.       YYYYMMDD (Year/Month/Day); for example:  19951211 = December 11, 1995. 
  633.       Time is submitted as HH:MM (Hours/Minutes) using a 24 hour clock; for 
  634.       example; 14:30 = 2:30 pm; 09:00 = 9 am. 
  635.  
  636.      For recurring jobs, the user must select the frequency of the job from 
  637.       the selection list of variables shown, and provide the starting time as 
  638.       HH:MM (Hours/Minutes). 
  639.  
  640.       Note:  The starting date is not specified for a recurring job. 
  641.  
  642.      Multiple recurring jobs with same starting time can be submitted by 
  643.       selecting several recurring periods at one time in the selection list; 
  644.       e.g., Monday, Wednesday, Friday. 
  645.  
  646.  To UPDATE/REQUEUE a job, the current job parameters are displayed on the 
  647.  panel.  The user can change them as required. 
  648.  
  649.  Press OK to confirm selections and execute accordingly.  Press Cancel to quit 
  650.  without saving. 
  651.  
  652.  
  653. ΓòÉΓòÉΓòÉ 29. Help for About the Vendor ΓòÉΓòÉΓòÉ
  654.  
  655. This panel displays the name and address of the vendor. 
  656.  
  657.  
  658. ΓòÉΓòÉΓòÉ 30. Help for Job Log Display ΓòÉΓòÉΓòÉ
  659.  
  660. This panel displays the details of all "BATCH MANAGER" activity that has 
  661. occurred since the log was last cleared.  Use the Clear pushbutton to clear the 
  662. current job log file. 
  663.  
  664. Each entry in the log shows the following information: 
  665.  
  666.  Date and Time 
  667.       Shows the actual date and time the action took place. 
  668.  
  669.  Queue Name 
  670.       The name of the Queue involved in the action. 
  671.  
  672.  Job ID and Name 
  673.       The Job ID and Name if the action involves a job. 
  674.  
  675.  Details 
  676.       A message showing the action taken. 
  677.  
  678.  Portions of the log can be copied to the clipboard for use in user reports by 
  679.  selecting the required details and using the Copy ABC.  Alternatively the log 
  680.  file can be copied and edited by the user. 
  681.  
  682.  
  683. ΓòÉΓòÉΓòÉ 31. Help for About the Vendor Demonstration Version ΓòÉΓòÉΓòÉ
  684.  
  685. This panel displays the name and address of the vendor and identifies a 
  686. demonstration version of the product. 
  687.  
  688.  
  689. ΓòÉΓòÉΓòÉ 32. Help for End of Demonstration ΓòÉΓòÉΓòÉ
  690.  
  691. This panel is displayed when the demonstration version has either passed the 30 
  692. days or 30 jobs have been executed.  It displays the name and address of the 
  693. vendor. 
  694.  
  695.  
  696. ΓòÉΓòÉΓòÉ 33. Help for Job End Options ΓòÉΓòÉΓòÉ
  697.  
  698. This panel is used to display and change the current settings for the end of 
  699. job execution display and beep. 
  700.  
  701.  End of job display and beep 
  702.       Activates a display and beep when a job finishes executing. 
  703.  
  704.  End of job display only 
  705.       Activates a display and no beep when a job finishes executing. 
  706.  
  707.  End of job beep only 
  708.       Activates a beep and no display when a job finishes executing. 
  709.  
  710.  No display or beep 
  711.       Suppress both the display and beep when a job finishes executing. 
  712.  
  713.  Press Ok to confirm selection.  Press Cancel to quit without saving. 
  714.  
  715.  
  716. ΓòÉΓòÉΓòÉ 34. Help for Command Line Interface ΓòÉΓòÉΓòÉ
  717.  
  718.  OS/2 "BATCH MANAGER" provides a series of command line interfaces as an 
  719. alternative way for users to submit/monitor batch jobs and manage the queues 
  720. without interacting with the Graphical User Interface.  The functions are as 
  721. follows: 
  722.  
  723.      BMSUBMIT - submit new jobs 
  724.      BMCHSTAT - change job status 
  725.      BMJOB - get job status 
  726.      BMLIST - list all jobs 
  727.      BMGETQ - get the current status of queues 
  728.      BMCHQ - change queue status 
  729.      BMTERM - terminate the Scheduler 
  730.      TERMPID - terminate a process 
  731.  
  732.  
  733. ΓòÉΓòÉΓòÉ 35. Help for BMSUBMIT - Submit New Job ΓòÉΓòÉΓòÉ
  734.  
  735. The BMSUBMIT.EXE is provided as an alternative for users to submit jobs without 
  736. interacting with the Graphical User Interface.  This is primarily used to 
  737. enable job submission from an external source (e.g., another user application 
  738. or command procedure).  Execute the BMSUBMIT program with the following calling 
  739. format: 
  740.  
  741. Calling Format:  (The arguments in brackets are optional)
  742.  
  743.   BMSUBMIT CMDFile ["JobName"] [/JobStatus] [StartDate StartTime]
  744.            [/SingleRecurring] [/RecurringPeriod]
  745.            [/QueueNumber] [/JobPriority] [+CmdArg]
  746.  
  747.  ARGUMENT                DESCRIPTION 
  748.  --------------------    ------------------------------------------------------ 
  749.  CMDFile                 The command file name with full path 
  750.  JobName                 The name of this job starting with an alphabetical 
  751.                          character (up to 30) 
  752.  JobStatus               /TP (pending is the default), /TD (delayed), /TH 
  753.                          (hold) 
  754.  StartDate StartTime     YYYYMMDD HHMM, the default is current time 
  755.  /SingleRecurring        /S (single is the default), /R (recurring) 
  756.  /RecurringPeriod        /1 (every day),         /2 (every other day) 
  757.                          /3 (every Sunday),       /4 (every Monday) 
  758.                          /5 (every Tuesday),       /6 (every Wednesday) 
  759.                          /7 (every Thursday),      /8 (every Friday) 
  760.                          /9 (every Saturday),      /10 (First Day of Month) 
  761.                          /11 (2nd day of Month),     /12 (3rd Day of Month) 
  762.                          /13 (4th day of Month),     /14 (5th Day of Month) 
  763.                          /15 (6th day of Month),     /16 (7th Day of Month) 
  764.                          /17 (8th day of Month),     /18 (9th Day of Month) 
  765.                          /19 (10th day of Month)     /20 (11th Day of Month) 
  766.                          /21 (12th day of Month)     /22 (13th Day of Month) 
  767.                          /23 (14th day of Month)     /24 (15th Day of Month) 
  768.                          /25 (16th day of Month)     /26 (17th Day of Month) 
  769.                          /27 (18th day of Month)     /28 (19th Day of Month) 
  770.                          /29 (20th day of Month)     /30 (21st Day of Month) 
  771.                          /31 (22nd day of Month)     /32 (23rd Day of Month) 
  772.                          /33 (24th day of Month)     /34 (25th Day of Month) 
  773.                          /35 (26th day of Month)     /36 (27th Day of Month) 
  774.                          /37 (28th day of Month)     /38 (29th Day of Month) 
  775.                          /39 (30th day of Month)     /40 (Last Day of Month) 
  776.  
  777.  
  778. ΓòÉΓòÉΓòÉ 36. Help for BMCHSTAT - Change Job Status ΓòÉΓòÉΓòÉ
  779.  
  780. The BMCHSTAT.EXE allows users to change the status of previously submitted 
  781. batch jobs.  Execute the BMCHSTAT program with the following calling format: 
  782.  
  783. Calling Format:  (The arguments in brackets are optional but at least
  784.          one optional parameter must be specified.)
  785.  
  786.   BMCHSTAT JobId  [/JobStatus] [StartDate StartTime]
  787.            [/SingleRecurring] [/RecurringPeriod]
  788.            [/QueueNumber] [/JobPriority]
  789.  
  790.  ARGUMENT                DESCRIPTION 
  791.  --------------------    ------------------------------------------------------ 
  792.  JobId                   The Job Id 
  793.  
  794.  /JobStatus              The desired job status 
  795.                          /TP (pending, default) 
  796.                          /TD (delayed) 
  797.                          /TH (hold) 
  798.                          /TR (release) 
  799.  
  800.  StartDate StartTime     The required start date and time YYYYMMDD HHMM 
  801.                          (default is current time) 
  802.  
  803.  /SingleRecurring        The job type 
  804.                          /S (Single, default) 
  805.                          /R (Recurring) 
  806.  
  807.  /RecurringPeriod        The Recurring Job Period 
  808.                          /1 (every day),         /2 (every other day) 
  809.                          /3 (every Sunday),       /4 (every Monday) 
  810.                          /5 (every Tuesday),       /6 (every Wednesday) 
  811.                          /7 (every Thursday),      /8 (every Friday) 
  812.                          /9 (every Saturday),      /10 (First Day of Month) 
  813.                          /11 (2nd day of Month),     /12 (3rd Day of Month) 
  814.                          /13 (4th day of Month),     /14 (5th Day of Month) 
  815.                          /15 (6th day of Month),     /16 (7th Day of Month) 
  816.                          /17 (8th day of Month),     /18 (9th Day of Month) 
  817.                          /19 (10th day of Month)     /20 (11th Day of Month) 
  818.                          /21 (12th day of Month)     /22 (13th Day of Month) 
  819.                          /23 (14th day of Month)     /24 (15th Day of Month) 
  820.                          /25 (16th day of Month)     /26 (17th Day of Month) 
  821.                          /27 (18th day of Month)     /28 (19th Day of Month) 
  822.                          /29 (20th day of Month)     /30 (21st Day of Month) 
  823.                          /31 (22nd day of Month)     /32 (23rd Day of Month) 
  824.                          /33 (24th day of Month)     /34 (25th Day of Month) 
  825.                          /35 (26th day of Month)     /36 (27th Day of Month) 
  826.                          /37 (28th day of Month)     /38 (29th Day of Month) 
  827.                          /39 (30th day of Month)     /40 (Last Day of Month) 
  828.  
  829.  /QueueNumber            /Qn  (n is 1 thru 3, default is 1) 
  830.  
  831.  /JobPriority            /J  (n is 1 thru 4, default is 2) 
  832.                          /J1 - Idle Time (lowest) 
  833.                          /J2 - Regular (default) 
  834.                          /J3 - Time Critical (highest) 
  835.                          /J4 - Server 
  836.  
  837.  Note:  A JobId of 0 (zero) can be used to identify all jobs in the queues. 
  838.         This can be used to Hold/Release/Cancel all jobs.
  839.  
  840.  
  841. ΓòÉΓòÉΓòÉ 37. Help for BMJOB - Get Job Status ΓòÉΓòÉΓòÉ
  842.  
  843. The BMJOB.EXE allows users to get the status of a single job.  Execute the 
  844. BMJOB program with the following calling format: 
  845.  
  846.   BMJOB JobId
  847.  
  848.  ARGUMENT                DESCRIPTION 
  849.  --------------------    ------------------------------------------------------ 
  850.  JobId                   JobId as displayed by BMLIST. 
  851.  
  852.  
  853. ΓòÉΓòÉΓòÉ 38. Help for BMLIST - List all Jobs ΓòÉΓòÉΓòÉ
  854.  
  855. The BMLIST.EXE allows users to list the status of all jobs in the queues. 
  856. Execute the BMLIST program with the following calling format: 
  857.  
  858.   BMLIST
  859.  
  860.   The output format is as follows:
  861.  
  862.   COLUMN        DESCRIPTION
  863.   ------        -----------
  864.   JID          Job Id
  865.  
  866.   Job Name       The name of the job
  867.  
  868.   Job Status      The Job Status
  869.               P (pending)
  870.               D (delayed)
  871.               H (hold)
  872.               A (active)
  873.  
  874.   Start Date      The Job start Date
  875.               YYYYMMDD
  876.  
  877.   Start Time      The Job Start Time
  878.               HHMM
  879.  
  880.   C/J          Job File Type
  881.               C (OS/2 Command File)
  882.               J ("PRIDE" INFORMATION FACTORY Job)
  883.  
  884.   R/S          Type of Job
  885.               S (Single)
  886.               R (Recurring)
  887.  
  888.   P           Recurring Time Period
  889.  
  890.   Execute Time     Elapsed Execution Time (active jobs only)
  891.  
  892.   Queue         The name of the job queue.
  893.  
  894.   Priority       The job priority.
  895.  
  896.  
  897. ΓòÉΓòÉΓòÉ 39. Help for BMGETQ - Get Status of all Queues ΓòÉΓòÉΓòÉ
  898.  
  899. The BMGETQ.EXE allows users to get the status of the job queues.  Execute the 
  900. BMGETQ program with the following calling format: 
  901.  
  902.   BMGETQ
  903.  
  904.   The output format is as follows:
  905.  
  906.   COLUMN        DESCRIPTION
  907.   ------        -----------
  908.   Queue Name      The name of the job queue
  909.  
  910.   Queue Stat      The queue status
  911.               A (active)
  912.               H (hold)
  913. *************************************************************** 
  914.  
  915.  
  916. ΓòÉΓòÉΓòÉ 40. Help for BMCHQ - Change Queue Status ΓòÉΓòÉΓòÉ
  917.  
  918. The BMCHQ.EXE allows users to change the status of a job queue.  Execute the 
  919. BMCHQ program with the following calling format: 
  920.  
  921.   BMCHQ  QueueNumber NewStatus
  922.  
  923.  ARGUMENT                DESCRIPTION 
  924.  --------------------    ------------------------------------------------------ 
  925.  QueueNumber             1, 2 or 3. 
  926.  
  927.  Status                  A (active) 
  928.                          H (hold) 
  929.  
  930.  
  931. ΓòÉΓòÉΓòÉ 41. Help for BMTERM - Terminate Scheduler ΓòÉΓòÉΓòÉ
  932.  
  933. The BMTERM.EXE allows users to terminate the "BATCH MANAGER" scheduler. 
  934.  
  935. Note:  This only terminates the Scheduler, not the Monitor.  It is intended for 
  936.        use only when the Monitor is not running, and the Scheduler is running 
  937.        in background mode.  The Scheduler will not terminate if any jobs are 
  938.        active.  In this situation cancel any active jobs before executing this function.
  939.  
  940.  Execute the BMTERM program with the following calling format: 
  941.  
  942.     BMTERM
  943.  
  944.  
  945. ΓòÉΓòÉΓòÉ 42. Help for TERMPID - Terminate a Background Process ΓòÉΓòÉΓòÉ
  946.  
  947. The TERMPID.EXE allows users to terminate a current process.  It can be used if 
  948. a job submitted to "BATCH MANAGER" has got into a loop and is ignoring a CANCEL 
  949. request from "BATCH MANAGER". 
  950.  
  951. Execute the TERMPID program with the following format: 
  952.  
  953.   TERMPID Pid
  954.  
  955.  ARGUMENT                DESCRIPTION 
  956.  --------------------    ------------------------------------------------------ 
  957.  Pid                     Process ID number in decimal. 
  958.  
  959.  
  960. ΓòÉΓòÉΓòÉ 43. Help for Confirm cancel all jobs message box ΓòÉΓòÉΓòÉ
  961.  
  962. This message box asks the user to confirm that all jobs are to be cancelled. 
  963. Press Ok to continue or Cancel to cancel the request. 
  964.  
  965.  
  966. ΓòÉΓòÉΓòÉ 44. Help for Confirm cancel job message box ΓòÉΓòÉΓòÉ
  967.  
  968. This message box asks the user to confirm that the selected job is to be 
  969. cancelled.  Press Ok to continue or Cancel to cancel the request. 
  970.  
  971.  
  972. ΓòÉΓòÉΓòÉ 45. Help for No Job Selected message box ΓòÉΓòÉΓòÉ
  973.  
  974. This message box informs the user that no job has been selected. Press Ok to 
  975. return to the main window and select the desired job. 
  976.  
  977.  
  978. ΓòÉΓòÉΓòÉ 46. Help for BATCH MANAGER not idle message box ΓòÉΓòÉΓòÉ
  979.  
  980. This message box informs the user that there are active jobs so "BATCH MANAGER" 
  981. has not been closed.  Any active jobs must be cancelled before closing "BATCH 
  982. MANAGER". Press Ok to return to the main window. 
  983.  
  984.  
  985. ΓòÉΓòÉΓòÉ 47. Help for Confirm Clear log message box ΓòÉΓòÉΓòÉ
  986.  
  987. This message box asks the user to confirm the clear log request. Press Ok to 
  988. continue or Cancel to cancel the request. 
  989.  
  990.  
  991. ΓòÉΓòÉΓòÉ 48. Help for Confirm Close Batch Manager Message Box ΓòÉΓòÉΓòÉ
  992.  
  993. This message box asks the user to confirm the close Batch Manager Request. 
  994. Press Ok to continue or Cancel to cancel the request.