1qmgr(1B)                              PBS                             qmgr(1B)
2
3
4

NAME

6       qmgr - pbs batch system manager
7

SYNOPSIS

9       qmgr [-a] [-c command] [-e] [-n] [-z] [server...]
10

DESCRIPTION

12       The  qmgr command provides an administrator interface to the batch sys‐
13       tem.
14
15       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
19       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

OPTIONS

25       -a          Abort qmgr on any syntax errors or any requests rejected by
26                   a server.
27
28       -c command  Execute a single command and exit qmgr .
29
30       -e          Echo all commands to standard output.
31
32       -n          No commands are executed,  syntax  checking  only  is  per‐
33                   formed.
34
35       -z          No errors are written to standard error.
36

OPERANDS

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
46       If  server is not specified, the administrator requests are sent to the
47       local server.
48

STANDARD INPUT

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

STANDARD OUTPUT

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
57       If the -e option is specified, qmgr will echo the directives read  from
58       standard input to standard output.
59

STANDARD ERROR

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

EXTENDED DESCRIPTION

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
69       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
75       Comments begin with the # character and continue to end  of  the  line.
76       Comments and blank lines are ignored by qmgr.
77

DIRECTIVE SYNTAX

79       A qmgr directive is one of the following forms:
80
81       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
85       Where,
86
87       command   is the command to perform on a object.  Commands are:
88
89                 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
93                 create    is  to  create  a new object, applies to queues and
94                           nodes.
95
96                 delete    is to destroy an existing object, applies to queues
97                           and nodes.
98
99                 set       is  to  define  or  alter  attribute  values of the
100                           object.
101
102                 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
106                 list      is to list the current  attributes  and  associated
107                           values of the object.
108
109                 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
113       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
121       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
127       OP        operation to be performed with the attribute and its value:
128
129                 =      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
133                 +=     increase the current value of  the  attribute  by  the
134                        amount in the new value.
135
136                 -=     decrease  the  current  value  of the attribute by the
137                        amount in the new value.
138
139       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
144       The following are examples of qmgr directives:
145
146       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

EXIT STATUS

157       Upon  successful  processing  of all the operands presented to the qmgr
158       command, the exit status will be a value of zero.
159
160       If the qmgr command fails to process any  operand,  the  command  exits
161       with a value greater than zero.
162

SEE ALSO

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
167
168
169
170Local                                                                 qmgr(1B)
Impressum