|
Oracle Fusion Applications Java API Reference for Oracle Enterprise Scheduler Service 11g Release 1 (11.1.2) E20742-02 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object oracle.as.scheduler.SystemProperty
public class SystemProperty
Enterprise Scheduler system properties. System properties represent request parameters that are known to and used by the Enterprise Scheduler system in some manner.
System properties can be specified for application metadata and for request parameters when a request is submitted. Certain system properties are set Enterprise Scheduler when a request is submitted or at some point in the lifecycle of the request.
Most system properties are common to all job types while some system properties are specific to a particular job type. Unless indicated otherwise, assume that system properties defined by this class are common to all job types.
Enterprise Scheduler reserves "SYS_" (case-insensitive) propery name prefix for Enterprise Scheduler defined properties.
Field Summary | |
---|---|
static java.lang.String |
ALLOW_MULT_PENDING
Property that specifies whether multiple pending requests for the same JobDefinition shall be allowed. |
static java.lang.String |
APPLICATION
Property that specifies the name of the J2EE application that is used for request processing. |
static java.lang.String |
ASYNC_REQUEST_TIMEOUT
Property that specifies the time in minutes that the processor will wait for an asynchronous after it has begun execution. |
static java.lang.String |
BIZ_ERROR_EXIT_CODE
Property that specifies the process exit code for a Process job request that denotes an execution business error. |
static java.lang.String |
CLASS_NAME
Property that specifies the Java executable for a Java job request. |
static java.lang.String |
CMDLINE
Property that specifies the command line used to invoke an external program for a Process job request. |
static java.lang.String |
DEFAULT_EFFECTIVE_APPLICATION
|
static java.lang.String |
EFFECTIVE_APPLICATION
Property that specifies the name of the J2EE application that will be the effective application for the request. |
static java.lang.String |
ENVIRONMENT_VARIABLES
Property that specifies the environment variables to be set for the spawned process of a Process job request. |
static java.lang.String |
EXECUTE_PAST
Property that specifies whether instances of a repeating request with an execution time in the past should be generated. |
static java.lang.String |
EXTENSION_LISTENER
Property that specifies the extension event listener class associated with the request. |
static java.lang.String |
EXTERNAL_ID
Property that specifies an identifier for an external portion of an Enterprise Scheduler asynchronous Java job. |
static java.lang.String |
GROUP_NAME
Property that specifies the name of the ESS configuration group to which this request is bound. |
static java.lang.String |
INPUT_LIST
Property that specifies input to a request. |
static java.lang.String |
INPUT_WORK_DIR
Property that specifies the work directory used during request processing for input files. |
static java.lang.String |
LISTENER
Property that specifies the event listener class associated with the request. |
static java.lang.String |
LOCALE
Property that specifies the locale associated with the request. |
static java.lang.String |
LOG_WORK_DIR
Property that specifies the work directory used during request processing for log files. |
static java.lang.String |
OUTPUT_LIST
Property that specifies output from a request. |
static java.lang.String |
OUTPUT_LIST_DELIMITER
Delimiter to be used when building an OUTPUT_LIST value. |
static java.lang.String |
OUTPUT_WORK_DIR
Property that specifies the work directory used during request processing for output files. |
static java.lang.String |
POST_PROCESS
Property that specifies the post-process callout handler class. |
static java.lang.String |
PRE_PROCESS
Property that specifies the pre-process callout handler class. |
static java.lang.String |
PRIORITY
Property that specifies the request processing priority. |
static java.lang.String |
PROCEDURE_NAME
Property that specifies the name of the PLSQL stored procedure to be called for a SQL job request. |
static java.lang.String |
PRODUCT
Property that specifies the product within the application that submitted the request. |
static java.lang.String |
REDIRECTED_OUTPUT_FILE
Property that specifies the file where standard output and error streams are redirected for a Process job request. |
static java.lang.String |
REPROCESS_DELAY
Property that specifies the callout handler processing delay time. |
static java.lang.String |
REQUEST_CATEGORY
Property that specifies an application-specific label for a request. |
static java.lang.String |
REQUEST_EXPIRATION
Property that specifies the expiration time for a request. |
static java.lang.String |
REQUESTED_PROCESSOR
Property that specifies the request processor node on which the request should be processed. |
static java.lang.String |
RETRIES
Property that specifies the retry limit for a failed request. |
static java.lang.String |
RUNAS_APPLICATIONID
Property that specifies a job runas ApplicaitonId. |
static java.lang.String |
SELECT_STATE
Property that specifies whether the result state of a JobSet step should be included when determining the state of the JobSet. |
static java.lang.String |
SQL_JOB_CLASS
Property that specifies an Oracle Scheduler job class to be assigned to the Oracle Scheduler job used to execute an SQL job request. |
static java.lang.String |
SUBMITTING_APPLICATION
Property that specifies the name of the J2EE application for the submitted (absolute parent) request. |
static java.lang.String |
SUBSTITUTION_HANDLERS
Property that specifies a substitution handler class or list of classes that should be used for parameter substitution. |
static java.lang.String |
SUCCESS_EXIT_CODE
Property that specifies the process exit code for a Process job request that denotes an execution success. |
static java.lang.String |
SYS_PROPERTY_PREFIX
Property name prefix for Enterprise Scheduler system properties. |
static java.lang.String |
USER_FILE_DIR
Property that specifies a base directory in the file system where files, such as input and output files, may be stored for use by the request executable. |
static java.lang.String |
USER_NAME
Property that specifies the name of the user who submitted the request. |
static java.lang.String |
WARNING_EXIT_CODE
Property that specifies the process exit code for a Process job request that denotes an execution warning. |
static java.lang.String |
WORK_DIR_ROOT
Property that specifies the working directory for the spawned process of a Process job request. |
Constructor Summary | |
---|---|
SystemProperty()
|
Method Summary | |
---|---|
static java.util.Set<java.lang.String> |
getInternalOnlyProps()
Return the set of system properties that should not be set except by ESS internals. |
static java.util.Set<java.lang.String> |
getMetadataOnlyProps()
Return the set of system properties that can be set in meta-data but should not be set at submission. |
static java.util.Enumeration<java.lang.String> |
getNames()
Returns the names of the system properties. |
static java.util.Set<java.lang.String> |
getReadOnlySysProps()
Return the set of system properties that cannot be updated after submission through normal channels. |
static ParameterInfo |
getSysPropInfo(java.lang.String name)
Returns the information for the system property identified by the given name. |
static boolean |
isInternalOnly(java.lang.String name)
Determine if the given system property that should not be set except by ESS internals. |
static boolean |
isMetadataOnly(java.lang.String name)
Determine if the given system property can be set in meta-data but not at submission. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static final java.lang.String DEFAULT_EFFECTIVE_APPLICATION
public static final java.lang.String SYS_PROPERTY_PREFIX
public static final java.lang.String OUTPUT_LIST_DELIMITER
OUTPUT_LIST
value.
This constant does not represent a system property name. It is
simply the delimiter used to build the value for the
OUTPUT_LIST
property.
public static final java.lang.String APPLICATION
The property datatype is
STRING
.
public static final java.lang.String EFFECTIVE_APPLICATION
This property is valid only for metadata of a job or jobset definition.
It can be used to specify the J2EE application that should be used
for a request for that definition. At runtime request validation,
the value of this property is used to set the APPLICATION
system property for that request if it is present in the definition
metadata.
If this property is set in the metadata for a jobset, then at runtime,
this value is used to set the APPLICATION
property of that
JobSet request and all step requests of that jobset, unless the
EFFECTIVE_APPLICATION
property is set in the definiton for
a given step in which case the value from the definition for that
step has precedence.
The property datatype is
STRING
.
public static final java.lang.String SUBMITTING_APPLICATION
The property datatype is
STRING
.
public static final java.lang.String PRODUCT
The property datatype is
STRING
.
public static final java.lang.String USER_NAME
The property datatype is
STRING
.
public static final java.lang.String REQUEST_CATEGORY
The property datatype is
STRING
.
public static final java.lang.String GROUP_NAME
The property datatype is
STRING
.
public static final java.lang.String CLASS_NAME
Executable
interface.
This property is required for a
Java
job type.
It is not used for other job types.
The property datatype is
STRING
.
public static final java.lang.String PROCEDURE_NAME
schema.name
format.
The property is required for a
SQL
job type.
It is not used for other job types.
The property datatype is
STRING
.
public static final java.lang.String SQL_JOB_CLASS
Enterprise Scheduler uses an Oracle Scheduler job to execute the PLSQL stored procedure for a SQL job request. An Oracle Scheduler job class can be associated with the Scheduler job when that job needs to have affinity to a database service or is to be associated with an Oracle Database resource consumer group. The Oracle Scheduler job owner must have EXECUTE privilege on the Oracle Scheduler job class in order to successfully create a Scheduler job using that job class.
If this property is not specified,a default Oracle Scheduler job class is used for the Oracle Scheduler job. That job class is associated with the default resource consumer group. It will belong to the default service, which means it will have no service affinity and, in an Oracle RAC enviroment, any one of the database instances within the cluster might run the Scheduler job. No additional privilege grant is needed for an Enterprise Scheduler SQL request to use that default job class.
This property is optional for a
SQL
job type.
It is not used for other job types.
The property datatype is
STRING
.
public static final java.lang.String CMDLINE
This property is required for a
Process
job type.
It is not used for other job types.
Enterprise Scheduler will use the substitution handlers specified
by SUBSTITUTION_HANDLERS
along with a default handler
when evaluating the value for this property.
The property datatype is
STRING
.
public static final java.lang.String INPUT_LIST
Enterprise Scheduler imposes no format on the value of this property.
The property datatype is
STRING
.
public static final java.lang.String OUTPUT_LIST
OUTPUT_LIST
of the
last step. The output of a parallel JobSet is the concatenation of
the OUTPUT_LIST
of all the steps, in no guaranteed order,
with OUTPUT_LIST_DELIMITER
as a separator.
The property datatype is
STRING
.
public static final java.lang.String LOCALE
The property datatype is
STRING
.
public static final java.lang.String PRIORITY
The property datatype is
INTEGER
.
public static final java.lang.String RETRIES
The property datatype is
INTEGER
.
public static final java.lang.String PRE_PROCESS
PreProcessHandler
interface.
The property datatype is
STRING
.
public static final java.lang.String POST_PROCESS
PostProcessHandler
interface.
The property datatype is
STRING
.
public static final java.lang.String REPROCESS_DELAY
The property datatype is
INTEGER
.
PreProcessHandler
,
PostProcessHandler
,
Constant Field Valuespublic static final java.lang.String LISTENER
EventListener
interface.
The property datatype is
STRING
.
public static final java.lang.String EXTENSION_LISTENER
EventListener
interface.
The property datatype is
STRING
.
public static final java.lang.String REQUEST_EXPIRATION
The property datatype is
INTEGER
.
public static final java.lang.String ENVIRONMENT_VARIABLES
name=value
) representing the environment variables to be set.
This property is optional for a
Process
job type.
It is not used for other job types.
Enterprise Scheduler will use the substitution handlers specified
by SUBSTITUTION_HANDLERS
along with a default handler
when evaluating the value for this property.
The property datatype is
STRING
.
public static final java.lang.String WORK_DIR_ROOT
This property is optional for a
Process
job type.
It is not used for other job types.
The property datatype is
STRING
.
public static final java.lang.String LOG_WORK_DIR
public static final java.lang.String INPUT_WORK_DIR
public static final java.lang.String OUTPUT_WORK_DIR
public static final java.lang.String REDIRECTED_OUTPUT_FILE
This property is optional for a
Process
job type.
It is not used for other job types.
The property datatype is
STRING
.
public static final java.lang.String REQUESTED_PROCESSOR
If this property is specified for a request, the request processor's
WorkAssignment
s (specialization) must allow the execution
of such requests, otherwise the request will never be executed.
If the specified node is not running, the request will remain in
WAIT
state and will not be executed until the node is restarted.
The property datatype is
STRING
.
public static final java.lang.String SUCCESS_EXIT_CODE
This property is optional for a
Process
job type.
It is not used for other job types.
The property datatype is
STRING
.
public static final java.lang.String WARNING_EXIT_CODE
This property is optional for a
Process
job type.
It is not used for other job types.
The property datatype is
STRING
.
public static final java.lang.String BIZ_ERROR_EXIT_CODE
This property is optional for a
Process
job type.
It is not used for other job types.
The property datatype is
STRING
.
public static final java.lang.String EXECUTE_PAST
Note that a null requested start time defaults to the current time.
To cause past instances to be generated, you must set this property
to true
and specify the requested start time as the initial
time from which instances should be generated.
Valid values for this property are:
false
Instances with a scheduled execution time in the
past (that is, before the time of generation) will not be generated.
If this property is not specified, system default used is true
.
The property datatype is
BOOLEAN
.
public static final java.lang.String USER_FILE_DIR
Enterprise Scheduler supports a configuration parameter that
specifies a file directory where requests may store files.
At request submission, a USER_FILE_DIR
property will
automatically be added for the request if the configuration
parameter is currently set and USER_FILE_DIR
property
was not specified for the request. If the property is added, it
will be initialized to the value of the configuration parameter.
The property will not be added if the configuration parameter is
not set at time of request submission.
The property datatype is
STRING
.
public static final java.lang.String ALLOW_MULT_PENDING
Valid values for this property are:
true
Multiple pending requests are allowed.
false
Multiple pending requests are not allowed.
If this property is not specified, system default used is true
.
The property datatype is
BOOLEAN
.
public static final java.lang.String SELECT_STATE
Valid values for this property are:
true
Include the step's state as part of the JobSet state.
false
Do not include the step's state as part of the
JobSet state.
If this property is not specified, system default used is true
.
The property datatype is
BOOLEAN
.
public static final java.lang.String SUBSTITUTION_HANDLERS
The Java class must implement the
SubstitutionHandler
interface.
Enterprise Scheduler will use this property when executing a
Process
job type to
provide substition support for the CMDLINE
and
ENVIRONMENT_VARIABLES
system properties.
The property datatype is
STRING
.
public static final java.lang.String RUNAS_APPLICATIONID
public static final java.lang.String ASYNC_REQUEST_TIMEOUT
The property datatype is
LONG
.
public static final java.lang.String EXTERNAL_ID
For example, a Java asynchronous job usually invokes some remote process and then returns control to the Scheduler. This property can be used to identify the remote process.
This property should be set by the job implementation of asynchronous Java jobs when the identifier is known. It is never set by the Enterprise Scheduler.
The property datatype is
STRING
.
Constructor Detail |
---|
public SystemProperty()
Method Detail |
---|
public static java.util.Enumeration<java.lang.String> getNames()
public static ParameterInfo getSysPropInfo(java.lang.String name)
name
- the name of the system property.
If null
, this method returns null
.
null
if no such system property exists.public static java.util.Set<java.lang.String> getReadOnlySysProps()
public static java.util.Set<java.lang.String> getInternalOnlyProps()
public static java.util.Set<java.lang.String> getMetadataOnlyProps()
public static boolean isInternalOnly(java.lang.String name)
true
if not should not be set, false
otherwise.public static boolean isMetadataOnly(java.lang.String name)
name
- the name of the system property
true
if this system property can be set when
defining metadata, but should not be set in RequestParameters
at request submission. Returns false
otherwise.
|
Oracle Fusion Applications Java API Reference for Oracle Enterprise Scheduler Service 11g Release 1 (11.1.2) E20742-02 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |