Knowledge Center         Contents    Previous  Next    
Platform Computing Corp.

lsb_queuecontrol()

Changes the status of a queue.

DESCRIPTION

lsb_queuecontrol() changes the status of a queue.

Any program using this API must be setuid to root if LSF_AUTH is not defined in the lsf.conf file.

If a queue is inactivated by its dispatch window (see lsb.queues), then it cannot be re-activated by this call.

SYNOPSIS

#include <lsf/lsbatch.h> 
int lsb_queuecontrol (struct queueCtrlReq *req) 
struct queueCtrlReq { 
  char *queue 
  int   opCode 
  char *message 

PARAMETERS

*queue

The name of the queue to be controlled.

opCode

One of the following operation codes:

QUEUE_OPEN

Open the queue to accept jobs.

QUEUE_CLOSED

Close the queue so it will not accept jobs.

QUEUE_ACTIVATE

Activate the queue to dispatch jobs.

QUEUE_INACTIVATE

Inactivate the queue so it will not dispatch jobs.

message

The message attached by the administrator.

RETURN VALUES

integer:0

The function was successful.

integer:-1

Function failed.

ERRORS

If the function fails, lsberrno is set to indicate the error.

SEE ALSO

Related APIs

lsb_queueinfo() - Returns information about queues

Equivalent line command

none

Files

lsf.conf


Platform Computing Inc.
www.platform.com
Knowledge Center         Contents    Previous  Next