1qmgr(1B) PBS qmgr(1B)
2
6 qmgr - pbs batch system manager
7
9 qmgr [-a] [-c command] [-e] [-n] [-z] [server...]
10
12 The qmgr command provides an administrator interface to the batch sys‐
13 tem.
14 The command reads directives from standard input. The syntax of each
16 directive is checked and the appropriate request is sent to the batch
17 server or servers.
18 The list or print subcommands of qmgr can be executed by general users.
20 Creating or deleting a queue requries PBS Manager privilege. Setting
21 or unsetting server or queue attributes requires PBS Operator or Man‐
22 ager privilege.
23
25 -a Abort qmgr on any syntax errors or any requests rejected by
26 a server.
27 -c command Execute a single command and exit qmgr .
29 -e Echo all commands to standard output.
31 -n No commands are executed, syntax checking only is per‐
33 formed.
34 -z No errors are written to standard error.
36
38 The server operands identify the name of the batch server to which the
39 administrator requests are sent. Each server conforms to the following
40 syntax:
41 host_name[:port]
42 where host_name is the network name of the host on which the server is
43 running and port is the port number to which to connect. If port is
44 not specified, the default port number is used.
45 If server is not specified, the administrator requests are sent to the
47 local server.
48
50 The qmgr command reads standard input for directives until end of file
51 is reached, or the exit or quit directive is read.
52
54 If Standard Output is connected to a terminal, a command prompt will be
55 written to standard output when qmgr is ready to read a directive.
56 If the -e option is specified, qmgr will echo the directives read from
58 standard input to standard output.
59
61 If the -z option is not specified, the qmgr command will write a diag‐
62 nostic message to standard error for each error occurrence.
63
65 If qmgr is invoked without the -c option and standard output is con‐
66 nected to a terminal, qmgr will write a prompt to standard output and
67 read a directive from standard input.
68 Commands can be abbreviated to their minimum unambiguous form. A com‐
70 mand is terminated by a new line character or a semicolon, ";", charac‐
71 ter. Multiple commands may be entered on a single line. A command may
72 extend across lines by escaping the new line character with a back-
73 slash "\".
74 Comments begin with the # character and continue to end of the line.
76 Comments and blank lines are ignored by qmgr.
77
79 A qmgr directive is one of the following forms:
80 command server [names] [attr OP value[,attr OP value,...]]
82 command queue [names] [attr OP value[,attr OP value,...]]
83 command node [names] [attr OP value[,attr OP value,...]]
84 Where,
86 command is the command to perform on a object. Commands are:
88 active sets the active objects. If the active objects are
90 specified, and the name is not given in a qmgr cmd
91 the active object names will be used.
92 create is to create a new object, applies to queues and
94 nodes.
95 delete is to destroy an existing object, applies to queues
97 and nodes.
98 set is to define or alter attribute values of the
100 object.
101 unset is to clear the value of attributes of the object.
103 Note, this form does not accept an OP and value,
104 only the attribute name.
105 list is to list the current attributes and associated
107 values of the object.
108 print is to print all the queue and server attributes in
110 a format that will be usable as input to the qmgr
111 command.
112 names is a list of one or more names of specific objects The name
114 list is in the form:
115 [name][@server][,queue_name[@server]...]
116 with no intervening white space. The name of an object is
117 declared when the object is first created. If the name is
118 @server, then all the objects of specified type at the server
119 will be effected.
120 attr specifies the name of an attribute of the object which is to
122 be set or modified. If the attribute is one which consist of
123 a set of resources, then the attribute is specified in the
124 form:
125 attribute_name.resource_name
126 OP operation to be performed with the attribute and its value:
128 = set the value of the attribute. If the attribute has
130 a existing value, the current value is replaced with
131 the new value.
132 += increase the current value of the attribute by the
134 amount in the new value.
135 -= decrease the current value of the attribute by the
137 amount in the new value.
138 value the value to assign to an attribute. If the value includes
140 white space, commas or other special characters, such as the
141 # character, the value string must be inclosed in quote marks
142 (").
143 The following are examples of qmgr directives:
145 create queue fast priority=10,queue_type=e,enabled = true,max_running=0
147 set queue fast max_running +=2
148 create queue little
149 set queue little resources_max.mem=8mw,resources_max.cput=10
150 unset queue fast max_running
151 set node state = down,offline
152 active server s1,s2,s3
153 list queue @server1
154 set queue max_running = 10 - uses active queues
155
157 Upon successful processing of all the operands presented to the qmgr
158 command, the exit status will be a value of zero.
159 If the qmgr command fails to process any operand, the command exits
161 with a value greater than zero.
162
164 pbs_server(8B), pbs_queue_attributes(7B), pbs_server_attributes(7B),
165 qstart(8B), qstop(8B), qenable(8B), qdisable(8), pbs_resources(7B) and
166 the PBS External Reference Specification
167Local qmgr(1B)