Synopsisqmgr [-a] [-c command] [-e] [-n] [-z] [server...]
DescriptionThe qmgr 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 standard input.
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 "\".
OperandsThe server operands identify the name of the batch server to which the administrator requests are sent. Each server conforms to the following syntax:
where host_name is the network name of the host on which the server is running and port is the port number to which to connect. If port is not specified, the default port number is used.
Standard InputThe qmgr command reads standard input for directives until end of file is reached, or the exit or quit directive is read.
Standard OutputIf Standard Output is connected to a terminal, a command prompt will be written to standard output when qmgr is ready to read a directive.
Standard ErrorIf the -z option is not specified, the qmgr command will write a diagnostic message to standard error for each error occurrence.
Directive SyntaxA 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:
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
Exit StatusUpon successful processing of all the operands presented to the qmgr command, the exit status will be a value of zero.
See Alsopbs_server (8B), pbs_queue_attributes (7B), pbs_server_attributes (7B), qstart (8B), qstop (8B), qenable (8B), qdisable (8), and the PBS External Reference Specification
|© 2001-2010 Adaptive Computing Enterprises, Inc.|