QCREATE

The QCREATE.EXE command creates a queue. Various queue properties can be specified when the queue is created, and they can also be changed at a later time with the QMODIFY.EXE command.

Default values are used for any attributes that are not specified.

The queue name may be up to 16 characters long, and may not contain any spaces.

Syntax


QCREATE.EXE 	QueueName

		/DESCRIPTION=string

		/PRIORITY=n

		/PENDING_JOBS=n

		/EXECUTING_JOBS=n

		/STOPPED  

		/STARTED 

		/CLOSED 

		/OPEN

		/AUTO_START=hh:mm

		/AUTO_STOP=hh:mm

		/AUTO_OPEN=hh:mm

		/AUTO_CLOSE=hh:mm

		/SERVER=ServerName

		/WORLDREAD

		/WORLDCONTROL

		/DEFAULT_LOGDIR=log_directory

		/CREATE_DEFLOGDIR

		/USE_DEFAULT_LOGDIR

		/NOUSE_DEFAULT_LOGDIR

Qualifiers

/PRIORITY
This specifies the priority for the new queue. This value may range from 0 to 255. The priority of a queue should represent its priority relative to other queues. More CPU time is given to jobs that execute in the queues with higher priorities. If this qualifier is not specified, a default priority of 128 is used.

/PENDING_JOBS
This specifies the pending jobs limit for the new queue. The pending jobs limit determines the maximum number of jobs that may be pending in the queue at one time. If this qualifier is not specified, a default of 32 is used.

/EXECUTING_JOBS
This specifies the executing jobs limit for the new queue. This value determines the maximum number of jobs that may be executing in the queue at one time. If this qualifier is not specified, a default value of 10 is used.

/STOPPED and /STARTED

These qualifiers specify whether the new queue is initially stopped or started. By default, a queue is started when it is created.

/CLOSED and /OPEN

These qualifiers specify whether the queue is initially closed or open. By default, a queue is open when it is created.

/AUTO_START and /AUTO_STOP

These qualifiers specify optional automatic start and stop times for the queue. If these are specified, then the queue is automatically started every day at the hour and minute specified by /AUTO_START and stopped every day at the time specified by /AUTO_STOP. If these qualifiers are not specified, then the queue has no automatic open and close times. See Also: All Time Formats Use 24-Hour Clock

/AUTO_OPEN and /AUTO_CLOSE

These qualifiers specify optional automatic open and close times for the queue. If these are specified, then the queue is automatically opened every day at the hour and minute specified by /AUTO_OPEN and closed every day at the time specified by /AUTO_CLOSE. If these qualifiers are not specified, then the queue has no automatic start and stop times. See Also: All Time Formats Use 24-Hour Clock

/SERVER
This specifies the name of an Argent Queue Engine server. If this qualifier is absent, then the command uses the value of the XS_SERVER environment variable, if defined. If this environment variable is also absent, then the command assumes the local server.

/WORLDREAD
This allows the queue to be viewed by other users. If this qualifier is not specified, other users, except administrators, cannot view the jobs contained by the new queue.

/WORLDCONTROL
This allows the queue to be controlled by other users. If this qualifier is not specified, other users, except administrators, cannot delete, abort, or otherwise control the jobs contained by the new queue.

/DEFAULT_LOGDIR
This allows you to specify the path to default log directory of the queue. This qualifier should only used if the /USE_DEFAULT_LOGDIR is also used.

/CREATE_DEFLOGDIR
This is used to automatically create the log file specified by the /DEFAULT_LOGDIR qualifier. This can only be used on the local Queue Engine server.

/USE_DEFAULT_LOGDIR
This allows you to specify a default log directory for the new queue.

/NOUSE_DEFAULT_LOGDIR
This specifies that no default log directory is used for this queue.

Example A

QCREATE.EXE ABC

This command creates a queue called ABC, with default values for all queue attributes.

Example B

QCREATE.EXE QUEUE1 /DESCR=”Default queue” /PRIORITY=150 /PENDING_JOBS=30 /EXECUTING_JOBS=3

This command creates a queue called QUEUE1, with the description “Default queue”, a priority of 150, a pending jobs limit of 30, and an executing jobs limit of 3.

Example C

QCREATE.EXE NIGHTLY /DESCR=”Nightly batch queue” /PRIORITY=80 /PENDING_JOBS=50 /EXECUTING_JOBS=3 /AUTO_STOP=8:00/AUTO_START=18:30

This command creates a Queue called NIGHTLY, with a priority of 80, a pending jobs limit of 50, and an executing jobs limit of 3. The queue will automatically stop every day at 8:00 AM and start every day at 6:30 PM.