pbs batch system manager
qmgr [-a] [-c command] [-e] [-n]
command provides an administrator interface to query and configure batch system parameters
The command reads directives from standard input. The syntax of each
directive is checked and the appropriate request is sent to the
batch server or servers.
The list or print subcommands of qmgr can be executed by general users.
Creating or deleting a queue requries PBS Manager privilege. Setting or
unsetting server or queue attributes requires PBS Operator or Manager privilege. NOTE: by default the user root is the only PBS Operator and Manager. To allow other users to be privileged, the server attributes operators and managers will need to be set (i.e., as root, issue 'qmgr -c 'set server managers += <USER1>@<HOST>'). See PBS Access Config for more information.
If qmgr is invoked without the -c option and standard output is connected to a terminal, qmgr will write a
prompt to standard output and read a directive from
Commands can be abbreviated to their minimum unambiguous form.
A command is terminated by a new line character or a semicolon, ";",
character. Multiple commands may be entered on a single line.
A command may extend across lines by escaping the new line character
with a back-slash "\".
Comments begin with the # character and continue to end of the line.
Comments and blank lines are ignored by qmgr.
on any syntax errors or any requests rejected by a server.
- -c command
Execute a single
Echo all commands to standard output.
No commands are executed, syntax checking only is performed.
No errors are written to standard error.
operands identify the name of the batch server to which the administrator
requests are sent. Each
conforms to the following syntax:
is the network name of the host on which the server is running and
is the port number to which to connect. If
is not specified, the default port number is used.
is not specified, the administrator requests are sent to the local
command reads standard input for directives until end of file is reached,
directive is read.
If Standard Output is connected to a terminal, a command prompt will
be written to standard output when qmgr is ready to read a directive.
option is specified,
will echo the directives read from standard input to standard output.
option is not specified, the qmgr command will write a diagnostic message
to standard error for each error occurrence.
A qmgr directive is one of the following forms:
command server [names] [attr OP value[,attr OP value,...]]
command queue [names] [attr OP value[,attr OP value,...]]
command node [names] [attr OP value[,attr OP value,...]]
where "command" is the command to perform on a object. Commands are:
sets the active objects. If the active objects are specified, and the name is
not given in a qmgr cmd the active object names will be used.
is to create a new object, applies to queues and nodes.
is to destroy an existing object, applies to queues and nodes.
is to define or alter attribute values of the object.
is to clear the value of attributes of the object.
Note, this form does not accept an OP and value, only the
is to list the current attributes and associated values of the object.
is to print all the queue and server attributes in a format that will be usable
as input to the qmgr command.
is a list of one or more names of specific objects
The name list is in the form:
with no intervening white space.
The name of an object is declared when the object is first created. If the
name is @server, then all the objects of specified type at the server will be
specifies the name of an attribute
of the object which is to be set or modified.
If the attribute is one which consist of a set of resources, then the
attribute is specified in the form:
- operation to be performed with the attribute and its value:
- set the value of the attribute. If the attribute has a existing value, the current value is replaced with the new value.
- increase the current value of the attribute by the amount in the new value.
- decrease the current value of the attribute by the amount in the new value.
the value to assign to an attribute. If the value includes white space,
commas or other special characters, such as the # character,
the value string must be inclosed in quote marks (").
The following are examples of qmgr directives:
create queue fast priority=10,queue_type=e,enabled = true,max_running=0
set queue fast max_running +=2
create queue little
set queue little resources_max.mem=8mw,resources_max.cput=10
unset queue fast max_running
set node state = "down,offline"
active server s1,s2,s3
list queue @server1
set queue max_running = 10 - uses active queues
Upon successful processing of all the operands presented to the
command, the exit status will be a value of zero.
If the qmgr command fails to process any operand, the
command exits with a value greater than zero.
pbs_server (8B), pbs_queue_attributes (7B), pbs_server_attributes (7B),
qstart (8B), qstop (8B), qenable (8B), qdisable (8),
and the PBS External Reference Specification