QMODIFY

The QMODIFY command modifies one or more of a Queue’s properties.

Syntax


QMODIFY.EXE	QueueName

		/DESCRIPTION=string

		/PRIORITY=n

		/PENDING_JOBS=n | /EXECUTING_JOBS=n |

		/STOP

		/START

		/CLOSE

		/OPEN

		/AUTO_START=hh:mm

		/AUTO_STOP=hh:mm

		/AUTO_OPEN=hh:mm

		/AUTO_CLOSE=hh:mm

		/NOWORLDREAD

		/NOWORLDCONTROL

		/SERVER=ServerName

		/DEFAULT_LOGDIR=NewDefautDir

		/CREATE_DEFLOGDIR

		/USE_DEFAULT_LOGDIR

		/NOUSE_DEFAULT_LOGDIR

Qualifiers

/DESCRIPTION
This specifies a new description for the queue.

/PRIORITY
This specifies a new priority for the queue. This value may range from 0 to 255. More CPU time is given to jobs that execute in the queues of higher priorities.

/PENDING_JOBS
This specifies a new pending jobs limit for the queue. This value determines the maximum number of jobs that may be pending in the queue at one time. This value may range from 0 to 1000.

/EXECUTING_JOBS
This specifies a new executing jobs limit for the queue. This value determines the maximum number of jobs that may be executing in the queue at one time. This value may range from 0 to 100.

/STOP and /START
These qualifiers stop or start the queue, respectively. An alternate way to stop or start a queue is to use the QSTOP or QSTART commands.

/CLOSE and /OPEN
These qualifiers close or open the queue, respectively. An alternate way to close or open a queue is to use the QCLOSE or QOPEN command.

/AUTO_START and /AUTO_STOP
These qualifiers specify automatic start and stop times for the queue. These qualifiers must be specified together. If they are specified, then the queue is set to automatically start every day at the hour and minute specified by /AUTO_START and stop every day at the time specified by /AUTO_STOP. See Also: All Time Formats Use 24-Hour Clock

/AUTO_OPEN and /AUTO_CLOSE
These qualifiers specify automatic open and close times for the queue. These qualifiers must be specified together. Once these times are set, the queue will automatically open every day at the time specified by /AUTO_OPEN and close every day at the time specified by /AUTO_CLOSE. 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.

/NOWORLDREAD
This specifies whether the queue is to be viewed by other users. If /NOWORLDREAD is specified, other users, except administrators, cannot view the jobs contained by the new queue.

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

/DEFAULT_LOGDIR
This allows you to update 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 Argent 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

QMODIFY.EXE QUEUE2/EXECUTING_JOBS=5

This example changes the executing jobs limit of queue QUEUE2 to 5.

Example B

QMODIFY.EXE NIGHTLY/AUTO_STOP=7:30/AUTO_START=19:00

This example modifies queue NIGHTLY so that it automatically stops at 7:30 AM every day and starts at 7:00 PM every night.

Example C

QMODIFY.EXE CAD2/PRI=50

This example changes the priority of the queue CAD2 to 50.