.! .! Runoff help file for Q_MONITOR. .! .style headers 4 .enable bolding .enable underlining .flags accept _ .flags bold .flags underline .first title .headers on .layout 0 .no number .title ^*Q__MONITOR USER GUIDE\* .subtitle .autosubtitle 1 .date .! .! Front Page .! .skip 5 .center .skip 15 .center ^*Q__MONITOR USER GUIDE\* .skip 5 .center ^*S.J.Brown\* .center Riverside .center Glen Auldyn .center Ramsey .center Isle Of Man .center British Isles .skip 5 .center ^*Version 1.0\* .lm +9 .rm -9 .skip 5 .center This is public domain software. .skip 1 .center It is free, and may be distributed as desired. Q__MONITOR may not be sold. .lm -9 .rm +9 .page .number page 1 .display number RU .require "queue_manual.rnt" .number page 1 .display number D .page .HL1 ^*^&INTRODUCTION\&\* .p Q__MONITOR is a simple utility which dynamically displays the contents of selected VMS queues. In addition, entries in these queues can be modified. The queues can be paused, reset, started and stopped. .p Q__MONITOR will run on any terminal which supports the SMG routines - that is just about any VT terminal. Q__MONITOR will run on workstations. The more lines on the screen, the more information Q__MONITOR will display. .HL1 ^*^&GETTING_ GOING\&\* .HL2 ^*^&INSTALLATION\&\* .p Q__MONITOR should be installed via a foreign command, e.g. .p $ QQ == "$MY__DISK:[MY__DIR]QUEUE" .HL2 ^*^&STARTING_ Q__MONITOR\&\* .p Q__MONITOR accepts as arguments the names of the queues to be monitored. It is possible to use wildcards. So, for example, to monitor all the queues with TEST or BATCH as a part of the queue name you would type .p $ QQ _*TEST_* _*BATCH_* .p To monitor specific queues enter the queue names in full, e.g. .p $ QQ SYS$BATCH SYS$PRINT SYS$OVERNIGHT .HL2 ^*^&MOVING_ AROUND\&\* .p Use up-arrow, down-arrow, Next-Screen, Prev-Screen and Select (= go to top of display) to move the window around. The lines currently being displayed are shown on the top line of the display. .p When a new queue specification is entered the window automatically displays line 1 at the top of the screen. .page .HL1 ^*^&PRIVILEGES\&\* .HL2 ^*^&JOB_ OPERATIONS\&\* .p Operations that apply to jobs (delete, modify and release) are checked against .list .le; the R (read) and D (delete) protection specified for the queue in which the job is entered and .le; the owner UIC of the job. .end list .p In general, R access to a job allows you to determine that the job exists; D access to a job allows you to affect the job. .HL2 ^*^&QUEUE_ OPERATIONS\&\* .p Operations that apply to queues are checked against .list .le; the W (write) and E (execute) protection specified for the queue and .le; the owner UIC of the queue. .end list .p In general, W access to a queue allows you to submit jobs to the queue; E access to a queue allows you to act as an operator for the queue including the ability to affect jobs in the queue and alter queues. OPER privilege grants E access to all queues. .page .HL1 ^*^&OPTIONS\&\* .HL2 ^*^&DELETE_ ENTRIES_ (D)\&\* .p You will be prompted for the entry numbers to be deleted. If Q__MONITOR cannot delete any entries, an error message is returned. As with all the options that solicit a series of entry numbers the maximum number of entries that will be read from the input line is 20. Any other entry numbers are ignored. .p You must have either OPER privilege, E access to the queue containing the specified job or D access to the specified job. .HL2 ^*^&HELP_ (H)\&\* .p A simple menu is displayed, showing the available options, which are also described here. .HL2 ^*^&MODIFY_ ENTRIES_ (M)\&\* .p This option enables you to change that date and time after which a job is to execute. This is useful where you may have an entry in a queue set to run at six p.m., and you decide you wish to have the entry run at eight p.m. instead. .p You must have either OPER privilege, E access to the queue containing the specified job or D access to the specified job. .HL2 ^*^&SPECIFY_ A_ NEW_ QUEUE_ FOR_ A_ JOB_ (N)\&\* .p This option allows you to move a job to a new queue. When using this option you must make sure that the job is compatible with the new queue - for example, moving a postscript file to a non-postscript printer queue will have unpredictable results. .p You must have either OPER privilege, E access to the queue containing the specified job or D access to the specified job. .HL2 ^*^&TIMER_ INTERVAL_ (T)\&\* .p This option enables you to change the length of time that Q__MONITOR pauses between making updates to the display. The minimum period is 1 second, the maximum 59 seconds. .HL2 ^*^&QUEUE_ SPECIFICATION_ (Q)\&\* .p This enables you to re-specify the queues to be monitored. Use wildcards as desired. .HL2 ^*^&RELEASE_ ENTRIES_ (R)\&\* .p You may have entries set to execute after a specific time (holding until), or entries which are just on hold indefinitely (holding since). This option enables you to make these entries ready for execution, removing the hold or after times as appropriate. The entries will then execute when there are free slots in the respective queues. .p You must have either OPER privilege, E access to the queue containing the specified job or D access to the specified job. .HL2 ^*^&PAUSE_ A_ QUEUE_ (1)\&\* .p This allows you to set the status of a specified queue to PAUSED. This will pause the execution of current jobs in the specified queue and prevent the starting of other jobs in the queue. .p You must have either OPER privilege or E access to the specified queue. .HL2 ^*^&RESET_ A_ QUEUE_ (2)\&\* .p This resets the specified queue by .list .list element; terminating and deleting each executing job that is not restartable, .list element; terminating and requeuing each executing job that is restartable, and .list element; stopping the queue. .end list .p You must have either OPER privilege or E access to the specified queue. .HL2 ^*^&START_ A_ QUEUE_ (3)\&\* .p This permits the starting of jobs in the specified queue. If the queue was paused, current jobs are resumed. .p You must have either OPER privilege or E access to the specified queue. .HL2 ^*^&STOP_ A_ QUEUE_ (4)\&\* .p This prevents the starting of jobs in the specified queue. The execution of current jobs is unaffected. .p You must have either OPER privilege or E access to the specified queue. .HL2 ^*^&EXIT_ (_^Z)\&\* .p This performs an orderly exit, Typing _^C or _^Y will also exit from Q__MONITOR. .HL1 ^*^&LAST_ LONGWORD\&\* .p Q__MONITOR uses $GETQUI to extract queue information, and $SNDJBC to change queue information. There are many more features that could be added to this type of software, and in this case they will be added as required. .p I hope you find this useful, and that it saves you a few minutes when you implement $GETQUI or $SNDJBC for yourself.