Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

pbsnodes(8b) [debian man page]

pbsnodes(8B)								PBS							      pbsnodes(8B)

NAME
pbsnodes - pbs node manipulation SYNOPSIS
pbsnodes [-{a|x}] [-q] [-s server] [node|:property] pbsnodes -l [-q] [-s server] [state] [nodename|:property ...] pbsnodes [-{c|d|o|r}] [-q] [-s server] [-n] [-N "note"] [node|:property] DESCRIPTION
The pbsnodes command is used to mark nodes down, free or offline. It can also be used to list nodes and their state. Node information is obtained by sending a request to the PBS job server. Sets of nodes can be operated on at once by specifying a node property prefixed by a colon. Nodes do not exist in a single state, but actually have a set of states. For example, a node can be simultaneously "busy" and "offline". The "free" state is the absence of all other states and so is never combined with other states. In order to execute pbsnodes with other than the -a or -l options, the user must have PBS Manager or Operator privilege. OPTIONS
-a All attributes of a node or all nodes are listed. This is the default if no flag is given. -x Same as -a, but the output has an XML-like format. -c Clear OFFLINE from listed nodes. -d Print MOM diagnosis on the listed nodes. Not yet implemented. Use momctl instead. -o Add the OFFLINE state. This is different from being marked DOWN. OFFLINE prevents new jobs from running on the specified nodes. This gives the administrator a tool to hold a node out of service without changing anything else. The OFFLINE state will never be set or cleared automatically by pbs_server; it is purely for the manager or operator. -p Purge the node record from pbs_server. Not yet implemented. -r Reset the listed nodes by clearing OFFLINE and adding DOWN state. pbs_server will ping the node and, if they communicate correctly, free the node. -l List node names and their state. If no state is specified, only nodes in the DOWN, OFFLINE, or UNKNOWN states are listed. Specifying a state string acts as an output filter. Valid state strings are "free", "offline", "down", "reserve", "job- exclusive", "job-sharing", "busy", "time-shared", or "state-unknown". -N Specify a "note" attribute. This allows an administrator to add an arbitrary annotation to the listed nodes. To clear a note, use -N "" or -N n. -n Show the "note" attribute for nodes that are DOWN, OFFLINE, or UNKNOWN. This option requires -l. -q Supress all error messages. -s Specify the PBS server's hostname or IP address. SEE ALSO
pbs_server(8B) and the PBS External Reference Specification Local pbsnodes(8B)

Check Out this Related Man Page

pbs_resources_sp2(7B)                                                   PBS                                                  pbs_resources_sp2(7B)

NAME
pbs_resources_sp2 - pbs resources on IBM SP-2 DESCRIPTION
This page summarizes the resources supported by PBS for the IBM SP-2. These resources are specified by including them in the -l option argument on the qsub or qalter command or in the PBS job script. RESOURCES
nice The nice value under which the job is to be run. Units: unitary. walltime Maximum amount of real time during which the job can be in the running state. Units: time. arch Specifies the administrator defined system architecture requried. This defaults to whatever the PBS_MACH string is set to in "local.mk". Units: string. host Name of host on which job should be run. This resource is provided for use by the site's scheduling policy. The allowable values and effect on job placement is site dependent. Units: string. nodes Number and/or type of nodes to be reserved for exclusive use by the job. The value is one or more node_specs joined with the '+' character, "node_spec[+node_spec...]. Each node_spec is an number of nodes required of the type declared in the node_spec and a name or one or more properity or properities desired for the nodes. The number, the name, and each properity in the node_spec are separated by a colon ':'. If no number is specified, one(1) is assumed. Units: string. The name of a node is its hostname. The properities of nodes are: . ppn=# specifying the number of processors per node requested. Defaults to 1. . arbitrary string assigned by the system administrator, please check with your administrator as to the node names and properities available to you. Examples: . To ask for 12 nodes of any type: -l nodes=12 . To ask for 2 "server" nodes and 14 other nodes (a total of 16): -l nodes=2:server+14 The above consist of two node_specs "2:server" and "14". . To ask for (a) 1 node that is a "server" and has a "hippi" interface, (b) 10 nodes that are not servers, and (c) 3 nodes that have a large amount of memory an have hippi: -l nodes=server:hippi+10:noserver+3:bigmem:hippi . To ask for three nodes by name: -l nodes=b2005+b1803+b1813 . To ask for 2 processors on each of four nodes: -l nodes=4:ppn=2 . To ask for 4 processors on one node: -l nodes=1:ppn=4 . To ask for 2 processors on each of two blue nodes and three processors on one red node: -l nodes=2:blue:ppn=2+red:ppn=3 host Allows a user to specify the desired execution location. This resource is provided for use by the site's scheduling policy. The allowable values and effect on job placement is site dependent. Units: string. other Allows a user to specify site specific information. This resource is provided for use by the site's scheduling policy. The allow- able values and effect on job placement is site dependent. Units: string. software Allows a user to specify software required by the job. This is useful if certain software packages are only available on certain systems in the site. This resource is provided for use by the site's scheduling policy. The allowable values and effect on job placement is site dependent. Units: string. EXAMPLES
qsub -l nodes=15,walltime=2:00:00 script or in a qsub script as a directive: #PBS -l nodes=15,walltime=2:00:00 RESOURCE UNITS
The resource values take the following units: time specifies a maximum time period the resource can be used. Time is expressed in seconds as an integer, or in the form: [[hours:]minutes:]seconds[.milliseconds] unitary The maximum amount of a resource which is expressed as a simple integer. SEE ALSO
the PBS ERS, qsub(1B), qalter(1B), pbs_submit(3B), pbs_alterjob(3B), pbs_statjob(3b) pbs_resources_aix4(7B), pbs_resources_irix5(7B) pbs_resources_sunos4(7B), pbs_resources_unicos8(7B) Local pbs_resources_sp2(7B)
Man Page