Common Usage

The com-file start_queues.com has three distinct but related parts: first is the form definition section, related to the third section, the print queue definition section, and the second section, the batch queue definition section.

It should be noted that a com-file is a type of script, and so contains programming language and constructs.

Before any actual statements, it is essential that each com-file begin with the DCL statement: set noon. This sets up default error handling.

The syntax of the DCL com-file in general is important to note, especially:

• the command introducer $ which must precede every command
• the command continuation - which must terminate every command line that wraps to the next line
• the comment character, !, which hides everything up to the end of the line, or until the next !

After every three queue-defining init commands, there should be a wait command to slow down the process for about 3-5 seconds, so that the system spooler can catch up. See Example below.

How to set the job_limit

Working backwards, starting with the job limit as it becomes a parameter to start_queues.com: the sample start_queues.com being shipped with LeasePak will take an optional job limit parameter. In the absence of the parameter, the job limit defaults to a reasonable level. It also issues a warning that the administrator has not set a job limit. The administrator is fully in charge of the contents of the com-file of course, and has a range of choices of how to implement the job limit:

• The administrator can hard code the job limits and even set different job limits for different queues within start_queues.com.
• The administrator can hard code the job limit as a local variable within start_queues.com, and set all the queue job limits uniformly to that single value, or a set of local variables and set particular queues with particular variables.
• The administrator can use start_queues.com as it is presently shipped, but make his or her own provisions for passing a job limit parameter to the queue startup.
• The administrator can use start_queues.com and nst_qm_{ID}99x (such as nst_qm_{ID}76a) as they are shipped, but make other arrangements for setting up the contents of the $QMJOB_LIM_FILE.
• Finally, the administrator can use start_queues.com and nst_qm_{ID}99x (such as nst_qm_{ID}76a) as they are shipped and rely on the default mechanism for providing the job limit:
• SETUP queries the operator for the job limit, which was determined before SETUP is run.
• Then SETUP creates an assignment in the file $QMDIR/library/qjob_limit.
• The assignment will be of the job limit from the interview being assigned to the environment variableQLIM:
  QLIM=10
  The assignment in the qjob_limit file is evaluated by nst_qm_{ID}99x and by the cleanse_s7 utility, and passed to start_queues.com when it is called to start the individual queues.