/usr/share/globus/globus_gram_job_manager/globus-gram-job-manager.rvf is in globus-gram-job-manager 14.27-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 | # RSL Validation Information for the base RSL supported by the job
# manager
Attribute: directory
Description: "Specifies the path of the directory the jobmanager will use as
the default directory for the requested job."
Default: $(HOME)
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT
DefaultWhen: GLOBUS_GRAM_JOB_SUBMIT
Attribute: executable
Description: "The name of the executable file to run on the remote machine.
If the value is a GASS URL, the file is transferred to the
remote gass cache before executing the job and removed after
the job has terminated."
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT
RequiredWhen: GLOBUS_GRAM_JOB_SUBMIT
Attribute: arguments
Description: "The command line arguments for the executable. Use quotes, if a
space is required in a single argument."
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT
Attribute: stdin
Description: "The name of the file to be used as standard input for the
executable on the remote machine. If the value is a GASS URL,
the file is transferred to the remote gass cache before
executing the job and removed after the job has terminated."
Default: "/dev/null"
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT
DefaultWhen: GLOBUS_GRAM_JOB_SUBMIT
Attribute: stdout
Description: "The name of the remote file to store the standard output from
the job. If the value is a GASS URL, the standard output from
the job is transferred dynamically during the execution of the
job. There are two accepted forms of this value. It can consist
of a single destination: stdout = URL, or a sequence of
destinations: stdout = (DESTINATION) (DESTINATION). In the latter
case, the DESTINATION may itself be a URL or a sequence of an
x-gass-cache URL followed by a cache tag."
Default: "/dev/null"
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT GLOBUS_GRAM_JOB_MANAGER_RESTART GLOBUS_GRAM_JOB_MANAGER_STDIO_UPDATE
DefaultWhen: GLOBUS_GRAM_JOB_SUBMIT
Attribute: stderr
Description: "The name of the remote file to store the standard error from
the job. If the value is a GASS URL, the standard error from
the job is transferred dynamically during the execution of the
job. There are two accepted forms of this value. It can consist
of a single destination: stderr = URL, or a sequence of
destinations: stderr = (DESTINATION) (DESTINATION). In the latter
case, the DESTINATION may itself be a URL or a sequence of an
x-gass-cache URL followed by a cache tag."
Default: "/dev/null"
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT GLOBUS_GRAM_JOB_MANAGER_RESTART GLOBUS_GRAM_JOB_MANAGER_STDIO_UPDATE
DefaultWhen: GLOBUS_GRAM_JOB_SUBMIT
Attribute: count
Description: "The number of executions of the executable."
Default: 1
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT
DefaultWhen: GLOBUS_GRAM_JOB_SUBMIT
Attribute: environment
Description: "The environment variables that will be defined for the
executable in addition to default set that is given to the job
by the jobmanager."
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT
Attribute: max_time
Description: "The maximum walltime or cputime for a single execution of the
executable. Walltime or cputime is selected by the GRAM
scheduler being interfaced. The units is in minutes. The value
will go through an atoi() conversion in order to get an
integer."
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT
Attribute: max_wall_time
Description: "Explicitly set the maximum walltime for a single execution of
the executable. The units is in minutes. The value will go
through an atoi() conversion in order to get an integer. If the
GRAM scheduler cannot set walltime, then an error will be
returned. "
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT
Attribute: max_cpu_time
Description: "Explicitly set the maximum cputime for a single execution of
the executable. The units is in minutes. The value will go
through an atoi() conversion in order to get an integer. If the
GRAM scheduler cannot set cputime, then an error will be
returned."
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT
Attribute: job_type
Description: "This specifies how the jobmanager should start the job.
Possible values are single (even if the count > 1, only start
1 process or thread), multiple (start count processes or threads),
mpi (use the appropriate method (e.g. mpirun) to start a program
compiled with a vendor-provided MPI library. Program is started
with count nodes), and condor (starts condor jobs in the
\"condor\" universe.)"
Values: single multiple mpi condor
Default: multiple
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT
DefaultWhen: GLOBUS_GRAM_JOB_SUBMIT
Attribute: gram_my_job
Description: "Obsolete and ignored."
Values: collective independent
Default: collective
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT
DefaultWhen: GLOBUS_GRAM_JOB_SUBMIT
Attribute: queue
Description: "Target the job to a queue (class) name as defined by the
scheduler at the defined (remote) resource."
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT
Attribute: project
Description: "Target the job to be allocated to a project account as defined
by the scheduler at the defined (remote) resource."
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT
Attribute: host_count
Description: "Only applies to clusters of SMP computers, such as newer IBM SP
systems. Defines the number of nodes (\"pizza boxes\") to
distribute the \"count\" processes across."
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT
Attribute: dry_run
Description: "If dryrun = yes then the jobmanager will not submit the job for
execution and will return success."
Default: no
Values: yes no
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT
DefaultWhen: GLOBUS_GRAM_JOB_SUBMIT
Attribute: min_memory
Description: "Explicitly set the minimum amount of memory for a single execution
of the executable. The units is in Megabytes. The value will go
through an atoi() conversion in order to get an integer. If the
GRAM scheduler cannot set minMemory, then an error will be
returned."
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT
Attribute: max_memory
Description: "Explicitly set the maximum amount of memory for a single execution
of the executable. The units is in Megabytes. The value will go
through an atoi() conversion in order to get an integer. If the
GRAM scheduler cannot set maxMemory, then an error will be
returned."
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT
Attribute: save_state
Description: "Causes the jobmanager to save it's job state information to a
persistent file on disk. If the job manager exits or is
suspended, the client can later start up a new job manager
which can continue monitoring the job."
Values: yes no
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT
Attribute: two_phase
Description: "Use a two-phase commit for job submission and completion. The
job manager will respond to the initial job request with a
WAITING_FOR_COMMIT error. It will then wait for a signal from
the client before doing the actual job submission. The integer
supplied is the number of seconds the job manager should wait
before timing out. If the job manager times out before
receiving the commit signal, or if a client issues a cancel
signal, the job manager will clean up the job's files and exit,
sending a callback with the job status as
GLOBUS_GRAM_PROTOCOL_JOB_STATE_FAILED.
After the job manager sends a DONE or FAILED callback, it will
wait for a commit signal from the client. If it receives one,
it cleans up and exits as usual. If it times out and save_state
was enabled, it will leave all of the job's files in place and
exit (assuming the client is down and will attempt a job
restart later). The timeoutvalue can be extended via a signal.
When one of the following errors occurs, the job manager does
not delete the job state file when it exits:
GLOBUS_GRAM_PROTOCOL_ERROR_COMMIT_TIMED_OUT,
GLOBUS_GRAM_PROTOCOL_ERROR_TTL_EXPIRED,
GLOBUS_GRAM_PROTOCOL_ERROR_JM_STOPPED,
GLOBUS_GRAM_PROTOCOL_ERROR_USER_PROXY_EXPIRED.
In these cases, it can not be restarted, so the job manager
will not wait for the commit signal after sending the FAILED
callback"
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT
Attribute: remote_io_url
Description: "Writes the given value (a URL base string) to a file, and adds
the path to that file to the environment through the
GLOBUS_REMOTE_IO_URL environment variable. If this is specified
as part of a job restart RSL, the job manager will update the
file's contents. This is intended for jobs that want to access
files via GASS, but the URL of the GASS server has changed due
to a GASS server restart."
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT GLOBUS_GRAM_JOB_MANAGER_RESTART GLOBUS_GRAM_JOB_MANAGER_STDIO_UPDATE
Attribute: scratch_dir
Description: "Specifies the location to create a scratch subdirectory in.
A SCRATCH_DIRECTORY RSL substitution will be filled with the
name of the directory which is created."
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT
Attribute: rsl_substitution
Description: "Specifies a list of values which can be substituted into other
rsl attributes' values through the $(SUBSTITUTION) mechanism."
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT GLOBUS_GRAM_JOB_MANAGER_RESTART
Attribute: restart
Description: "Start a new job manager, but instead of submitting a new job,
start managing an existing job. The job manager will search for
the job state file created by the original job manager. If it
finds the file and successfully reads it, it will become the
new manager of the job, sending callbacks on status and
streaming stdout/err if appropriate. It will fail if it detects
that the old jobmanager is still alive (via a timestamp in the
state file). If stdout or stderr was being streamed over the
network, new stdout and stderr attributes can be specified in
the restart RSL and the jobmanager will stream to the new
locations (useful when output is going to a GASS server started
by the client that's listening on a dynamic port, and the
client was restarted). The new job manager will return a new
contact string that should be used to communicate with it. If a
jobmanager is restarted multiple times, any of the previous
contact strings can be given for the restart attribute."
RequiredWhen: GLOBUS_GRAM_JOB_MANAGER_RESTART
ValidWhen: GLOBUS_GRAM_JOB_MANAGER_RESTART
Attribute: stdout_position
Description: "Specifies where in the file remote output streaming should be
restarted from. Must be 0."
ValidWhen: GLOBUS_GRAM_JOB_MANAGER_RESTART GLOBUS_GRAM_JOB_MANAGER_STDIO_UPDATE
Values: 0
Attribute: stderr_position
Description: "Specifies where in the file remote standard error streaming
should be restarted from. Must be 0."
ValidWhen: GLOBUS_GRAM_JOB_MANAGER_RESTART GLOBUS_GRAM_JOB_MANAGER_STDIO_UPDATE
Values: 0
Attribute: file_stage_in
Description: "Specifies a list of (\"remote URL\" \"local file\") pairs which
indicate files to be staged to the nodes which will run the
job."
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT
Attribute: file_stage_in_shared
Description: "Specifies a list of (\"remote URL\" \"local file\") pairs which
indicate files to be staged into the cache. A symlink from the
cache to the \"local file\" path will be made."
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT
Attribute: file_stage_out
Description: "Specifies a list of (\"local file\" \"remote URL\") pairs which
indicate files to be staged from the job to a GASS-compatible
file server."
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT
Attribute: file_clean_up
Description: "Specifies a list of files which will be removed after the job
is completed."
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT
Attribute: gass_cache
Description: Specifies location to override the GASS cache location.
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT
Attribute: proxy_timeout
Description: "Obsolete and ignored. Now a job-manager-wide setting."
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT GLOBUS_GRAM_JOB_MANAGER_RESTART
Attribute: library_path
Description: "Specifies a list of paths to be appended to the system-specific
library path environment variables."
Default: $(GLOBUS_LOCATION)/lib
DefaultWhen: GLOBUS_GRAM_JOB_SUBMIT
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT
Attribute: username
Description: Verify that the job is running as this user.
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT
Attribute: restartcontacts
Description: "When restarting, use job state callback contacts from the
original request. Internally generated."
ValidWhen: GLOBUS_GRAM_JOB_MANAGER_RESTART
Values: yes no
Default: no
DefaultWhen: GLOBUS_GRAM_JOB_MANAGER_RESTART
Publish: false
Attribute: savejobdescription
Description: "Save a copy of the job description to $HOME"
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT
Values: yes no
Default: no
DefaultWhen: GLOBUS_GRAM_JOB_SUBMIT
Attribute: loglevel
Description: "Override the default log level for this job. The value of this
attribute consists of a combination of the strings
FATAL, ERROR, WARN, INFO, DEBUG, TRACE joined by the | character"
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT
Attribute: logpattern
Description: "Override the default log path pattern for this job. The value of
this attribute is a string (potentially containing RSL
substitutions) that is evaluated to the path to write the log to.
If the resulting string contains the string $(DATE) (or any other
RSL substitution), it will be reevaluated at log time."
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT
# default value is 4 hours
Attribute: expiration
Description: "Time (in seconds) after a a job fails to receive a two-phase
commit end signal before it is cleaned up."
ValidWhen: GLOBUS_GRAM_JOB_SUBMIT
Default: 14400
DefaultWhen: GLOBUS_GRAM_JOB_SUBMIT
|