1globus_gram_job_manager_rsl_vgalloibdugasltoigborunas_m_fgijrloaebm(_3mj)aonba_gmearnager_rsl_validation_file(3)
2
3
4

NAME

6       globus_gram_job_manager_rsl_validation_file - RSL Validation File
7       Format The idea behind the RSL Validation file is to provide a
8       mechanism for job manager scheduler interfaces to implement RSL
9       extensions, while having the job manager still be able to decide
10       whether a job request contains a valid RSL string.
11
12       In addition to indicating what RSL attributes are valid, the RSL
13       validation file contains information about when the RSL attribute may
14       be used, it's default value, and the format of the attribute's value.
15

File Format

17   Comments
18       The RSL validation file may contain comments. Comments are indicated in
19       the file by a line beginning with the # character. Comments continue
20       until end-of-line. Comments are discarded by the RSL Validation File
21       parser.
22
23       Example:
24
25       # I am a comment. Ignore me.
26
27   ValidationRecords
28       The RSL validition file consists of a set of ValidationRecords. Each
29       ValidationRecord consists of a number of ValidationProperties
30       associated with a single RSL attribute. ValidationRecords are separated
31       by a blank line in the RSL validation file.
32
33   Validation Properties
34       A ValidationProperty is defined in the RSL validation file by a
35       PropertyName and a PropertyValue. The syntax of a validation property
36       is simply the PropertyName followed by a colon character, followed by a
37       PropertyValue.
38
39       If a PropertyValue begins with a double-quote, then it may span
40       multiple lines. Double-quote characters within a multiline
41       PropertyValue must be escaped by a preceding backslash character. An
42       unquoted PropertyValue ends at the first newline character.
43
44       Example:
45
46       Attribute: directory
47       Description: 'Specifies the path of the directory the jobmanager will
48                     use as the default directory for the requested job.'
49
50   Defined PropertyNames
51       The following PropertyNames are understood by this version of the RSL
52       validation file parser. Any unknown PropertyName will cause the
53       ValidationProprty to be ignored by the parser.
54
55       Attribute
56           The name of the RSL parameter to which this record refers.
57
58       Description
59           A textual description of what the RSL parameter means.
60
61       Default
62           The default value of the RSL parameter if it is not found in the
63           RSL. The default value is only used if the DefaultWhen value
64           matches the current validation mode.
65
66       Values
67           A string containing whitespace-separated list of enumerated values
68           which are valid for this RSL attribute. For example, for the
69           'dryrun' parameter, this may be 'yes no'.
70
71       RequiredWhen
72           Some subset of the 'when strings' (see below), indicating when the
73           RSL parameter is required for the RSL to be valid.
74
75       DefaultWhen
76           Some subset of the 'when strings' (see below) indicating when then
77           RSL's default value will be used if the RSL attribute is not
78           present in the RSL.
79
80       ValidWhen
81           Some subset of the 'when strings' (see below) indicating when then
82           RSL attribute may be used.
83
84   'When' Strings
85       The set of when strings understood by the RSL validation file parser
86       are
87
88       GLOBUS_GRAM_JOB_SUBMIT
89           The RSL attribute pertains to job submission.
90
91       GLOBUS_GRAM_JOB_MANAGER_RESTART
92           The RSL attribute pertains to job manager restart.
93
94       GLOBUS_GRAM_JOB_MANAGER_STDIO_UPDATE
95           The RSL attribute pertains to the STDIO_UPDATE signal.
96
97Version 10.70                   TguleobJuusn_g7ra2m0_1j1ob_manager_rsl_validation_file(3)