title: pbs_queue_attributes(7)

summary: pbs queue attributes

text:
# pbs_queue_attributes(7)

## NAME
pbs_queue_attributes - pbs queue attributes

## DESCRIPTION
Queue public attributes are alterable on request by a client. The client must be acting for a user with administrator (manager) or operator privilege. Certain attributes require the user to have full administrator privilege before they can be modified. The following attributes apply to both queue types:

acl_group_enable

Attribute which when true directs the server to use the queue group access control list acl_groups . Format: boolean, "TRUE", "True", "true", "Y", "y", "1", "FALSE", "False", "false", "N", "n", "0"; default value: false = disabled.

acl_group_sloppy

Search a job user's secondary groups if the effective group doesn't match the group acl. Warning, this can be very slow and expensive. Format: boolean, "TRUE", "True", "true", "Y", "y", "1", "FALSE", "False", "false", "N", "n", "0"; default value: false = disabled.

acl_groups

List which allows or denies enqueuing of jobs owned by members of the listed groups. The groups in the list are groups on the server host, not submitting hosts. If acl_group_enable is set to true, only groups listed in the acl_groups attribute will be allowed access to the queue. See section 10.1, Authorization, in the PBS External Reference Specification. Format: "[+|-]group_name[,...]"; default value: all groups allowed.

acl_host_enable

Attribute which when true directs the server to use the acl_hosts access list. Format: boolean (see acl_group_enable); default value: disabled.

acl_hosts

List of hosts which may enqueue jobs in the queue. See section 10.1, Authorization, in the PBS External Reference Specification. Format: "[+|-]hostname[...]"; default value: all hosts allowed.

acl_logic_or

Modifies the way acls are applied if both acl_user_enable and acl_group_enable are set to true. If acl_logic_or is true, then user and group acls are logically OR'ed together (a job can pass either the user or group acl lists to be allowed access to the queue). If I acl_logic_or is false, then user and group acls are logically AND'ed together (a job would have to pass both user and group acl lists). Format: boolean (see acl_group_enable and acl_user_enable); default value: disabled.

acl_user_enable

Attribute which when true directs the server to use the the acl_users access list for this queue. Format: boolean (see acl_group_enable); default value: disabled.

acl_users

List of users allowed or denied the ability to enqueue jobs in this queue. See section 10.1, Authorization, in the PBS External Reference Specification. If acl_user_enable is set to true, only users listed in the acl_groups attribute will be allowed access to the queue. Format: "[+|-]user[@host][,...]"; default value: all users allowed.

disallowed_types

List of job "types" (interactive,batch,rerunable,nonrerunable,fault_tolerant,fault_intolerant) that are not allowed in this queue. default value: all types allowed.

enabled

Queue will or will not accept new jobs. When false the queue is disabled and will not accept jobs. Format: boolean (see acl_group_enable); default value: disabled.

from_route_only

When true, this queue will not accept jobs except when being routed by the server from a local routing queue. This is used to force user to submit jobs into a routing queue used to distribute jobs to other queues based on job resource limits. Format: boolean; default value: disabled.

is_transit

When true, jobs will be allowed into this queue that do not fit server resource limitations. This is to allow the jobs to be routed to a server that does have the appropriate resources. Any queue limits are checked.

max_queuable

The maximum number of jobs allowed to reside in the queue at any given time. Format: integer; default value: infinite.

max_user_queuable

The maximum number of jobs owned by a single user that are allowed to reside in the queue at any given time. Format: integer; default value: infinite.

max_running

The maximum number of jobs allowed to be selected from this queue for routing or execution at any given time. For a routing queue, this is enforced, if set, by the server. For an execution queue, this attribute is advisory to the Scheduler, it is not enforced by the server. Format: integer.

Priority

The priority of this queue against other queues of the same type on this server. May affect job selection for execution/routing. Advisory to the Scheduler, not used by the server. Format: integer.

queue_type

The type of the queue: execution or route. Format: "execution", "e", "route", "r". This attribute must be explicitly set.

resources_max

The maximum amount of each resource which can be requested by a single job in this queue. The queue value supersedes any server wide maximum limit. Format: "resources_max.resource_name=value", see qmgr(1B); default value: infinite usage.

resources_min

The minimum amount of each resource which can be requested by a single job in this queue. Format: see resources_max, default value: zero usage.

resources_default

The list of default resource values which are set as limits for a job residing in this queue and for which the job did not specify a limit. Format: "resources_default.resource_name=value", see qmgr(1B); default value: none; if not set, the default limit for a job is determined by the first of the following attributes which is set: server's resources_default, queue's resources_max, server's resources_max. If none of these are set, the job will unlimited resource usage.

started

Jobs may be scheduled for execution from this queue. When false, the queue is considered stopped. Advisory to the Scheduler, not enforced by the server. [default value: false, but depends on scheduler interpretation] Format: boolean (see acl_group_enable).

The following attributes apply only to execution queues:

checkpoint_defaults

Specifies the queues default checkpointing values to be used for a job that does not have any checkpointing specified. Format: string; default value: none.

checkpoint_min

Specifies the minimum interval of cpu time, in minutes, which is allowed between checkpoints of a job. If a user specifies a time less than this value, this value is used instead. Format: integer; default value: no minimum.

resources_available

The list of resource and amounts available to jobs running in this queue. The sum of the resource of each type used by all jobs running from this queue cannot exceed the total amount listed here. Advisory to the Scheduler, not enforced by the server. Format: "resources_available.resource_name=value", see qmgr(1B).

keep_completed

Number of seconds to retain completed jobs in the C state. This overrides the server attribute of the same name. EXPERIMENTAL Format: integer; default value: 0.

kill_delay

The amount of the time delay between the sending of SIGTERM and SIGKILL when a qdel command is issued against a running job. This overrides the server attribute of the same name. Format: integer seconds; default value: 2 seconds.

max_user_run

The maximum number of jobs owned by a single user that are allowed to be running from this queue at one time. This attribute is advisory to the Scheduler, it is not enforced by the server. Format: integer; default value: none.

max_group_run

The maximum number of jobs owned by any users in a single group that are allowed to be running from this queue at one time. This attribute is advisory to the Scheduler, it is not enforced by the server. Format: integer; default value: none.

The following attributes apply only to routing queues:

route_destinations

The list of destinations to which jobs may be routed. [default value: none, should be set to at least one valid destination]

alt_router

If true, an site supplied, alternative job router function is used to determine the destination for routing jobs from this queue. Otherwise, the default, round-robin router is used. Format: boolean (see acl_group_enable); default value: false.

route_held_jobs

If true, jobs with a hold type set may be routed from this queue. If false, held jobs are not to be routed. Format: boolean (see acl_group_enable); default value: false.

route_waiting_jobs

If true, jobs with a future execution_time attribute may be routed from this queue. If false, they are not to be routed. Format: boolean (see acl_group_enable); default value: false.

route_retry_time

Time delay between route retries. Typically used when the network between servers is down. Format: integer seconds; default value: {PBS_NET_RETRY_TIME} (30 seconds).

route_lifetime

The maximum time a job is allowed to exist in a routing queue. If the job cannot be routed in this amount of time, the job is aborted. If unset or set to a value of zero (0), the lifetime is infinite. Format: integer seconds; default infinite.

The following data items are read-only attributes of the queue. They are visible to but cannot be changed by clients.

Items which apply to all types of queues are:

total_jobs

The number of jobs currently residing in the queue.

state_count

The total number of jobs currently residing in the queue in each state.

These read-only attributes only apply to execution queues:

resources_assigned

The total amount of certain types of resources allocated to jobs running from this queue.

## SEE ALSO
the PBS ERS, qmgr(1B), pbs_resources(7B)


package: torque-client

title: pbs_resources_aix4(7)

summary: pbs Resources on IBM AIX 4

text:
# pbs_resources_aix4(7)

## NAME
pbs_resources_aix4 - pbs Resources on IBM AIX 4

## DESCRIPTION
This page summarizes the resources supported by PBS for IBM systems running AIX version 4. These resources are specified for jobs by including them in the -l option argument on the qsub or qalter command or in the PBS job script.

## RESOURCES
cput

Maximum amount of CPU time used by all processes in the job. Units: time.

file

The largest size of any single file that may be created by the job. Units: size.

mem

Maximum amount of physical memory (workingset) used by the job. Units: size.

vmem

Maximum amount of virtual memory used by all concurrent processes in the job. Units: size.

nice

The nice value under which the job is to be run. Units: unitary.

pcput

Maximum amount of CPU time used by any single process in the job. Units: time.

pmem

Maximum amount of physical memory (workingset) used by any single process of the job. Units: size.

pvmem

Maximum amount of virtual memory used by any single process in the job. Units: size.

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 property or properties desired for the nodes. The number, the name, and each property 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 properties 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 properties 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 allowable 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

qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script

qalter -lcput=30:00,pmem=8mb 123.jobid

or in a qsub script as a directive:

\#PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb

## 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]

size

specifies the maximum amount in terms of bytes or words. It is expressed in the form integer[suffix] The suffix is a multiplier defined in the following table, The size of a word is the word size on the execution host.

b or w

bytes or words.

kb or kw

Kilo (1024) bytes or words.

mb or mw

Mega (1,048,576) bytes or words.

gb or gw

Giga (1,073,741,824) bytes or words.

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_irix5(7B), pbs_resources_sp2(7B), pbs_resources_sunos4(7B), pbs_resources_unicos8(7B)

branch: sisyphus


title: pbs_resources_aix5(7)

summary: pbs Resources on IBM AIX 5

text:
# pbs_resources_aix5(7)

## NAME
pbs_resources_aix5 - pbs Resources on IBM AIX 5

## DESCRIPTION
This page summarizes the resources supported by PBS for IBM systems running AIX version 5. These resources are specified for jobs by including them in the -l option argument on the qsub or qalter command or in the PBS job script.

## RESOURCES
cput

Maximum amount of CPU time used by all processes in the job. Units: time.

file

The largest size of any single file that may be created by the job. Units: size.

mem

Maximum amount of physical memory (workingset) used by the job. Units: size.

vmem

Maximum amount of virtual memory used by all concurrent processes in the job. Units: size.

nice

The nice value under which the job is to be run. Units: unitary.

pcput

Maximum amount of CPU time used by any single process in the job. Units: time.

pmem

Maximum amount of physical memory (workingset) used by any single process of the job. Units: size.

pvmem

Maximum amount of virtual memory used by any single process in the job. Units: size.

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 property or properties desired for the nodes. The number, the name, and each property 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 properties 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 properties 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 allowable 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

qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script

qalter -lcput=30:00,pmem=8mb 123.jobid

or in a qsub script as a directive:

\#PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb

## 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]

size

specifies the maximum amount in terms of bytes or words. It is expressed in the form integer[suffix] The suffix is a multiplier defined in the following table, The size of a word is the word size on the execution host.

b or w

bytes or words.

kb or kw

Kilo (1024) bytes or words.

mb or mw

Mega (1,048,576) bytes or words.

gb or gw

Giga (1,073,741,824) bytes or words.

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_irix5(7B), pbs_resources_sp2(7B), pbs_resources_sunos4(7B), pbs_resources_unicos8(7B)


title: pbs_resources_darwin(7)

summary: pbs resources on Darwin

text:
# pbs_resources_darwin(7)

## NAME
pbs_resources_darwin - pbs resources on Darwin

## DESCRIPTION
This page summarizes the resources supported by PBS for PC workstations running Darwin. 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
cput

Maximum amount of CPU time used by all processes in the job. Units: time.

file

The largest size of any single file that may be created by the job. Units: size.

nice

The nice value under which the job is to be run. Units: unitary.

pcput

Maximum amount of CPU time used by any single process in the job. Units: time.

pmem

Maximum amount of physical memory (workingset) used by any single process of the job. Units: size.

pvmem

Maximum amount of virtual memory used by any single process in the job. Units: size.

vmem

Maximum amount of virtual memory used by all concurrent processes in the job. Units: size.

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 property or properties desired for the nodes. The number, the name, and each property 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 properties 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 properties 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 allowable 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

qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script

qalter -lcput=30:00,pmem=8mb 123.jobid

or in a qsub script as a directive:

\#PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb

## 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]

size

specifies the maximum amount in terms of bytes or words. It is expressed in the form integer[suffix] The suffix is a multiplier defined in the following table, The size of a word is the word size on the execution host.

b or w

bytes or words.

kb or kw

Kilo (1024) bytes or words.

mb or mw

Mega (1,048,576) bytes or words.

gb or gw

Giga (1,073,741,824) bytes or words.

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_sp2(7B), pbs_resources_sunos4(7B), pbs_resources_unicos8(7B)


title: pbs_resources_digitalunix(7)

summary: pbs resources on DEC Unix

text:
# pbs_resources_digitalunix(7)

## NAME
pbs_resources_digitalunix - pbs resources on DEC Unix

## DESCRIPTION
This page summarizes the resources supported by PBS for DEC systems running Digital Unix 5. 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
cput

Maximum amount of CPU time used by all processes in the job. Units: time.

file

The largest size of any single file that may be created by the job. Units: size.

nice

The nice value under which the job is to be run. Units: unitary.

pcput

Maximum amount of CPU time used by any single process in the job. Units: time.

pvmem

Maximum amount of virtual memory used by any single process in the job. Units: size.

vmem

Maximum amount of virtual memory used by all concurrent processes in the job. Units: size.

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 property or properties desired for the nodes. The number, the name, and each property 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 properties 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 properties 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 allowable 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

qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script

qalter -lcput=30:00,pmem=8mb 123.jobid

or in a qsub script as a directive:

\#PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb

## 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]

size

specifies the maximum amount in terms of bytes or words. It is expressed in the form integer[suffix] The suffix is a multiplier defined in the following table, The size of a word is the word size on the execution host.

b or w

bytes or words.

kb or kw

Kilo (1024) bytes or words.

mb or mw

Mega (1,048,576) bytes or words.

gb or gw

Giga (1,073,741,824) bytes or words.

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_sp2(7B), pbs_resources_sunos4(7B), pbs_resources_unicos8(7B)


title: pbs_resources_freebsd(7)

summary: pbs resources on FreeBSD

text:
# pbs_resources_freebsd(7)

## NAME
pbs_resources_freebsd - pbs resources on FreeBSD

## DESCRIPTION
This page summarizes the resources supported by PBS for AMD/Intel/Cyrix workstations running FreeBSD. 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
cput

Maximum amount of CPU time used by all processes in the job. Units: time.

file

The largest size of any single file that may be created by the job. Units: size.

nice

The nice value under which the job is to be run. Units: unitary.

pcput

Maximum amount of CPU time used by any single process in the job. Units: time.

pmem

Maximum amount of physical memory (workingset) used by any single process of the job. Units: size.

pvmem

Maximum amount of virtual memory used by any single process in the job. Units: size.

vmem

Maximum amount of virtual memory used by all concurrent processes in the job. Units: size.

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 property or properties desired for the nodes. The number, the name, and each property 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 properties 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 properties 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 allowable 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

qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script

qalter -lcput=30:00,pmem=8mb 123.jobid

or in a qsub script as a directive:

\#PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15

## 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]

size

specifies the maximum amount in terms of bytes or words. It is expressed in the form integer[suffix] The suffix is a multiplier defined in the following table, The size of a word is the word size on the execution host.

b or w

bytes or words.

kb or kw

Kilo (1024) bytes or words.

mb or mw

Mega (1,048,576) bytes or words.

gb or gw

Giga (1,073,741,824) bytes or words.

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)


title: pbs_resources_fujitsu(7)

summary: pbs resources on Fujitsu UXP/V

text:
# pbs_resources_fujitsu(7)

## NAME
pbs_resources_fujitsu - pbs resources on Fujitsu UXP/V

## DESCRIPTION
This page summarizes the resources supported by PBS for Fujitsu computers running UXP/V. 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
cput

Maximum amount of CPU time used by all processes in the job. Units: time.

file

The largest size of any single file that may be created by the job. Units: size.

nice

The nice value under which the job is to be run. Units: unitary.

pcput

Maximum amount of CPU time used by any single process in the job. Units: time.

pvmem

Maximum amount of virtual memory used by any single process in the job. Units: size.

vmem

Maximum amount of virtual memory used by all concurrent processes in the job. Units: size.

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 property or properties desired for the nodes. The number, the name, and each property 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 properties 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 properties 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 allowable 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

qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script

qalter -lcput=30:00,pmem=8mb 123.jobid

or in a qsub script as a directive:

\#PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb

## 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]

size

specifies the maximum amount in terms of bytes or words. It is expressed in the form integer[suffix] The suffix is a multiplier defined in the following table, The size of a word is the word size on the execution host.

b or w

bytes or words.

kb or kw

Kilo (1024) bytes or words.

mb or mw

Mega (1,048,576) bytes or words.

gb or gw

Giga (1,073,741,824) bytes or words.

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_sp2(7B), pbs_resources_sunos4(7B), pbs_resources_unicos8(7B)


title: pbs_resources_hpux10(7)

summary: pbs resources on HP UX

text:
# pbs_resources_hpux10(7)

## NAME
pbs_resources_hpux10 - pbs resources on HP UX

## DESCRIPTION
This page summarizes the resources supported by PBS for systems running HP UX version 10.x. 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
cput

Maximum amount of CPU time used by all processes in the job. Units: time.

file

The largest size of any single file that may be created by the job. Units: size.

nice

The nice value under which the job is to be run. Units: unitary.

pcput

Maximum amount of CPU time used by any single process in the job. Units: time.

pvmem

Maximum amount of virtual memory used by any single process in the job. Units: size.

vmem

Maximum amount of virtual memory used by all concurrent processes in the job. Units: size.

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 property or properties desired for the nodes. The number, the name, and each property 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 properties 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 properties 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 allowable 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

qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script

qalter -lcput=30:00,pmem=8mb 123.jobid

or in a qsub script as a directive:

\#PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb

## 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]

size

specifies the maximum amount in terms of bytes or words. It is expressed in the form integer[suffix] The suffix is a multiplier defined in the following table, The size of a word is the word size on the execution host.

b or w

bytes or words.

kb or kw

Kilo (1024) bytes or words.

mb or mw

Mega (1,048,576) bytes or words.

gb or gw

Giga (1,073,741,824) bytes or words.

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_sp2(7B), pbs_resources_sunos4(7B), pbs_resources_unicos8(7B)


title: pbs_resources_hpux11(7)

summary: pbs resources on HP UX

text:
# pbs_resources_hpux11(7)

## NAME
pbs_resources_hpux11 - pbs resources on HP UX

## DESCRIPTION
This page summarizes the resources supported by PBS for systems running HP UX version 11.x. 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
cput

Maximum amount of CPU time used by all processes in the job. Units: time.

file

The largest size of any single file that may be created by the job. Units: size.

nice

The nice value under which the job is to be run. Units: unitary.

pcput

Maximum amount of CPU time used by any single process in the job. Units: time.

pvmem

Maximum amount of virtual memory used by any single process in the job. Units: size.

vmem

Maximum amount of virtual memory used by all concurrent processes in the job. Units: size.

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 property or properties desired for the nodes. The number, the name, and each property 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 properties 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 properties 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 allowable 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

qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script

qalter -lcput=30:00,pmem=8mb 123.jobid

or in a qsub script as a directive:

\#PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb

## 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]

size

specifies the maximum amount in terms of bytes or words. It is expressed in the form integer[suffix] The suffix is a multiplier defined in the following table, The size of a word is the word size on the execution host.

b or w

bytes or words.

kb or kw

Kilo (1024) bytes or words.

mb or mw

Mega (1,048,576) bytes or words.

gb or gw

Giga (1,073,741,824) bytes or words.

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_sp2(7B), pbs_resources_sunos4(7B), pbs_resources_unicos8(7B)


title: pbs_resources_irix5(7)

summary: pbs resources on SGI Irix

text:
# pbs_resources_irix5(7)

## NAME
pbs_resources_irix - pbs resources on SGI Irix

## DESCRIPTION
This page summarizes the resources supported by PBS for SGI workstations running IRIX 5. 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
cput

Maximum amount of CPU time used by all processes in the job. Units: time.

file

The largest size of any single file that may be created by the job. Units: size.

nice

The nice value under which the job is to be run. Units: unitary.

pcput

Maximum amount of CPU time used by any single process in the job. Units: time.

pmem

Maximum amount of physical memory (workingset) used by any single process of the job. Units: size.

pvmem

Maximum amount of virtual memory used by any single process in the job. Units: size.

vmem

Maximum amount of virtual memory used by all concurrent processes in the job. Units: size.

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 property or properties desired for the nodes. The number, the name, and each property 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 properties 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 properties 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 allowable 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

qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script

qalter -lcput=30:00,pmem=8mb 123.jobid

or in a qsub script as a directive:

\#PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb

## 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]

size

specifies the maximum amount in terms of bytes or words. It is expressed in the form integer[suffix] The suffix is a multiplier defined in the following table, The size of a word is the word size on the execution host.

b or w

bytes or words.

kb or kw

Kilo (1024) bytes or words.

mb or mw

Mega (1,048,576) bytes or words.

gb or gw

Giga (1,073,741,824) bytes or words.

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_sp2(7B), pbs_resources_sunos4(7B), pbs_resources_unicos8(7B)


title: pbs_resources_irix6(7)

summary: pbs resources on SGI Irix

text:
# pbs_resources_irix6(7)

## NAME
pbs_resources_irix - pbs resources on SGI Irix

## DESCRIPTION
This page summarizes the resources supported by PBS for SGI workstations running IRIX 6. 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
cput

Maximum amount of CPU time used by all processes in the job. Units: time.

file

The largest size of any single file that may be created by the job. Units: size.

ncpus

The number of processors requested. Units: unitary.

cpupercent

The maximum percentage of a cpu which the job used. A value of 100 means 1 cpu. This cannot be set, it is only reported. Units: percent.

nice

The nice value under which the job is to be run. Units: unitary.

nodemask

A bit mask specifying the nodes (a pair of processors) to be associated with this job. This resource is intended for use by PBS to optimize processor allocation and direct use of this field by the job owner is discouraged. Units: bit mask.

pcput

Maximum amount of CPU time used by any single process in the job. Units: time.

pmem

Maximum amount of physical memory (workingset) used by any single process of the job. Units: size.

pvmem

Maximum amount of virtual memory used by any single process in the job. Units: size.

vmem

Maximum amount of virtual memory used by all concurrent processes in the job. Units: size.

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 property or properties desired for the nodes. The number, the name, and each property 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 properties 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 properties 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 allowable 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

qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,vmem=15mb script

qalter -lcput=30:00,pmem=8mb 123.jobid

or in a qsub script as a directive:

\#PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb

## 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]

size

specifies the maximum amount in terms of bytes or words. It is expressed in the form integer[suffix] The suffix is a multiplier defined in the following table, The size of a word is the word size on the execution host.

b or w

bytes or words.

kb or kw

Kilo (1024) bytes or words.

mb or mw

Mega (1,048,576) bytes or words.

gb or gw

Giga (1,073,741,824) bytes or words.

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_sp2(7B), pbs_resources_sunos4(7B), pbs_resources_unicos8(7B)


title: pbs_resources_irix6array(7)

summary: pbs resources on SGI Irix

text:
# pbs_resources_irix6array(7)

## NAME
pbs_resources_irix - pbs resources on SGI Irix

## DESCRIPTION
This page summarizes the resources supported by PBS for SGI workstations running IRIX 6. 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
cput

Maximum amount of CPU time used by all processes in the job. Units: time.

file

The largest size of any single file that may be created by the job. Units: size.

ncpus

The number of processors requested. Units: unitary.

cpupercent

The maximum percentage of a cpu which the job used. A value of 100 means 1 cpu. This cannot be set, it is only reported. Units: percent.

nice

The nice value under which the job is to be run. Units: unitary.

nodemask

A bit mask specifying the nodes (a pair of processors) to be associated with this job. This resource is intended for use by PBS to optimize processor allocation and direct use of this field by the job owner is discouraged. Units: bit mask.

pcput

Maximum amount of CPU time used by any single process in the job. Units: time.

pmem

Maximum amount of physical memory (workingset) used by any single process of the job. Units: size.

pvmem

Maximum amount of virtual memory used by any single process in the job. Units: size.

vmem

Maximum amount of virtual memory used by all concurrent processes in the job. Units: size.

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 property or properties desired for the nodes. The number, the name, and each property 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 properties 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 properties 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 allowable 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

qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script

qalter -lcput=30:00,pmem=8mb 123.jobid

or in a qsub script as a directive:

\#PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb

## 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]

size

specifies the maximum amount in terms of bytes or words. It is expressed in the form integer[suffix] The suffix is a multiplier defined in the following table, The size of a word is the word size on the execution host.

b or w

bytes or words.

kb or kw

Kilo (1024) bytes or words.

mb or mw

Mega (1,048,576) bytes or words.

gb or gw

Giga (1,073,741,824) bytes or words.

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_sp2(7B), pbs_resources_sunos4(7B), pbs_resources_unicos8(7B)


title: pbs_resources_linux(7)

summary: pbs resources on Linux

text:
# pbs_resources_linux(7)

## NAME
pbs_resources_linux - pbs resources on Linux

## DESCRIPTION
This page summarizes the resources supported by PBS for PC workstations running Linux. 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
cput

Maximum amount of CPU time used by all processes in the job. Units: time.

file

The largest size of any single file that may be created by the job. Units: size.

nice

The nice value under which the job is to be run. Units: unitary.

pcput

Maximum amount of CPU time used by any single process in the job. Units: time.

pmem

Maximum amount of physical memory (workingset) used by any single process of the job. Units: size.

pvmem

Maximum amount of virtual memory used by any single process in the job. Units: size.

vmem

Maximum amount of virtual memory used by all concurrent processes in the job. Units: size.

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 property or properties desired for the nodes. The number, the name, and each property 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 properties 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 properties 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 allowable 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

qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script

qalter -lcput=30:00,pmem=8mb 123.jobid

or in a qsub script as a directive:

\#PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb

## 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]

size

specifies the maximum amount in terms of bytes or words. It is expressed in the form integer[suffix] The suffix is a multiplier defined in the following table, The size of a word is the word size on the execution host.

b or w

bytes or words.

kb or kw

Kilo (1024) bytes or words.

mb or mw

Mega (1,048,576) bytes or words.

gb or gw

Giga (1,073,741,824) bytes or words.

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_sp2(7B), pbs_resources_sunos4(7B), pbs_resources_unicos8(7B)


title: pbs_resources_netbsd(7)

summary: pbs resources on NetBSD

text:
# pbs_resources_netbsd(7)

## NAME
pbs_resources_netbsd - pbs resources on NetBSD

## DESCRIPTION
This page summarizes the resources supported by PBS for workstations running NetBSD on various hardware architectures. 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
cput

Maximum amount of CPU time used by all processes in the job. Units: time.

file

The largest size of any single file that may be created by the job. Units: size.

nice

The nice value under which the job is to be run. Units: unitary.

pcput

Maximum amount of CPU time used by any single process in the job. Units: time.

pmem

Maximum amount of physical memory (workingset) used by any single process of the job. Units: size.

pvmem

Maximum amount of virtual memory used by any single process in the job. Units: size.

vmem

Maximum amount of virtual memory used by all concurrent processes in the job. Units: size.

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 property or properties desired for the nodes. The number, the name, and each property 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 properties 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 properties 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 allowable 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

qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script

qalter -lcput=30:00,pmem=8mb 123.jobid

or in a qsub script as a directive:

\#PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15

## 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]

size

specifies the maximum amount in terms of bytes or words. It is expressed in the form integer[suffix] The suffix is a multiplier defined in the following table, The size of a word is the word size on the execution host.

b or w

bytes or words.

kb or kw

Kilo (1024) bytes or words.

mb or mw

Mega (1,048,576) bytes or words.

gb or gw

Giga (1,073,741,824) bytes or words.

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)


title: pbs_resources_solaris5(7)

summary: pbs resources on SUN Solaris

text:
# pbs_resources_solaris5(7)

## NAME
pbs_resources_solaris - pbs resources on SUN Solaris

## DESCRIPTION
This page summarizes the resources supported by PBS for Sun workstations running Solaris 2.x. 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
cput

Maximum amount of CPU time used by all processes in the job. Units: time.

file

The largest size of any single file that may be created by the job. Units: size.

nice

The nice value under which the job is to be run. Units: unitary.

pcput

Maximum amount of CPU time used by any single process in the job. Units: time.

pmem

Maximum amount of physical memory (workingset) used by any single process of the job. Units: size.

pvmem

Maximum amount of virtual memory used by any single process in the job. Units: size.

vmem

Maximum amount of virtual memory used by all concurrent processes in the job. Units: size.

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 property or properties desired for the nodes. The number, the name, and each property 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 properties 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 properties 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 allowable 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

qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,vmem=15mb script

qalter -lcput=30:00 123.jobid

or in a qsub script as a directive:

\#PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,vmem=15mb

## 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]

size

specifies the maximum amount in terms of bytes or words. It is expressed in the form integer[suffix] The suffix is a multiplier defined in the following table, The size of a word is the word size on the execution host.

b or w

bytes or words.

kb or kw

Kilo (1024) bytes or words.

mb or mw

Mega (1,048,576) bytes or words.

gb or gw

Giga (1,073,741,824) bytes or words.

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_sp2(7B), pbs_resources_sunos4(7B), pbs_resources_unicos8(7B)


title: pbs_resources_solaris7(7)

summary: pbs resources on SUN Solaris

text:
# pbs_resources_solaris7(7)

## NAME
pbs_resources_solaris - pbs resources on SUN Solaris

## DESCRIPTION
This page summarizes the resources supported by PBS for Sun workstations running Solaris 2.x. 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
cput

Maximum amount of CPU time used by all processes in the job. Units: time.

file

The largest size of any single file that may be created by the job. Units: size.

nice

The nice value under which the job is to be run. Units: unitary.

pcput

Maximum amount of CPU time used by any single process in the job. Units: time.

pmem

Maximum amount of physical memory (workingset) used by any single process of the job. Units: size.

pvmem

Maximum amount of virtual memory used by any single process in the job. Units: size.

vmem

Maximum amount of virtual memory used by all concurrent processes in the job. Units: size.

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 property or properties desired for the nodes. The number, the name, and each property 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 properties 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 properties 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 allowable 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

qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,vmem=15mb script

qalter -lcput=30:00 123.jobid

or in a qsub script as a directive:

\#PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,vmem=15mb

## 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]

size

specifies the maximum amount in terms of bytes or words. It is expressed in the form integer[suffix] The suffix is a multiplier defined in the following table, The size of a word is the word size on the execution host.

b or w

bytes or words.

kb or kw

Kilo (1024) bytes or words.

mb or mw

Mega (1,048,576) bytes or words.

gb or gw

Giga (1,073,741,824) bytes or words.

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_sp2(7B), pbs_resources_sunos4(7B), pbs_resources_unicos8(7B)


title: pbs_resources_sp2(7)

summary: pbs resources on IBM SP-2

text:
# pbs_resources_sp2(7)

## 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 property or properties desired for the nodes. The number, the name, and each property 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 properties 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 properties 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 allowable 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)


title: pbs_resources_sunos4(7)

summary: pbs resources on SunOS 4

text:
# pbs_resources_sunos4(7)

## NAME
pbs_resources_sunos4 - pbs resources on SunOS 4

## DESCRIPTION
This page summarizes the resources supported by PBS for Sun workstations running SunOS 4.x. 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
cput

Maximum amount of CPU time used by all processes in the job. Units: time.

file

The largest size of any single file that may be created by the job. Units: size.

nice

The nice value under which the job is to be run. Units: unitary.

pcput

Maximum amount of CPU time used by any single process in the job. Units: time.

pmem

Maximum amount of physical memory (workingset) used by any single process of the job. Units: size.

pvmem

Maximum amount of virtual memory used by any single process in the job. Units: size.

vmem

Maximum amount of virtual memory used by all concurrent processes in the job. Units: size.

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 property or properties desired for the nodes. The number, the name, and each property 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 properties 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 properties 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 allowable 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

qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script

qalter -lcput=30:00,pmem=8mb 123.jobid

or in a qsub script as a directive:

\#PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15

## 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]

size

specifies the maximum amount in terms of bytes or words. It is expressed in the form integer[suffix] The suffix is a multiplier defined in the following table, The size of a word is the word size on the execution host.

b or w

bytes or words.

kb or kw

Kilo (1024) bytes or words.

mb or mw

Mega (1,048,576) bytes or words.

gb or gw

Giga (1,073,741,824) bytes or words.

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_sp2(7B), pbs_resources_unicos8(7B)