Class Job
- java.lang.Object
-
- com.ibm.as400.access.Job
-
- All Implemented Interfaces:
- java.io.Serializable
public class Job extends java.lang.Object implements java.io.Serializable
Represents a job on the IBM i server. In order to access a job, the system and either the job name, user name, and job number or internal job identifier need to be set. A valid and sufficient combination of these must be set before getting or setting any of the job's attributes.Some of the attributes have associated 'get' and 'set' methods defined in this class. These are provided for backwards compatibility with previous versions of the IBM Toolbox for Java. The complete set of attribute values can be accessed using the public constants.
Note: Most of the 'get' methods will either go to the system to retrieve the job attribute value, or will return a cached value if the attribute was previously retrieved or previously set by
setValue()
or one of the other 'set' methods. UseloadInformation()
to refresh the attribute values from the system.
For example:Job job = new Job(system, jobName, userName, jobNumber); while (job.getStatus().equals(Job.JOB_STATUS_ACTIVE)) { // Wait a while. Thread.sleep(1000); // Refresh the attribute values. job.loadInformation(); } System.out.println("Job status is: " + job.getStatus());
Note: Jobs created by SBMJOB tend to get cleaned-up immediately upon job completion (if no spooled files were created); whereupon getStatus(), getCompletionStatus(), and most other 'get' methods will throw an AS400Exception containing an AS400Message indicating "Internal job identifier no longer valid" (message ID CPF3C52). That exception should be interpreted as an indication that the job has completed.
Note: To obtain information about the job in which a program or command runs, do something like the following:
AS400 system = new AS400(); ProgramCall pgm = new ProgramCall(system); pgm.setThreadSafe(true); // Indicates that the program is to be run on-thread. String jobNumber = pgm.getServerJob().getNumber();
(If the program or command is not to be run on-thread, omit thesetThreadSafe()
call.)
-
-
Field Summary
Fields Modifier and Type Field and Description static int
ACCOUNTING_CODE
Job attribute representing an identifier assigned to the job by the system to collect resource use information for the job when job accounting is active.static java.lang.String
ACCOUNTING_CODE_BLANK
Constant indicating the accounting code is changed to all blanks.static int
ACTIVE_JOB_STATUS
Job attribute representing the active status of the initial thread of a job.static java.lang.String
ACTIVE_JOB_STATUS_DISCONNECTED
Constant indicating that a job was disconnected from a work station display.static java.lang.String
ACTIVE_JOB_STATUS_ENDED
Constant indicating that a job has been ended with the *IMMED option, or its delay time has ended with the *CNTRLD option.static java.lang.String
ACTIVE_JOB_STATUS_ENDING
Constant indicating that a job is ending for a reason other than running the End Job (ENDJOB) or End Subsystem (ENDSBS) commands, such as a SIGNOFF command, an End Group Job (ENDGRPJOB) command, or an exception that is not handled.static int
ACTIVE_JOB_STATUS_FOR_JOBS_ENDING
Job attribute representing the status of what the initial thread of a job is currently doing, when the active job status is ACTIVE_JOB_STATUS_ENDED or ACTIVE_JOB_STATUS_ENDING.static java.lang.String
ACTIVE_JOB_STATUS_HELD
Constant indicating that a job is held.static java.lang.String
ACTIVE_JOB_STATUS_HELD_THREAD
Constant indicating that a job is held due to a suspended thread.static java.lang.String
ACTIVE_JOB_STATUS_INELIGIBLE
Constant indicating that a job is ineligible and not currently in a pool activity level.static java.lang.String
ACTIVE_JOB_STATUS_NONE
Constant indicating that a job is in transition or is not active.static java.lang.String
ACTIVE_JOB_STATUS_RUNNING
Constant indicating that a job is currently running in a pool activity level.static java.lang.String
ACTIVE_JOB_STATUS_STOPPED
Constant indicating that a job has stopped as the result of a signal.static java.lang.String
ACTIVE_JOB_STATUS_SUSPENDED
Constant indicating that a job is suspended by a Transfer Group Job (TFRGRPJOB) command.static java.lang.String
ACTIVE_JOB_STATUS_SUSPENDED_SYSTEM_REQUEST
Constant indicating that a job is the suspended half of a system request job pair.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_BIN_SYNCH_DEVICE
Constant indicating that a job is waiting for the completion of an I/O operation to a binary synchronous device.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_BIN_SYNCH_DEVICE_AND_ACTIVE
Constant indicating that a job is waiting in a pool activity level for the completion of an I/O operation to a binary synchronous device.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_CHECKPOINT
Constant indicating that a job is waiting for the completion of save-while-active checkpoint processing in another job.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_COMM_DEVICE
Constant indicating that a job is waiting for the completion of an I/O operation to a communications device.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_COMM_DEVICE_AND_ACTIVE
Constant indicating that a job is waiting in a pool activity level for the completion of an I/O operation to a communications device.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_CONDITION
Constant indicating that a job is waiting on a handle-based condition.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_CPI_COMM
Constant indicating that a job is waiting for the completion of a CPI communications call.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_DATABASE_EOF
Constant indicating that a job is waiting to try a read operation again on a database file after the end-of-file (EOF) has been reached.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_DATABASE_EOF_AND_ACTIVE
Constant indicating that a job is waiting in a pool activity level to try a read operation again on a database file after the end-of-file (EOF) has been reached.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_DELAY
Constant indicating that a job is waiting for a specified time interval to end, or for a specific delay end time, as specified on the Delay Job (DLYJOB) command.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_DELAYED
Constant indicating that a job is waiting for a specified time interval to end, or for a specific delay end time, as specified on the Delay Job (DLYJOB) command.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_DEQUEUE
Constant indicating that a job is waiting for completion of a dequeue operation.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_DEQUEUE_AND_ACTIVE
Constant indicating that a job is waiting in the pool activity level for completion of a dequeue operation.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_DISKETTE
Constant indicating that a job is waiting for the completion of an I/O operation to a diskette unit.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_DISKETTE_AND_ACTIVE
Constant indicating that a job is waiting in a pool activity level for the completion of an I/O operation to a diskette unit.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_DISPLAY
Constant indicating that a job is waiting for input from a work station display.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_DISPLAY_AND_ACTIVE
Constant indicating that a job is waiting in a pool activity level for input from a work station display.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_EVENT
Constant indicating that a job is waiting for an event.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_ICF_FILE
Constant indicating that a job is waiting for the completion of an I/O operation to an intersystem communications function (ICF) file.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_ICF_FILE_AND_ACTIVE
Constant indicating that a job is waiting in a pool activity level for the completion of an I/O operation to an intersystem communications function (ICF) file.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_JAVA
Constant indicating that a job is waiting for a Java program operation to complete.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_JAVA_AND_ACTIVE
Constant indicating that a job is waiting in a pool activity level for a Java program operation to complete.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_LOCK
Constant indicating that a job is waiting for a lock.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_LOCK_SPACE
Constant indicating that a job is waiting for a lock space to be attached.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_LOCK_SPACE_AND_ACTIVE
Constant indicating that a job is waiting in a pool activity level for for a lock space to be attached.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_MESSAGE
Constant indicating that a job is waiting for a message from a message queue.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_MIXED_DEVICE_FILE
Constant indicating that a job is waiting for the completion of an I/O operation to a mixed device file.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_MULTIPLE_FILES
Constant indicating that a job is waiting for the completion of an I/O operation to multiple files.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_MULTIPLE_FILES_AND_ACTIVE
Constant indicating that a job is waiting in a pool activity level for the completion of an I/O operation to multiple files.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_MUTEX
Constant indicating that a job is waiting for a mutex.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_OPTICAL_DEVICE
Constant indicating that a job is waiting for the completion of an I/O operation to an optical device.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_OPTICAL_DEVICE_AND_ACTIVE
Constant indicating that a job is waiting in a pool activity level for the completion of an I/O operation to an optical device.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_OSI
Constant indicating that a job is waiting for the completion of an OSI Communications Subsystem operation.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_PRESTART
Constant indicating that a prestart job is waiting for a program start request.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_PRINT
Constant indicating that a job is waiting for output to a printer to complete.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_PRINT_AND_ACTIVE
Constant indicating that a job is waiting in a pool activity level for output to a printer to complete.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_SAVE_FILE
Constant indicating that a job is waiting for the completion of a save file operation.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_SAVE_FILE_AND_ACTIVE
Constant indicating that a job is waiting in a pool activity level for the completion of a save file operation.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_SELECTION
Constant indicating that a job is waiting for a selection to complete.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_SEMAPHORE
Constant indicating that a job is waiting for a semaphore.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_SIGNAL
Constant indicating that a job is waiting for a signal.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_TAPE_DEVICE
Constant indicating that a job is waiting for the completion of an I/O operation to a tape device.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_TAPE_DEVICE_AND_ACTIVE
Constant indicating that a job is waiting in a pool activity level for the completion of an I/O operation to a tape device.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_THREAD
Constant indicating that a job is waiting for another thread to complete an operation.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_TIME_INTERVAL
Constant indicating that a job is waiting for a time interval to end.static java.lang.String
ACTIVE_JOB_STATUS_WAIT_TIME_INTERVAL_AND_ACTIVE
Constant indicating that a job is waiting in a pool activity level for a time interval to end.static int
ALLOW_MULTIPLE_THREADS
Job attribute representing whether a job allows multiple user threads.static java.lang.String
ALLOW_MULTIPLE_THREADS_NO
Constant indicating that a job does not allow multiple user threads.static java.lang.String
ALLOW_MULTIPLE_THREADS_YES
Constant indicating that a job allows multiple user threads.static int
AUXILIARY_IO_REQUESTS
Job attribute representing the number of auxiliary I/O requests performed by the job across all routing steps.static int
AUXILIARY_IO_REQUESTS_LARGE
Job attribute representing the number of auxiliary I/O requests performed by the job across all routing steps.static int
BREAK_MESSAGE_HANDLING
Job attribute representing how a job handles break messages.static java.lang.String
BREAK_MESSAGE_HANDLING_HOLD
Constant indicating that the message queue holds break messages until a user or program requests them.static java.lang.String
BREAK_MESSAGE_HANDLING_NORMAL
Constant indicating that the message queue status determines break message handling.static java.lang.String
BREAK_MESSAGE_HANDLING_NOTIFY
Constant indicating that the system notifies the job's message queue when a message arrives.static int
CCSID
Job attribute representing the coded character set identifier used for this job.static int
CCSID_INITIAL_USER
Constant indicating that the CCSID specified in the user profile under which this thread was initially running is used.static int
CCSID_SYSTEM_VALUE
Constant indicating that the CCSID specified in the system value QCCSID is used.static int
CHARACTER_ID_CONTROL
Job attribute representing the character identifier control for a job.static java.lang.String
CHARACTER_ID_CONTROL_DEVICE
Constant indicating to perform the same function for *DEVD as on the CHRID command parameter for display files, printer files, and panel groups.static java.lang.String
CHARACTER_ID_CONTROL_INITIAL_USER
Constant indicating the CHRIDCTL specified in the user profile under which this thread was initially running will be used.static java.lang.String
CHARACTER_ID_CONTROL_JOB
Constant indicating to perform the same function for *JOBCCSID as on the CHRID command parameter for display files, printer files, and panel groups.static java.lang.String
CHARACTER_ID_CONTROL_SYSTEM_VALUE
Constant indicating the value in the QCHRIDCTL system value will be used.static int
CLIENT_IP_ADDRESS
Job attribute representing the IPv4 address of the client for which this system is doing work.static int
COMPLETION_STATUS
Job attribute representing the completion status for a job.static java.lang.String
COMPLETION_STATUS_COMPLETED_ABNORMALLY
Constant indicating that the job completed abnormally.static java.lang.String
COMPLETION_STATUS_COMPLETED_NORMALLY
Constant indicating that the job completed normally.static java.lang.String
COMPLETION_STATUS_NOT_COMPLETED
Constant indicating that the job has not completed.static int
CONTROLLED_END_REQUESTED
Job attribute representing whether or not the system issued a controlled cancellation.static int
COUNTRY_ID
Job attribute representing the country or region identifier associated with this job.static java.lang.String
COUNTRY_ID_INITIAL_USER
Constant indicating the country or region ID specified in the user profile under which this thread was initially running is used.static java.lang.String
COUNTRY_ID_SYSTEM_VALUE
Constant indicating the system value QCNTRYID is used.static int
CPU_TIME_USED
Job attribute representing the amount of processing unit time (in milliseconds) that the job used.static int
CPU_TIME_USED_FOR_DATABASE
Job attribute representing the amount of processing unit time (in milliseconds) that the job used for processing data base requests across all routing steps.static int
CPU_TIME_USED_LARGE
Job attribute representing the amount of processing unit time (in milliseconds) that the job used across all routing steps.static int
CURRENT_LIBRARY
Job attribute representing the name of the current library for the initial thread of the job.static int
CURRENT_LIBRARY_EXISTENCE
Job attribute representing whether or not a current library exists for the job.static int
CURRENT_SYSTEM_POOL_ID
Job attribute representing the identifier of the system-related pool from which main storage is currently being allocated for the job's initial thread.static int
CURRENT_USER
Job attribute representing the user profile that the initial thread of the job for which information is being retrieved is currently running under.static int
DATE_ENDED
Job attribute representing the date and time when the job completed running on the system.static int
DATE_ENTERED_SYSTEM
Job attribute representing the date and time when the job was placed on the system.static int
DATE_FORMAT
Job attribute representing the format in which dates are presented.static java.lang.String
DATE_FORMAT_DMY
Constant indicating a date format of day, month, and year.static java.lang.String
DATE_FORMAT_JULIAN
Constant indicating a Julian date format (year and day).static java.lang.String
DATE_FORMAT_MDY
Constant indicating a date format of month, day, and year.static java.lang.String
DATE_FORMAT_SYSTEM_VALUE
Constant indicating the system value QDATFMT is used.static java.lang.String
DATE_FORMAT_YMD
Constant indicating a date format of year, month, and day.static int
DATE_SEPARATOR
Job attribute representing the value used to separate days, months, and years when presenting a date.static java.lang.String
DATE_SEPARATOR_BLANK
Constant indicating a blank is used for the date separator.static java.lang.String
DATE_SEPARATOR_COMMA
Constant indicating a comma (,) is used for the date separator.static java.lang.String
DATE_SEPARATOR_DASH
Constant indicating a dash (-) is used for the date separator.static java.lang.String
DATE_SEPARATOR_PERIOD
Constant indicating a period (.) is used for the date separator.static java.lang.String
DATE_SEPARATOR_SLASH
Constant indicating a slash (/) is used for the date separator.static java.lang.String
DATE_SEPARATOR_SYSTEM_VALUE
Constant indicating the system value QDATSEP is used for the date separator.static int
DATE_STARTED
Job attribute representing the date and time when the job began to run on the system.static int
DBCS_CAPABLE
Job attribute representing whether the job is DBCS-capable or not.static java.lang.String
DBCS_CAPABLE_NO
Constant indicating that the job is not DBCS-capable.static java.lang.String
DBCS_CAPABLE_YES
Constant indicating that the job is DBCS-capable.static int
DECIMAL_FORMAT
Job attribute representing the decimal format used for this job.static java.lang.String
DECIMAL_FORMAT_COMMA_I
Constant indicating a decimal format that uses a comma for a decimal point, a period for a 3-digit grouping character, and zero-suppresses to the left of the decimal point.static java.lang.String
DECIMAL_FORMAT_COMMA_J
Constant indicating a decimal format that uses a comma for a decimal point and a period for a 3-digit grouping character.static java.lang.String
DECIMAL_FORMAT_PERIOD
Constant indicating a decimal format that uses a period for a decimal point, a comma for a 3-digit grouping character, and zero-suppresses to the left of the decimal point.static java.lang.String
DECIMAL_FORMAT_SYSTEM_VALUE
Constant indicating the value in the system value QDECFMT is used as the decimal format for this job.static int
DEFAULT_CCSID
Job attribute representing the default coded character set identifier (CCSID) used for this job.static int
DEFAULT_WAIT_TIME
Job attribute representing the default maximum time (in seconds) that a thread in the job waits for a system instruction, such as a LOCK machine interface (MI) instruction, to acquire a resource.static int
DEVICE_RECOVERY_ACTION
Job attribute representing the action taken for interactive jobs when an I/O error occurs for the job's requesting program device.static java.lang.String
DEVICE_RECOVERY_ACTION_DISCONNECT_END_REQUEST
Constant indicating a device recovery action that disconnects the job when an I/O error occurs.static java.lang.String
DEVICE_RECOVERY_ACTION_DISCONNECT_MESSAGE
Constant indicating a device recovery action that disconnects the job when an I/O error occurs.static java.lang.String
DEVICE_RECOVERY_ACTION_END_JOB
Constant indicating a device recovery action that ends the job when an I/O error occurs.static java.lang.String
DEVICE_RECOVERY_ACTION_END_JOB_NO_LIST
Constant indicating a device recovery action that ends the job when an I/O error occurs.static java.lang.String
DEVICE_RECOVERY_ACTION_MESSAGE
Constant indicating a device recovery action that signals the I/O error message to the application and lets the application program perform error recovery.static java.lang.String
DEVICE_RECOVERY_ACTION_SYSTEM_VALUE
Constant indicating the value in the system value QDEVRCYACN is used as the device recovery action for this job.static int
ELAPSED_CPU_PERCENT_USED
Job attribute representing the percentage of processing time used during the elapsed time.static int
ELAPSED_CPU_PERCENT_USED_FOR_DATABASE
Job attribute representing the percentage of processing unit used for database processing during the elapsed time.static int
ELAPSED_CPU_TIME_USED
Job attribute representing the amount of processing unit time (in milliseconds) used during the elapsed time.static int
ELAPSED_CPU_TIME_USED_FOR_DATABASE
Job attribute representing the amount of processing unit time (in milliseconds) used for database processing during the elapsed time.static int
ELAPSED_DISK_IO
Job attribute representing the number of disk I/O operations performed by the job during the elapsed time.static int
ELAPSED_DISK_IO_ASYNCH
Job attribute representing the number of asynchronous (physical) disk I/O operations performed by the job during the elapsed time.static int
ELAPSED_DISK_IO_SYNCH
Job attribute representing the number of synchronous (physical) disk I/O operations performed by the job during the elapsed time.static int
ELAPSED_INTERACTIVE_RESPONSE_TIME
Job attribute representing the total interactive response time for the initial thread (in hundredths of seconds) for the job during the elapsed time.static int
ELAPSED_INTERACTIVE_TRANSACTIONS
Job attribute representing the number of user interactions, such as pressing the Enter key or a function key, for the job during the elapsed time for the initial thread.static int
ELAPSED_LOCK_WAIT_TIME
Job attribute representing the amount of time (in milliseconds) that the initial thread has to wait to obtain database, nondatabase, and internal machine locks during the elapsed time.static int
ELAPSED_PAGE_FAULTS
Job attribute representing the number of times an active program referenced an address that is not in main storage for the current routing step during the elapsed time.static int
ELAPSED_TIME
Job attribute representing the time (in milliseconds) that has elapsed between the measurement start time and the current system time.static int
ELIGIBLE_FOR_PURGE
Job attribute representing whether or not the job is eligible to be moved out of main storage and put into auxiliary storage at the end of a time slice or when entering a long wait (such as waiting for a work station user's response).static java.lang.String
ELIGIBLE_FOR_PURGE_IGNORED
Constant indicating that whether a job is eligible for purge or not is ignored because the job type is either *JOBQ or *OUTQ, or the job is not valid.static java.lang.String
ELIGIBLE_FOR_PURGE_NO
Constant indicating that a job is not eligible to be moved out of main storage and put into auxiliary storage.static java.lang.String
ELIGIBLE_FOR_PURGE_YES
Constant indicating that the job is eligible to be moved out of main storage and put into auxiliary storage.static int
END_SEVERITY
Job attribute representing the message severity level of escape messages that can cause a batch job to end.static java.lang.String
END_STATUS_CANCELLED
Constant indicating that the system, the subsystem in which a job is running, or the job itself is cancelled.static java.lang.String
END_STATUS_JOB_NOT_RUNNING
Constant indicating that the job is not running.static java.lang.String
END_STATUS_NOT_CANCELLED
Constant indicating that the system, the subsystem in which a job is running, or the job itself is not cancelled.static int
FUNCTION_NAME
Job attribute representing additional information (as described by the FUNCTION_TYPE attribute) about the last high-level function initiated by the initial thread.static int
FUNCTION_TYPE
Job attribute representing the last high-level function initiated by the initial thread.static java.lang.String
FUNCTION_TYPE_BLANK
Constant indicating that the system is not performing a logged function.static java.lang.String
FUNCTION_TYPE_COMMAND
Constant indicating that a command is running interactively, or it is in a batch input stream, or it was requested from a system menu.static java.lang.String
FUNCTION_TYPE_DELAY
Constant indicating that the initial thread of the job is processing a Delay Job (DLYJOB) command.static java.lang.String
FUNCTION_TYPE_GROUP
Constant indicating that the Transfer Group Job (TFRGRPJOB) command suspended the job.static java.lang.String
FUNCTION_TYPE_INDEX
Constant indicating that the initial thread of the job is rebuilding an index (access path).static java.lang.String
FUNCTION_TYPE_IO
Constant indicating that the job is a subsystem monitor that is performing input/output (I/O) operations to a work station.static java.lang.String
FUNCTION_TYPE_JAVA
Constant indicating that the initial thread of the job is running a Java Vertual Machine (JVM).static java.lang.String
FUNCTION_TYPE_LOG
Constant indicating that the system logs history information in a database file.static java.lang.String
FUNCTION_TYPE_MENU
Constant indicating that the initial thread of the job is currently at a system menu.static java.lang.String
FUNCTION_TYPE_MRT
Constant indicating that the job is a multiple requester terminal (MRT) job if theJOB_TYPE
isJOB_TYPE_BATCH
and theJOB_SUBTYPE
isJOB_SUBTYPE_MRT
, or it is an interactive job attached to an MRT job if theJOB_TYPE
isJOB_TYPE_INTERACTIVE
.static java.lang.String
FUNCTION_TYPE_PROCEDURE
Constant indicating that the initial thread of the job is running a procedure.static java.lang.String
FUNCTION_TYPE_PROGRAM
Constant indicating that the initial thread of the job is running a program.static java.lang.String
FUNCTION_TYPE_SPECIAL
Constant indicating that the function type is a special function.static long
INITIAL_THREAD
Constant indicating that the initial thread of the job should be used when retrieving the call stack.static int
INQUIRY_MESSAGE_REPLY
Job attribute representing how the job answers inquiry messages.static java.lang.String
INQUIRY_MESSAGE_REPLY_DEFAULT
Constant indicating that the system uses the default message reply to answer any inquiry messages issued while this job is running.static java.lang.String
INQUIRY_MESSAGE_REPLY_REQUIRED
Constant indicating that the job requires an answer for any inquiry messages that occur while this job is running.static java.lang.String
INQUIRY_MESSAGE_REPLY_SYSTEM_REPLY_LIST
Constant indicating that the system reply list is checked to see if there is an entry for an inquiry message issued while this job is running.static int
INSTANCE
Job attribute representing the instance portion of the unit of work ID.static int
INTERACTIVE_TRANSACTIONS
Job attribute representing the count of operator interactions, such as pressing the Enter key or a function key.static int
INTERNAL_JOB_ID
Deprecated.UseINTERNAL_JOB_IDENTIFIER
instead. The internal job identifier should be treated as a byte array of 16 bytes.static int
INTERNAL_JOB_IDENTIFIER
Job attribute representing the value input to other APIs to increase the speed of locating the job on the system.static int
JOB_DATE
Job attribute representing the date used for the job.static int
JOB_DESCRIPTION
Job attribute representing a set of job-related attributes used for one or more jobs on the system.static int
JOB_END_REASON
Job attribute representing the most recent action that caused the job to end.static int
JOB_LOG_OUTPUT
Job attribute representing how a job log will be produced when the job completes.static java.lang.String
JOB_LOG_OUTPUT_JOB_END
Constant indicating that the job log will be produced by the job itself.static java.lang.String
JOB_LOG_OUTPUT_JOB_LOG_SERVER
Constant indicating that the job log will be produced by a job log server.static java.lang.String
JOB_LOG_OUTPUT_PENDING
Constant indicating that the job log will not be produced.static java.lang.String
JOB_LOG_OUTPUT_SYSTEM_VALUE
Constant indicating that the value is specifed by the QLOGOUTPUT system value.static int
JOB_LOG_PENDING
Job attribute representing whether a job's log has been written or not.static java.lang.String
JOB_LOG_PENDING_NO
Constant indicating that the job log is not pending.static java.lang.String
JOB_LOG_PENDING_YES
Constant indicating that the job log is pending and waiting to be written.static int
JOB_NAME
Job attribute representing the name of the job as identified to the system.static java.lang.String
JOB_NAME_CURRENT
Constant indicating the job that this program is running in.static java.lang.String
JOB_NAME_INTERNAL
Constant indicating that the INTERNAL_JOB_ID locates the job.static int
JOB_NUMBER
Job attribute representing the system-generated job number.static java.lang.String
JOB_NUMBER_BLANK
Constant indicating a blank job number.static int
JOB_QUEUE
Job attribute representing the name of the job queue that the job is currently on, or that the job was on if it is currently active.static int
JOB_QUEUE_DATE
Job attribute representing the date and time this job was put on this job queue.static int
JOB_QUEUE_PRIORITY
Job attribute representing the scheduling priority of the job compared to other jobs on the same job queue.static int
JOB_QUEUE_STATUS
Job attribute representing the status of this job on the job queue.static java.lang.String
JOB_QUEUE_STATUS_BLANK
Constant indicating that this job was not on a job queue.static java.lang.String
JOB_QUEUE_STATUS_HELD
Constant indicating that this job is being held on the job queue.static java.lang.String
JOB_QUEUE_STATUS_READY
Constant indicating that this job is ready to be selected.static java.lang.String
JOB_QUEUE_STATUS_SCHEDULED
Constant indicating that this job will run as scheduled.static int
JOB_STATUS
Job attribute representing the status of this job.static java.lang.String
JOB_STATUS_ACTIVE
Constant indicating this job is an active job.static java.lang.String
JOB_STATUS_JOBQ
Constant indicating this job is currently on a job queue.static java.lang.String
JOB_STATUS_OUTQ
Constant indicating this job has completed running, but still has output on an output queue.static int
JOB_SUBTYPE
Job attribute representing additional information about the job type (if any exists).static java.lang.String
JOB_SUBTYPE_ALTERNATE_SPOOL_USER
Constant indicating that the job is an alternate spool user job.static java.lang.String
JOB_SUBTYPE_BLANK
Constant indicating that the job has no special subtype or is not a valid job.static java.lang.String
JOB_SUBTYPE_IMMEDIATE
Constant indicating that the job is an immediate job.static java.lang.String
JOB_SUBTYPE_MACHINE_SERVER_JOB
Constant indicating that the job is an AS/400 Advanced 36 machine server job.static java.lang.String
JOB_SUBTYPE_MRT
Constant indicating that the job is a System/36 multiple requester terminal (MRT) job.static java.lang.String
JOB_SUBTYPE_PRESTART
Constant indicating that the job is a prestart job.static java.lang.String
JOB_SUBTYPE_PRINT_DRIVER
Constant indicating that the job is a print driver job.static java.lang.String
JOB_SUBTYPE_PROCEDURE_START_REQUEST
Constant indicating that the job started with a procedure start request.static int
JOB_SWITCHES
Job attribute representing the current setting of the job switches used by this job.static int
JOB_TYPE
Job attribute representing the type of job.static java.lang.String
JOB_TYPE_AUTOSTART
Constant indicating that the job is an autostart job.static java.lang.String
JOB_TYPE_BATCH
Constant indicating that the job is a batch job.static int
JOB_TYPE_ENHANCED
Job attribute representing the type of job.static java.lang.Integer
JOB_TYPE_ENHANCED_AUTOSTART
Constant indicating that the job is an autostart job.static java.lang.Integer
JOB_TYPE_ENHANCED_BATCH
Constant indicating that the job is a batch job.static java.lang.Integer
JOB_TYPE_ENHANCED_BATCH_ALTERNATE_SPOOL_USER
Constant indicating that the job is a batch alternate spool user job.static java.lang.Integer
JOB_TYPE_ENHANCED_BATCH_IMMEDIATE
Constant indicating that the job is a batch immediate job.static java.lang.Integer
JOB_TYPE_ENHANCED_BATCH_MRT
Constant indicating that the job is a batch System/36 multiple requester terminal (MRT) job.static java.lang.Integer
JOB_TYPE_ENHANCED_COMM_PROCEDURE_START_REQUEST
Constant indicating that the job is a communications procedure start request job.static java.lang.Integer
JOB_TYPE_ENHANCED_INTERACTIVE
Constant indicating that the job is an interactive job.static java.lang.Integer
JOB_TYPE_ENHANCED_INTERACTIVE_GROUP
Constant indicating that the job is an interactive job that is part of a group.static java.lang.Integer
JOB_TYPE_ENHANCED_INTERACTIVE_SYSREQ
Constant indicating that the job is an interactive job that is part of a system request pair.static java.lang.Integer
JOB_TYPE_ENHANCED_INTERACTIVE_SYSREQ_AND_GROUP
Constant indicating that the job is an interactive job that is part of a system request pair and part of a group.static java.lang.Integer
JOB_TYPE_ENHANCED_PRESTART
Constant indicating that the job is a prestart job.static java.lang.Integer
JOB_TYPE_ENHANCED_PRESTART_BATCH
Constant indicating that the job is a prestart batch job.static java.lang.Integer
JOB_TYPE_ENHANCED_PRESTART_COMM
Constant indicating that the job is a prestart communications job.static java.lang.Integer
JOB_TYPE_ENHANCED_READER
Constant indicating that the job is a reader job.static java.lang.Integer
JOB_TYPE_ENHANCED_SUBSYSTEM
Constant indicating that the job is a subsystem job.static java.lang.Integer
JOB_TYPE_ENHANCED_SYSTEM
Constant indicating that the job is a system job (all system jobs including SCPF).static java.lang.Integer
JOB_TYPE_ENHANCED_WRITER
Constant indicating that the job is a writer job (including both spool writers and print drivers).static java.lang.String
JOB_TYPE_INTERACTIVE
Constant indicating that the job is an interactive job.static java.lang.String
JOB_TYPE_NOT_VALID
Constant indicating that the job is not a valid job.static java.lang.String
JOB_TYPE_SCPF_SYSTEM
Constant indicating that the job is the SCPF system job.static java.lang.String
JOB_TYPE_SPOOLED_READER
Constant indicating that the job is a spooled reader job.static java.lang.String
JOB_TYPE_SPOOLED_WRITER
Constant indicating that the job is a spooled writer job.static java.lang.String
JOB_TYPE_SUBSYSTEM_MONITOR
Constant indicating that the job is a subsystem monitor job.static java.lang.String
JOB_TYPE_SYSTEM
Constant indicating that the job is a system job.static int
JOB_USER_IDENTITY
Job attribute representing the user profile name by which the job is known to other jobs on the system.static int
JOB_USER_IDENTITY_SETTING
Job attribute representing the method by which the job user identity was set.static java.lang.String
JOB_USER_IDENTITY_SETTING_APPLICATION
Constant indicating that the job user identity was explicitly set by an application using one of the Set Job User Identity APIs, QWTSJUID or QwtSetJuid().static java.lang.String
JOB_USER_IDENTITY_SETTING_DEFAULT
Constant indicating that the job is currently running single threaded and the job user identity is the name of the user profile under which the job is currently running.static java.lang.String
JOB_USER_IDENTITY_SETTING_SYSTEM
Constant indicating that the job is currently running multithreaded and the job user identity was implicitly set by the system when the job became multithreaded.static int
KEEP_DDM_CONNECTIONS_ACTIVE
Job attribute representing whether connections using distributed data management (DDM) protocols remain active when they are not being used.static java.lang.String
KEEP_DDM_CONNECTIONS_ACTIVE_DROP
Constant indicating that the system ends a DDM connection when there are no users.static java.lang.String
KEEP_DDM_CONNECTIONS_ACTIVE_KEEP
Constant indicating that the system keeps DDM connections active when there are no users, except for the following: The routing step ends on the source system.static int
LANGUAGE_ID
Job attribute representing the language identifier associated with this job.static java.lang.String
LANGUAGE_ID_INITIAL_USER
Constant indicating the language ID specified in the user profile under which this thread was initially running is used.static java.lang.String
LANGUAGE_ID_SYSTEM_VALUE
Constant indicating the system value QLANGID is used.static int
LOCATION_NAME
Job attribute representing the location name portion of the unit of work ID.static int
LOG_CL_PROGRAMS
Job attribute representing whether or not commands are logged for CL programs that are run.static java.lang.String
LOG_CL_PROGRAMS_NO
Constant indicating that commands are not logged for CL programs that are run.static java.lang.String
LOG_CL_PROGRAMS_YES
Constant indicating that commands are logged for CL programs that are run.static int
LOGGING_LEVEL
Job attribute representing what type of information is logged.static java.lang.String
LOGGING_LEVEL_ALL_REQUESTS_AND_ASSOCIATED_MESSAGES
Constant indicating that the following information is logged: Logging level 1 and 2 information is logged.static java.lang.String
LOGGING_LEVEL_ALL_REQUESTS_AND_MESSAGES
Constant indicating that the following information is logged: All request messages and all messages with a severity greater than or equal to the message logging severity, including trace messages.static java.lang.String
LOGGING_LEVEL_MESSAGES_BY_SEVERITY
Constant indicating that all messages sent to the job's external message queue with a severity greater than or equal to the message logging severity are logged.static java.lang.String
LOGGING_LEVEL_NONE
Constant indicating that no messages are logged.static java.lang.String
LOGGING_LEVEL_REQUESTS_BY_SEVERITY_AND_ASSOCIATED_MESSAGES
Constant indicating that the following information is logged: Logging level 1 information.static int
LOGGING_SEVERITY
Job attribute representing the severity level that is used in conjunction with the logging level to determine which error messages are logged in the job log.static int
LOGGING_TEXT
Job attribute representing the level of message text that is written in the job log when a message is logged according to the LOGGING_LEVEL and LOGGING_SEVERITY.static java.lang.String
LOGGING_TEXT_MESSAGE
Constant indicating that only the message text is written to the job log.static java.lang.String
LOGGING_TEXT_NO_LIST
Constant indicating that if the job ends normally, no job log is produced.static java.lang.String
LOGGING_TEXT_SECLVL
Constant indicating that both the message text and the message help (cause and recovery) of the error message are written to the job log.static int
MAX_CPU_TIME
Job attribute representing the maximum processing unit time (in milliseconds) that the job can use.static int
MAX_TEMP_STORAGE
Job attribute representing the maximum amount of auxiliary storage (in kilobytes) that the job can use.static int
MAX_TEMP_STORAGE_LARGE
Job attribute representing the maximum amount of auxiliary storage (in megabytes) that the job can use.static int
MAX_THREADS
Job attribute representing the maximum number of threads that a job can run with at any time.static int
MEMORY_POOL
Job attribute representing the name of the memory pool in which the job started running.static java.lang.String
MEMORY_POOL_BASE
Constant indicating that this job is running in the base system pool, which can be shared with other subsystems.static java.lang.String
MEMORY_POOL_INTERACTIVE
Constant indicating that this job is running in the shared pool used for interactive work.static java.lang.String
MEMORY_POOL_MACHINE
Constant indicating that this job is running in the machine pool.static java.lang.String
MEMORY_POOL_SPOOL
Constant indicating that this job is running in the shared pool for spooled writers.static int
MESSAGE_QUEUE_ACTION
Job attribute representing the action to take when the message queue is full.static java.lang.String
MESSAGE_QUEUE_ACTION_NO_WRAP
Constant indicating that when the job message queue is full, do not wrap.static java.lang.String
MESSAGE_QUEUE_ACTION_PRINT_WRAP
Constant indicating that when the job message queue is full, wrap the message queue and print the messages that are being overlaid because of the wrapping.static java.lang.String
MESSAGE_QUEUE_ACTION_SYSTEM_VALUE
Constant indicating the value specified for the QJOBMSGQFL system value is used.static java.lang.String
MESSAGE_QUEUE_ACTION_WRAP
Constant indicating that when the job message queue is full, wrap to the beginning and start filling again.static int
MESSAGE_QUEUE_MAX_SIZE
Job attribute representing the maximum size (in megabytes) that the job message queue can become.static int
MESSAGE_REPLY
Job attribute representing whether the job is waiting for a reply to a specific message.static java.lang.String
MESSAGE_REPLY_NOT_IN_MESSAGE_WAIT
Constant indicating that the job currently is not in message wait status.static java.lang.String
MESSAGE_REPLY_NOT_WAITING
Constant indicating that the job is not waiting for a reply to a message.static java.lang.String
MESSAGE_REPLY_WAITING
Constant indicating that the job is waiting for a reply to a message.static int
MODE
Job attribute representing the mode name of the advanced program-to-program communications (APPC) device that started the job.static int
NETWORK_ID
Job attribute representing the network ID portion of the unit of work ID.static int
OUTPUT_QUEUE
Job attribute representing the name of the default output queue that is used for spooled output produced by this job.static java.lang.String
OUTPUT_QUEUE_DEVICE
Constant indicating the device specified on the Create Printer File (CRTPRTF), Change Printer File (CHGPRTF), or Override with Printer File (OVRPRTF) commands is used.static java.lang.String
OUTPUT_QUEUE_INITIAL_USER
Constant indicating the output queue name specified in the user profile under which this thread was initially running is used.static int
OUTPUT_QUEUE_PRIORITY
Job attribute representing the output priority for spooled output files that this job produces.static java.lang.String
OUTPUT_QUEUE_WORK_STATION
Constant indicating the default output queue that is used with this job is the output queue that is assigned to the work station associated with the job at the time the job is started.static int
PRINT_KEY_FORMAT
Job attribute representing whether border and header information is provided when the Print key is pressed.static java.lang.String
PRINT_KEY_FORMAT_ALL
Constant indicating that the border and header information is included with output from the Print key.static java.lang.String
PRINT_KEY_FORMAT_BORDER
Constant indicating that the border information is included with output from the Print key.static java.lang.String
PRINT_KEY_FORMAT_HEADER
Constant indicating that the header information is included with output from the Print key.static java.lang.String
PRINT_KEY_FORMAT_NONE
Constant indicating that the border and header information is not included with output from the Print key.static java.lang.String
PRINT_KEY_FORMAT_SYSTEM_VALUE
Constant indicating that the value specified on the system value QPRTKEYFMT determines whether header or border information is printed.static int
PRINT_TEXT
Job attribute representing the line of text (if any) that is printed at the bottom of each page of printed output for the job.static java.lang.String
PRINT_TEXT_BLANK
Constant indicating that no text is printed on printed output.static java.lang.String
PRINT_TEXT_SYSTEM_VALUE
Constant indicating the system value QPRTTXT is used.static int
PRINTER_DEVICE_NAME
Job attribute representing the printer device used for printing output from this job.static java.lang.String
PRINTER_DEVICE_NAME_INITIAL_USER
Constant indicating that the printer device name specified in the user profile under which this thread was initially running is used.static java.lang.String
PRINTER_DEVICE_NAME_SYSTEM_VALUE
Constant indicating the value in the system value QPRTDEV is used as the printer device.static java.lang.String
PRINTER_DEVICE_NAME_WORK_STATION
Constant indicating that the default printer device used with this job is the printer device assigned to the work station that is associated with the job.static int
PRODUCT_LIBRARIES
Job attribute representing the libraries that contain product information for the initial thread of the job.static int
PRODUCT_RETURN_CODE
Job attribute representing the return code set by the compiler for Integrated Language Environment (ILE) languages.static int
PROGRAM_RETURN_CODE
Job attribute representing the completion status of the last program that has finished running, if the job contains any RPG, COBOL, data file utility (DFU), or sort utility programs.static int
ROUTING_DATA
Job attribute representing the routing data that is used to determine the routing entry that identifies the program to start for the routing step.static int
RUN_PRIORITY
Job attribute representing the priority at which the job is currently running, relative to other jobs on the system.static int
SCHEDULE_DATE
Job attribute representing the date on which the submitted job becomes eligible to run.static java.lang.String
SCHEDULE_DATE_CURRENT
Constant indicating the submitted job becomes eligible to run on the current date.static java.lang.String
SCHEDULE_DATE_FRIDAY
Constant indicating the job becomes eligible to run on Friday.static java.lang.String
SCHEDULE_DATE_MONDAY
Constant indicating the job becomes eligible to run on Monday.static java.lang.String
SCHEDULE_DATE_MONTH_END
Constant indicating the submitted job becomes eligible to run on the last day of the month.static java.lang.String
SCHEDULE_DATE_MONTH_START
Constant indicating the submitted job becomes eligible to run on the first day of the month.static java.lang.String
SCHEDULE_DATE_SATURDAY
Constant indicating the job becomes eligible to run on Saturday.static java.lang.String
SCHEDULE_DATE_SUNDAY
Constant indicating the job becomes eligible to run on Sunday.static java.lang.String
SCHEDULE_DATE_THURSDAY
Constant indicating the job becomes eligible to run on Thursday.static java.lang.String
SCHEDULE_DATE_TUESDAY
Constant indicating the job becomes eligible to run on Tuesday.static java.lang.String
SCHEDULE_DATE_WEDNESDAY
Constant indicating the job becomes eligible to run on Wednesday.static int
SCHEDULE_TIME
Job attribute representing the time on the scheduled date at which the job becomes eligible to run.static java.lang.String
SCHEDULE_TIME_CURRENT
Constant indicating the job is submitted on the current time.static int
SEQUENCE_NUMBER
Job attribute representing the sequence number portion of the unit of work ID.static int
SERVER_TYPE
Job attribute representing the type of server represented by the job.static int
SIGNED_ON_JOB
Job attribute representing whether the job is to be treated like a signed-on user on the system.static java.lang.String
SIGNED_ON_JOB_FALSE
Constant indicating that the job should not be treated like a signed-on user.static java.lang.String
SIGNED_ON_JOB_TRUE
Constant indicating that the job should be treated like a signed-on user.static int
SORT_SEQUENCE_TABLE
Job attribute representing the sort sequence table associated with this job.static java.lang.String
SORT_SEQUENCE_TABLE_INITIAL_USER
Constant indicating the sort sequence table specified in the user profile under which this thread was initially running is used.static java.lang.String
SORT_SEQUENCE_TABLE_LANGUAGE_SHARED_WEIGHT
Constant indicating that the sort sequence table used can contain the same weight for multiple characters, and it is the shared weight sort table associated with the language specified in the LANGUAGE_ID attribute.static java.lang.String
SORT_SEQUENCE_TABLE_LANGUAGE_UNIQUE_WEIGHT
Constant indicating that the sort sequence table used must contain a unique weight for each character in the code page, and it is the unique weight sort table associated with the language specified in the LANGUAGE_ID parameter.static java.lang.String
SORT_SEQUENCE_TABLE_NONE
Constant indicating that no sort sequence table is used.static java.lang.String
SORT_SEQUENCE_TABLE_SYSTEM_VALUE
Constant indicating the system value QSRTSEQ is used.static int
SPECIAL_ENVIRONMENT
Job attribute representing whether a job is running in a particular environment.static java.lang.String
SPECIAL_ENVIRONMENT_NONE
Constant indicating that the job is not running in any special environment.static java.lang.String
SPECIAL_ENVIRONMENT_NOT_ACTIVE
Constant indicating that the special environment is ignored because the job is not currently active.static java.lang.String
SPECIAL_ENVIRONMENT_SYSTEM_36
Constant indicating that the job is running in the System/36 environment.static int
SPOOLED_FILE_ACTION
Job attribute representing whether spooled files can be accessed through job interfaces once a job has completed its normal activity.static java.lang.String
SPOOLED_FILE_ACTION_DETACH
Constant indicating that spooled files are detached from the job when the job completes its activity.static java.lang.String
SPOOLED_FILE_ACTION_KEEP
Constant indicating that when the job completes its activity, as long as at least one spooled file for the job exists in the system auxiliary storage pool (ASP 1) or in a basic user ASP (ASPs 2-32), the spooled files are kept with the job and the status of the job is updated to indicate that the job has completed.static java.lang.String
SPOOLED_FILE_ACTION_SYSTEM_VALUE
Constant indicating the job will take the spooled file action specified by the QSPLFACN system value.static int
STATUS_MESSAGE_HANDLING
Job attribute representing whether status messages are displayed for this job.static java.lang.String
STATUS_MESSAGE_HANDLING_INITIAL_USER
Constant indicating the status message handling that is specified in the user profile under which this thread was initially running is used.static java.lang.String
STATUS_MESSAGE_HANDLING_NONE
Constant indicating that this job does not display status messages.static java.lang.String
STATUS_MESSAGE_HANDLING_NORMAL
Constant indicating that this job displays status messages.static java.lang.String
STATUS_MESSAGE_HANDLING_SYSTEM_VALUE
Constant indicating the system value QSTSMSG is used.static int
SUBMITTED_BY_JOB_NAME
Job attribute representing the job name of the submitter's job.static int
SUBMITTED_BY_JOB_NUMBER
Job attribute representing the job number of the submitter's job.static int
SUBMITTED_BY_USER
Job attribute representing the user name of the submitter.static int
SUBSYSTEM
Job attribute representing the subsystem description in which an active job is running.static int
SYSTEM_LIBRARY_LIST
Job attribute representing the system portion of the library list of the initial thread of the job.static int
SYSTEM_POOL_ID
Job attribute representing the identifier of the system-related pool from which the job's main storage is allocated.static int
TEMP_STORAGE_USED
Job attribute representing the amount of auxiliary storage (in kilobytes) that is currently allocated to this job.static int
TEMP_STORAGE_USED_LARGE
Job attribute representing the amount of auxiliary storage (in megabytes) that is currently allocated to this job.static int
THREAD_COUNT
Job attribute representing the count of the current number of active threads in the process at the time of the materialization.static int
TIME_SEPARATOR
Job attribute representing the value used to separate hours, minutes, and seconds when presenting a time.static java.lang.String
TIME_SEPARATOR_BLANK
Constant indicating a blank is used for the time separator.static java.lang.String
TIME_SEPARATOR_COLON
Constant indicating a colon (:) is used for the time separator.static java.lang.String
TIME_SEPARATOR_COMMA
Constant indicating a comma (,) is used for the time separator.static java.lang.String
TIME_SEPARATOR_PERIOD
Constant indicating a period (.) is used for the time separator.static java.lang.String
TIME_SEPARATOR_SYSTEM_VALUE
Constant indicating the time separator specified in the system value QTIMSEP is used.static int
TIME_SLICE
Job attribute representing the maximum amount of processor time (in milliseconds) given to each thread in this job before other threads in this job and in other jobs are given the opportunity to run.static int
TIME_SLICE_END_POOL
Job attribute representing whether a thread in an interactive job moves to another main storage pool at the end of its time slice.static java.lang.String
TIME_SLICE_END_POOL_BASE
Constant indicating that a thread in the job moves to the base pool when it reaches the end of its time slice.static java.lang.String
TIME_SLICE_END_POOL_NONE
Constant indicating that a thread in the job does not move to another main storage pool when it reaches the end of its time slice.static java.lang.String
TIME_SLICE_END_POOL_SYSTEM_VALUE
Constant indicating the value in the system value QTSEPPOOL is used.static int
TOTAL_RESPONSE_TIME
Job attribute representing the total amount of response time for the initial thread, in milliseconds.static int
UNIT_OF_WORK_ID
Job attribute representing the unit of work ID used to track jobs across multiple systems.static int
USER_LIBRARY_LIST
Job attribute representing the user portion of the library list for the initial thread of the job.static int
USER_NAME
Job attribute representing the user name of the job, which is the same as the name of the user profile under which the job was started.static java.lang.String
USER_NAME_BLANK
Constant indicating a blank user name.static int
USER_RETURN_CODE
Job attribute representing the user-defined return code set by ILE high-level language constructs.
-
Constructor Summary
Constructors Constructor and Description Job()
Constructs a Job object.Job(AS400 system)
Constructs a Job object.Job(AS400 system, byte[] internalJobID)
Constructs a Job object.Job(AS400 system, java.lang.String internalJobID)
Deprecated.UseJob(AS400,byte[])
instead. The internal job ID should be treated as a byte array of 16 bytes.Job(AS400 system, java.lang.String jobName, java.lang.String userName, java.lang.String jobNumber)
Constructs a Job object.
-
Method Summary
Methods Modifier and Type Method and Description void
addPropertyChangeListener(java.beans.PropertyChangeListener listener)
Adds a PropertyChangeListener.void
addVetoableChangeListener(java.beans.VetoableChangeListener listener)
Adds a VetoableChangeListener.void
commitChanges()
Commits all uncommitted attribute changes.void
commitChanges(boolean callOnThread)
Commits all uncommitted attribute changes.void
end(int delay)
Ends this job.int
getAuxiliaryIORequests()
Returns the number of auxiliary I/O requests performed by the job across all routing steps.java.lang.String
getBreakMessageHandling()
Returns a value which represents how this job handles break messages.boolean
getCacheChanges()
Indicates if the attribute value changes are cached.CallStackEntry[]
getCallStack(long threadID)
Returns the call stack for the specified thread in this job.int
getCodedCharacterSetID()
Returns the coded character set identifier (CCSID) used for this job.java.lang.String
getCompletionStatus()
Returns the completion status of the job.java.lang.String
getCountryID()
Returns the country or region identifier associated with this job.int
getCPUUsed()
Returns the amount of processing unit time (in milliseconds) that the job used.java.lang.String
getCurrentLibrary()
Returns the name of the current library for the initial thread of the job.boolean
getCurrentLibraryExistence()
Indicates if a current library exists.java.util.Date
getDate()
Returns the date and time when the job was placed on the system.java.lang.String
getDateFormat()
Returns the format in which dates are presented.java.lang.String
getDateSeparator()
Returns the value used to separate days, months, and years when presenting a date.java.lang.String
getDDMConversationHandling()
Returns whether connections using distributed data management (DDM) protocols remain active when they are not being used.java.lang.String
getDecimalFormat()
Returns the decimal format used for this job.int
getDefaultCodedCharacterSetIdentifier()
Returns the default coded character set identifier (CCSID) used for this job.int
getDefaultWait()
Returns the default maximum time (in seconds) that a thread in the job waits for a system instruction, such as a LOCK machine interface (MI) instruction, to acquire a resource.java.lang.String
getDeviceRecoveryAction()
Returns the action taken for interactive jobs when an I/O error occurs for the job's requesting program device.int
getEndSeverity()
Returns the message severity level of escape messages that can cause a batch job to end.java.lang.String
getFunctionName()
Returns additional information (as described by the FUNCTION_TYPE attribute) about the last high-level function initiated by the initial thread.java.lang.String
getFunctionType()
Returns the last high-level function initiated by the initial thread.java.lang.String
getInquiryMessageReply()
Returns how the job answers inquiry messages.int
getInteractiveTransactions()
Returns the count of operator interactions, such as pressing the Enter key or a function key.java.lang.String
getInternalJobID()
Deprecated.UsegetInternalJobIdentifier()
instead. The internal job identifier should be treated as a byte array of 16 bytes.byte[]
getInternalJobIdentifier()
Returns the internal job identifier.java.lang.String
getJobAccountingCode()
Returns an identifier assigned to the job by the system to collect resource use information for the job when job accounting is active.java.util.Date
getJobActiveDate()
Returns the date and time when the job began to run on the system.java.util.Date
getJobDate()
Returns the date to be used for the job.java.lang.String
getJobDescription()
Returns the fully qualified integrated file system path name for the job description.java.util.Date
getJobEndedDate()
Returns the date and time when the job completed running on the system.java.util.Date
getJobEnterSystemDate()
Returns the date and time when the job was placed on the system.JobLog
getJobLog()
Returns the job log.java.lang.String
getJobMessageQueueFullAction()
Returns the action to take when the message queue is full.int
getJobMessageQueueMaximumSize()
Returns the maximum size (in megabytes) that the job message queue can become.java.util.Date
getJobPutOnJobQueueDate()
Returns the date and time this job was put on this job queue.java.lang.String
getJobStatusInJobQueue()
Returns the status of this job on the job queue.java.lang.String
getJobSwitches()
Returns the current setting of the job switches used by this job.java.lang.String
getLanguageID()
Returns the language identifier associated with this job.java.lang.String
getLoggingCLPrograms()
Returns a value indicating whether or not commands are logged for CL programs that are run.int
getLoggingLevel()
Returns what type of information is logged.int
getLoggingSeverity()
Returns the severity level that is used in conjunction with the logging level to determine which error messages are logged in the job log.java.lang.String
getLoggingText()
Returns the level of message text that is written in the job log when a message is logged according to the LOGGING_LEVEL and LOGGING_SEVERITY.java.lang.String
getModeName()
Returns the mode name of the advanced program-to-program communications (APPC) device that started the job.java.lang.String
getName()
Returns the job name.java.lang.String
getNumber()
Returns the job number.int
getNumberOfLibrariesInSYSLIBL()
Returns the number of libraries in the system portion of the library list of the initial thread of the job.int
getNumberOfLibrariesInUSRLIBL()
Returns the number of libraries in the user portion of the library list for the initial thread of the job.int
getNumberOfProductLibraries()
Returns the number of libraries that contain product information for the initial thread of the job.java.lang.String
getOutputQueue()
Returns the fully qualified integrated file system path name of the default output queue that is used for spooled output produced by this job.int
getOutputQueuePriority()
Returns the output priority for spooled output files that this job produces.int
getPoolIdentifier()
Returns the identifier of the system-related pool from which the job's main storage is allocated.java.lang.String
getPrinterDeviceName()
Returns the printer device used for printing output from this job.java.lang.String
getPrintKeyFormat()
Returns a value indicating whether border and header information is provided when the Print key is pressed.java.lang.String
getPrintText()
Returns the line of text (if any) that is printed at the bottom of each page of printed output for the job.java.lang.String[]
getProductLibraries()
Returns the libraries that contain product information for the initial thread of the job.boolean
getPurge()
Indicates whether or not the job is eligible to be moved out of main storage and put into auxiliary storage at the end of a time slice or when entering a long wait (such as waiting for a work station user's response).java.lang.String
getQueue()
Returns the fully qualified integrated file system path name of the job queue that the job is currently on, or that the job was on if it is currently active.int
getQueuePriority()
Returns the scheduling priority of the job compared to other jobs on the same job queue.java.lang.String
getRoutingData()
Returns the routing data that is used to determine the routing entry that identifies the program to start for the routing step.int
getRunPriority()
Returns the priority at which the job is currently running, relative to other jobs on the system.java.util.Date
getScheduleDate()
Returns the date and time the job is scheduled to become active.boolean
getSignedOnJob()
Indicates whether the job is to be treated like a signed-on user on the system.java.lang.String
getSortSequenceTable()
Returns the name of the sort sequence table associated with this job.java.lang.String
getStatus()
Returns the status of this job.java.lang.String
getStatusMessageHandling()
Returns whether status messages are displayed for this job.java.lang.String
getStringValue(int attribute)
Returns the value for the specified job attribute, as a String.java.lang.String
getSubsystem()
Returns the fully qualified integrated file system path name of the subsystem description for the subsystem in which the job is running.java.lang.String
getSubtype()
Returns additional information about the job type (if any exists).AS400
getSystem()
Returns the system.java.lang.String[]
getSystemLibraryList()
Returns the system portion of the library list of the initial thread of the job.java.lang.String
getTimeSeparator()
Returns the value used to separate hours, minutes, and seconds when presenting a time.int
getTimeSlice()
Returns the maximum amount of processor time (in milliseconds) given to each thread in this job before other threads in this job and in other jobs are given the opportunity to run.java.lang.String
getTimeSliceEndPool()
Returns a value indicating whether a thread in an interactive job moves to another main storage pool at the end of its time slice.int
getTotalResponseTime()
Returns the total amount of response time for the initial thread, in milliseconds.java.lang.String
getType()
Returns the type of job.java.lang.String
getUser()
Returns the user name.java.lang.String[]
getUserLibraryList()
Returns the user portion of the library list for the initial thread of the job.java.lang.Object
getValue(int attribute)
Returns the value for the specified job attribute.java.lang.String
getWorkIDUnit()
Returns the unit of work identifier.void
hold(boolean holdSpooledFiles)
Holds this job.void
loadInformation()
Refreshes the values for all attributes.void
loadInformation(int[] attributes)
Refreshes the values for specific attributes.void
loadStatistics()
Refreshes just the values for the elapsed statistics.void
release()
Releases this job.void
removePropertyChangeListener(java.beans.PropertyChangeListener listener)
Removes a PropertyChangeListener.void
removeVetoableChangeListener(java.beans.VetoableChangeListener listener)
Removes a VetoableChangeListener.void
resetStatistics()
Resets the measurement start time used for computing elapsed statistics.void
setBreakMessageHandling(java.lang.String breakMessageHandling)
Sets how this job handles break messages.void
setCacheChanges(boolean cacheChanges)
Sets the value indicating whether attribute value changes are committed immediately.void
setCodedCharacterSetID(int codedCharacterSetID)
Sets the coded character set identifier (CCSID) used for this job.void
setCountryID(java.lang.String countryID)
Sets the country or region identifier associated with this job.void
setDateFormat(java.lang.String dateFormat)
Sets the format in which dates are presented.void
setDateSeparator(java.lang.String dateSeparator)
Sets the value used to separate days, months, and years when presenting a date.void
setDDMConversationHandling(java.lang.String ddmConversationHandling)
Sets whether connections using distributed data management (DDM) protocols remain active when they are not being used.void
setDecimalFormat(java.lang.String decimalFormat)
Sets the decimal format used for this job.void
setDefaultWait(int defaultWait)
Sets the default maximum time (in seconds) that a thread in the job waits for a system instruction, such as a LOCK machine interface (MI) instruction, to acquire a resource.void
setDeviceRecoveryAction(java.lang.String deviceRecoveryAction)
Sets the action taken for interactive jobs when an I/O error occurs for the job's requesting program device.void
setInquiryMessageReply(java.lang.String inquiryMessageReply)
Sets how the job answers inquiry messages.void
setInternalJobID(java.lang.String internalJobID)
Deprecated.UsesetInternalJobIdentifier(byte[])
instead. The internal job identifier should be treated as a byte array of 16 bytes.void
setInternalJobIdentifier(byte[] internalJobID)
Sets the internal job identifier.void
setJobAccountingCode(java.lang.String jobAccountingCode)
Sets an identifier assigned to the job by the system to collect resource use information for the job when job accounting is active.void
setJobDate(java.util.Date jobDate)
Sets the date that is assigned to the job.void
setJobMessageQueueFullAction(java.lang.String jobMessageQueueFullAction)
Sets the action to take when the message queue is full.void
setJobSwitches(java.lang.String jobSwitches)
Sets the current setting of the job switches that are used by this job.void
setLanguageID(java.lang.String languageID)
Sets the language identifier associated with this job.void
setLoggingCLPrograms(java.lang.String loggingCLPrograms)
Sets whether or not commands are logged for CL programs that are run.void
setLoggingLevel(int loggingLevel)
Sets what type of information is logged.void
setLoggingSeverity(int loggingSeverity)
Sets the severity level that is used in conjunction with the logging level to determine which error messages are logged in the job log.void
setLoggingText(java.lang.String loggingText)
Sets the level of message text that is written in the job log when a message is logged according to the LOGGING_LEVEL and LOGGING_SEVERITY.void
setName(java.lang.String name)
Sets the job name.void
setNumber(java.lang.String number)
Sets the job number.void
setOutputQueue(java.lang.String outputQueue)
Sets the fully qualified integrated file system path name of the default output queue that is used for spooled output produced by this job.void
setOutputQueuePriority(int outputQueuePriority)
Sets the output priority for spooled output files that this job produces.void
setPrinterDeviceName(java.lang.String printerDeviceName)
Sets the printer device used for printing output from this job.void
setPrintKeyFormat(java.lang.String printKeyFormat)
Sets whether border and header information is provided when the Print key is pressed.void
setPrintText(java.lang.String printText)
Sets the line of text (if any) that is printed at the bottom of each page of printed output for the job.void
setPurge(boolean purge)
Sets the value indicating whether or not the job is eligible to be moved out of main storage and put into auxiliary storage at the end of a time slice or when entering a long wait (such as waiting for a work station user's response).void
setQueue(java.lang.String jobQueue)
Sets the fully qualified integrated file system path name of the job queue that the job is to be on.void
setQueuePriority(int queuePriority)
Sets the scheduling priority of the job compared to other jobs on the same job queue.void
setRunPriority(int runPriority)
Sets the priority at which the job competes for the processing unit relative to the other jobs that are active at the same time.void
setScheduleDate(java.util.Date scheduleDate)
Sets the date and time the job is scheduled to become active.void
setScheduleDate(java.lang.String scheduleDate)
Sets the date the job is scheduled to become active.void
setScheduleTime(java.util.Date scheduleTime)
Sets the date and time the job is scheduled to become active.void
setScheduleTime(java.lang.String scheduleTime)
Sets the time the job is scheduled to become active.void
setSortSequenceTable(java.lang.String sortSequenceTable)
Sets the name of the sort sequence table associated with this job..void
setStatusMessageHandling(java.lang.String statusMessageHandling)
Sets the value which indicates whether status messages are displayed for this job.void
setSystem(AS400 system)
Sets the system.void
setTimeSeparator(java.lang.String timeSeparator)
Sets the value used to separate hours, minutes, and seconds when presenting a time.void
setTimeSlice(int timeSlice)
Sets the maximum amount of processor time (in milliseconds) given to each thread in this job before other threads in this job and in other jobs are given the opportunity to run.void
setTimeSliceEndPool(java.lang.String timeSliceEndPool)
Sets the value which indicates whether a thread in an interactive job moves to another main storage pool at the end of its time slice.void
setUser(java.lang.String user)
Sets the user name.void
setValue(int attribute, java.lang.Object value)
Sets a value for a job attribute.java.lang.String
toString()
Returns the string representation of this Job in the format "number/user/name", or "" if any of these attributes is null.
-
-
-
Field Detail
-
ACCOUNTING_CODE
public static final int ACCOUNTING_CODE
Job attribute representing an identifier assigned to the job by the system to collect resource use information for the job when job accounting is active. The user who is changing this field must have authority to the CHGACGCDE CL command. If the user does not have the proper authority, this field is ignored and processing continues. Possible values are:ACCOUNTING_CODE_BLANK
- An accounting code - The 15 character accounting code used for the next accounting segment. The accounting code may contain alphabetic or numeric characters.
Type: String
-
ACCOUNTING_CODE_BLANK
public static final java.lang.String ACCOUNTING_CODE_BLANK
Constant indicating the accounting code is changed to all blanks.- See Also:
ACCOUNTING_CODE
, Constant Field Values
-
ACTIVE_JOB_STATUS
public static final int ACTIVE_JOB_STATUS
Job attribute representing the active status of the initial thread of a job. Only one status is returned. Possible values are:ACTIVE_JOB_STATUS_NONE
ACTIVE_JOB_STATUS_WAIT_BIN_SYNCH_DEVICE_AND_ACTIVE
ACTIVE_JOB_STATUS_WAIT_BIN_SYNCH_DEVICE
ACTIVE_JOB_STATUS_WAIT_COMM_DEVICE_AND_ACTIVE
ACTIVE_JOB_STATUS_WAIT_COMM_DEVICE
ACTIVE_JOB_STATUS_WAIT_CHECKPOINT
ACTIVE_JOB_STATUS_WAIT_CONDITION
ACTIVE_JOB_STATUS_WAIT_CPI_COMM
ACTIVE_JOB_STATUS_WAIT_DEQUEUE_AND_ACTIVE
ACTIVE_JOB_STATUS_WAIT_DEQUEUE
ACTIVE_JOB_STATUS_WAIT_DISKETTE_AND_ACTIVE
ACTIVE_JOB_STATUS_WAIT_DISKETTE
ACTIVE_JOB_STATUS_WAIT_DELAYED
ACTIVE_JOB_STATUS_DISCONNECTED
ACTIVE_JOB_STATUS_WAIT_DISPLAY_AND_ACTIVE
ACTIVE_JOB_STATUS_WAIT_DISPLAY
ACTIVE_JOB_STATUS_ENDED
ACTIVE_JOB_STATUS_WAIT_DATABASE_EOF_AND_ACTIVE
ACTIVE_JOB_STATUS_WAIT_DATABASE_EOF
ACTIVE_JOB_STATUS_ENDING
ACTIVE_JOB_STATUS_WAIT_EVENT
ACTIVE_JOB_STATUS_SUSPENDED
ACTIVE_JOB_STATUS_HELD
ACTIVE_JOB_STATUS_HELD_THREAD
ACTIVE_JOB_STATUS_WAIT_ICF_FILE_AND_ACTIVE
ACTIVE_JOB_STATUS_WAIT_ICF_FILE
ACTIVE_JOB_STATUS_INELIGIBLE
ACTIVE_JOB_STATUS_WAIT_JAVA_AND_ACTIVE
ACTIVE_JOB_STATUS_WAIT_JAVA
ACTIVE_JOB_STATUS_WAIT_LOCK
ACTIVE_JOB_STATUS_WAIT_LOCK_SPACE_AND_ACTIVE
ACTIVE_JOB_STATUS_WAIT_LOCK_SPACE
ACTIVE_JOB_STATUS_WAIT_MULTIPLE_FILES_AND_ACTIVE
ACTIVE_JOB_STATUS_WAIT_MULTIPLE_FILES
ACTIVE_JOB_STATUS_WAIT_MESSAGE
ACTIVE_JOB_STATUS_WAIT_MUTEX
ACTIVE_JOB_STATUS_WAIT_MIXED_DEVICE_FILE
ACTIVE_JOB_STATUS_WAIT_OPTICAL_DEVICE_AND_ACTIVE
ACTIVE_JOB_STATUS_WAIT_OPTICAL_DEVICE
ACTIVE_JOB_STATUS_WAIT_OSI
ACTIVE_JOB_STATUS_WAIT_PRINT_AND_ACTIVE
ACTIVE_JOB_STATUS_WAIT_PRINT
ACTIVE_JOB_STATUS_WAIT_PRESTART
ACTIVE_JOB_STATUS_RUNNING
ACTIVE_JOB_STATUS_WAIT_SELECTION
ACTIVE_JOB_STATUS_WAIT_SEMAPHORE
ACTIVE_JOB_STATUS_STOPPED
ACTIVE_JOB_STATUS_WAIT_SIGNAL
ACTIVE_JOB_STATUS_SUSPENDED_SYSTEM_REQUEST
ACTIVE_JOB_STATUS_WAIT_SAVE_FILE_AND_ACTIVE
ACTIVE_JOB_STATUS_WAIT_SAVE_FILE
ACTIVE_JOB_STATUS_WAIT_TAPE_DEVICE_AND_ACTIVE
ACTIVE_JOB_STATUS_WAIT_TAPE_DEVICE
ACTIVE_JOB_STATUS_WAIT_THREAD
ACTIVE_JOB_STATUS_WAIT_TIME_INTERVAL_AND_ACTIVE
ACTIVE_JOB_STATUS_WAIT_TIME_INTERVAL
Read-only: true
Type: String
- See Also:
- Constant Field Values
-
ACTIVE_JOB_STATUS_NONE
public static final java.lang.String ACTIVE_JOB_STATUS_NONE
Constant indicating that a job is in transition or is not active.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_BIN_SYNCH_DEVICE_AND_ACTIVE
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_BIN_SYNCH_DEVICE_AND_ACTIVE
Constant indicating that a job is waiting in a pool activity level for the completion of an I/O operation to a binary synchronous device.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_BIN_SYNCH_DEVICE
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_BIN_SYNCH_DEVICE
Constant indicating that a job is waiting for the completion of an I/O operation to a binary synchronous device.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_COMM_DEVICE_AND_ACTIVE
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_COMM_DEVICE_AND_ACTIVE
Constant indicating that a job is waiting in a pool activity level for the completion of an I/O operation to a communications device.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_COMM_DEVICE
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_COMM_DEVICE
Constant indicating that a job is waiting for the completion of an I/O operation to a communications device.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_CHECKPOINT
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_CHECKPOINT
Constant indicating that a job is waiting for the completion of save-while-active checkpoint processing in another job.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_CONDITION
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_CONDITION
Constant indicating that a job is waiting on a handle-based condition.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_CPI_COMM
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_CPI_COMM
Constant indicating that a job is waiting for the completion of a CPI communications call.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_DEQUEUE_AND_ACTIVE
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_DEQUEUE_AND_ACTIVE
Constant indicating that a job is waiting in the pool activity level for completion of a dequeue operation.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_DEQUEUE
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_DEQUEUE
Constant indicating that a job is waiting for completion of a dequeue operation. For example, QSYSARB and subsystem monitors generally wait for work by waiting for a dequeue operation.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_DISKETTE_AND_ACTIVE
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_DISKETTE_AND_ACTIVE
Constant indicating that a job is waiting in a pool activity level for the completion of an I/O operation to a diskette unit.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_DISKETTE
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_DISKETTE
Constant indicating that a job is waiting for the completion of an I/O operation to a diskette unit.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_DELAYED
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_DELAYED
Constant indicating that a job is waiting for a specified time interval to end, or for a specific delay end time, as specified on the Delay Job (DLYJOB) command. The FUNCTION_NAME attribute shows either the number of seconds the job is to delay (999999), or the specific time when the job is to resume running.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_DELAY
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_DELAY
Constant indicating that a job is waiting for a specified time interval to end, or for a specific delay end time, as specified on the Delay Job (DLYJOB) command. The FUNCTION_NAME attribute shows either the number of seconds the job is to delay (999999), or the specific time when the job is to resume running.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_DISCONNECTED
public static final java.lang.String ACTIVE_JOB_STATUS_DISCONNECTED
Constant indicating that a job was disconnected from a work station display.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_DISPLAY_AND_ACTIVE
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_DISPLAY_AND_ACTIVE
Constant indicating that a job is waiting in a pool activity level for input from a work station display.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_DISPLAY
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_DISPLAY
Constant indicating that a job is waiting for input from a work station display.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_ENDED
public static final java.lang.String ACTIVE_JOB_STATUS_ENDED
Constant indicating that a job has been ended with the *IMMED option, or its delay time has ended with the *CNTRLD option.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_DATABASE_EOF_AND_ACTIVE
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_DATABASE_EOF_AND_ACTIVE
Constant indicating that a job is waiting in a pool activity level to try a read operation again on a database file after the end-of-file (EOF) has been reached.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_DATABASE_EOF
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_DATABASE_EOF
Constant indicating that a job is waiting to try a read operation again on a database file after the end-of-file (EOF) has been reached.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_ENDING
public static final java.lang.String ACTIVE_JOB_STATUS_ENDING
Constant indicating that a job is ending for a reason other than running the End Job (ENDJOB) or End Subsystem (ENDSBS) commands, such as a SIGNOFF command, an End Group Job (ENDGRPJOB) command, or an exception that is not handled.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_EVENT
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_EVENT
Constant indicating that a job is waiting for an event. For example, QLUS and SCPF generally wait for work by waiting for an event.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_SUSPENDED
public static final java.lang.String ACTIVE_JOB_STATUS_SUSPENDED
Constant indicating that a job is suspended by a Transfer Group Job (TFRGRPJOB) command.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_HELD
public static final java.lang.String ACTIVE_JOB_STATUS_HELD
Constant indicating that a job is held.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_HELD_THREAD
public static final java.lang.String ACTIVE_JOB_STATUS_HELD_THREAD
Constant indicating that a job is held due to a suspended thread.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_ICF_FILE_AND_ACTIVE
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_ICF_FILE_AND_ACTIVE
Constant indicating that a job is waiting in a pool activity level for the completion of an I/O operation to an intersystem communications function (ICF) file.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_ICF_FILE
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_ICF_FILE
Constant indicating that a job is waiting for the completion of an I/O operation to an intersystem communications function (ICF) file.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_INELIGIBLE
public static final java.lang.String ACTIVE_JOB_STATUS_INELIGIBLE
Constant indicating that a job is ineligible and not currently in a pool activity level.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_JAVA_AND_ACTIVE
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_JAVA_AND_ACTIVE
Constant indicating that a job is waiting in a pool activity level for a Java program operation to complete.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_JAVA
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_JAVA
Constant indicating that a job is waiting for a Java program operation to complete.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_LOCK
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_LOCK
Constant indicating that a job is waiting for a lock.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_LOCK_SPACE_AND_ACTIVE
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_LOCK_SPACE_AND_ACTIVE
Constant indicating that a job is waiting in a pool activity level for for a lock space to be attached.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_LOCK_SPACE
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_LOCK_SPACE
Constant indicating that a job is waiting for a lock space to be attached.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_MULTIPLE_FILES_AND_ACTIVE
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_MULTIPLE_FILES_AND_ACTIVE
Constant indicating that a job is waiting in a pool activity level for the completion of an I/O operation to multiple files.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_MULTIPLE_FILES
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_MULTIPLE_FILES
Constant indicating that a job is waiting for the completion of an I/O operation to multiple files.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_MESSAGE
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_MESSAGE
Constant indicating that a job is waiting for a message from a message queue.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_MUTEX
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_MUTEX
Constant indicating that a job is waiting for a mutex. A mutex is a synchronization function that is used to allow multiple jobs or threads to serialize their access to shared data.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_MIXED_DEVICE_FILE
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_MIXED_DEVICE_FILE
Constant indicating that a job is waiting for the completion of an I/O operation to a mixed device file.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_OPTICAL_DEVICE_AND_ACTIVE
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_OPTICAL_DEVICE_AND_ACTIVE
Constant indicating that a job is waiting in a pool activity level for the completion of an I/O operation to an optical device.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_OPTICAL_DEVICE
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_OPTICAL_DEVICE
Constant indicating that a job is waiting for the completion of an I/O operation to an optical device.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_OSI
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_OSI
Constant indicating that a job is waiting for the completion of an OSI Communications Subsystem operation.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_PRINT_AND_ACTIVE
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_PRINT_AND_ACTIVE
Constant indicating that a job is waiting in a pool activity level for output to a printer to complete.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_PRINT
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_PRINT
Constant indicating that a job is waiting for output to a printer to complete.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_PRESTART
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_PRESTART
Constant indicating that a prestart job is waiting for a program start request.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_RUNNING
public static final java.lang.String ACTIVE_JOB_STATUS_RUNNING
Constant indicating that a job is currently running in a pool activity level.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_SELECTION
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_SELECTION
Constant indicating that a job is waiting for a selection to complete.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_SEMAPHORE
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_SEMAPHORE
Constant indicating that a job is waiting for a semaphore. A semaphore is a synchronization function that is used to allow multiple jobs or threads to serialize their access to shared data.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_STOPPED
public static final java.lang.String ACTIVE_JOB_STATUS_STOPPED
Constant indicating that a job has stopped as the result of a signal.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_SIGNAL
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_SIGNAL
Constant indicating that a job is waiting for a signal.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_SUSPENDED_SYSTEM_REQUEST
public static final java.lang.String ACTIVE_JOB_STATUS_SUSPENDED_SYSTEM_REQUEST
Constant indicating that a job is the suspended half of a system request job pair.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_SAVE_FILE_AND_ACTIVE
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_SAVE_FILE_AND_ACTIVE
Constant indicating that a job is waiting in a pool activity level for the completion of a save file operation.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_SAVE_FILE
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_SAVE_FILE
Constant indicating that a job is waiting for the completion of a save file operation.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_TAPE_DEVICE_AND_ACTIVE
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_TAPE_DEVICE_AND_ACTIVE
Constant indicating that a job is waiting in a pool activity level for the completion of an I/O operation to a tape device.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_TAPE_DEVICE
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_TAPE_DEVICE
Constant indicating that a job is waiting for the completion of an I/O operation to a tape device.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_THREAD
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_THREAD
Constant indicating that a job is waiting for another thread to complete an operation.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_TIME_INTERVAL_AND_ACTIVE
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_TIME_INTERVAL_AND_ACTIVE
Constant indicating that a job is waiting in a pool activity level for a time interval to end.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_WAIT_TIME_INTERVAL
public static final java.lang.String ACTIVE_JOB_STATUS_WAIT_TIME_INTERVAL
Constant indicating that a job is waiting for a time interval to end.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ACTIVE_JOB_STATUS_FOR_JOBS_ENDING
public static final int ACTIVE_JOB_STATUS_FOR_JOBS_ENDING
Job attribute representing the status of what the initial thread of a job is currently doing, when the active job status is ACTIVE_JOB_STATUS_ENDED or ACTIVE_JOB_STATUS_ENDING. This field is blank if the job is not ending currently. SeeACTIVE_JOB_STATUS
for a list of the possible values. For example, the active job status would be ACTIVE_JOB_STATUS_ENDING, but the job could be waiting on a lock that could keep the job from ending. This field would then be ACTIVE_JOB_STATUS_WAIT_LOCK.Read-only: true
Type: String
Only valid on V5R1 systems and higher.
- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ALLOW_MULTIPLE_THREADS
public static final int ALLOW_MULTIPLE_THREADS
Job attribute representing whether a job allows multiple user threads. This attribute does not prevent the operating system from creating system threads in the job. Possible values are:Read-only: true
Type: String
Only valid on V5R1 systems and higher.
- See Also:
- Constant Field Values
-
ALLOW_MULTIPLE_THREADS_NO
public static final java.lang.String ALLOW_MULTIPLE_THREADS_NO
Constant indicating that a job does not allow multiple user threads.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
ALLOW_MULTIPLE_THREADS_YES
public static final java.lang.String ALLOW_MULTIPLE_THREADS_YES
Constant indicating that a job allows multiple user threads.- See Also:
ACTIVE_JOB_STATUS
, Constant Field Values
-
AUXILIARY_IO_REQUESTS
public static final int AUXILIARY_IO_REQUESTS
Job attribute representing the number of auxiliary I/O requests performed by the job across all routing steps. This includes both database and nondatabase paging. If the number of auxiliary I/O requests is greater than or equal to 2,147,483,647, a value of -1 is returned. Use the AUXILIARY_IO_REQUESTS_LARGE attribute to retrieve values that are greater than or equal to 2,147,483,647.Read-only: true
Type: Integer
-
AUXILIARY_IO_REQUESTS_LARGE
public static final int AUXILIARY_IO_REQUESTS_LARGE
Job attribute representing the number of auxiliary I/O requests performed by the job across all routing steps. This includes both database and nondatabase paging.Read-only: true
Type: Long
Only valid on V5R1 systems and higher.
-
BREAK_MESSAGE_HANDLING
public static final int BREAK_MESSAGE_HANDLING
Job attribute representing how a job handles break messages. Possible values are:Type: String
-
BREAK_MESSAGE_HANDLING_NORMAL
public static final java.lang.String BREAK_MESSAGE_HANDLING_NORMAL
Constant indicating that the message queue status determines break message handling.- See Also:
BREAK_MESSAGE_HANDLING
, Constant Field Values
-
BREAK_MESSAGE_HANDLING_HOLD
public static final java.lang.String BREAK_MESSAGE_HANDLING_HOLD
Constant indicating that the message queue holds break messages until a user or program requests them. The work station user uses the Display Message (DPSMSG) command to display the messages; a program must issue a Receive Message (RCVMSG) command to receive a message and handle it.- See Also:
BREAK_MESSAGE_HANDLING
, Constant Field Values
-
BREAK_MESSAGE_HANDLING_NOTIFY
public static final java.lang.String BREAK_MESSAGE_HANDLING_NOTIFY
Constant indicating that the system notifies the job's message queue when a message arrives. For interactive jobs, the audible alarm sounds if there is one, and the message-waiting light comes on.- See Also:
BREAK_MESSAGE_HANDLING
, Constant Field Values
-
CCSID
public static final int CCSID
Job attribute representing the coded character set identifier used for this job. Possible values are:CCSID_SYSTEM_VALUE
CCSID_INITIAL_USER
- A coded character set identifier.
Type: Integer
-
CCSID_SYSTEM_VALUE
public static final int CCSID_SYSTEM_VALUE
Constant indicating that the CCSID specified in the system value QCCSID is used.- See Also:
CCSID
, Constant Field Values
-
CCSID_INITIAL_USER
public static final int CCSID_INITIAL_USER
Constant indicating that the CCSID specified in the user profile under which this thread was initially running is used.- See Also:
CCSID
, Constant Field Values
-
CHARACTER_ID_CONTROL
public static final int CHARACTER_ID_CONTROL
Job attribute representing the character identifier control for a job. This attribute controls the type of CCSID conversion that occurs for display files, printer files, and panel groups. The *CHRIDCTL special value must be specified on the CHRID command parameter on the create, change, or override command for display files, printer files, and panel groups before this attribute will be used. Possible values are:CHARACTER_ID_CONTROL_DEVICE
CHARACTER_ID_CONTROL_JOB
CHARACTER_ID_CONTROL_SYSTEM_VALUE
CHARACTER_ID_CONTROL_INITIAL_USER
Type: String
- See Also:
- Constant Field Values
-
CHARACTER_ID_CONTROL_DEVICE
public static final java.lang.String CHARACTER_ID_CONTROL_DEVICE
Constant indicating to perform the same function for *DEVD as on the CHRID command parameter for display files, printer files, and panel groups.- See Also:
CHARACTER_ID_CONTROL
, Constant Field Values
-
CHARACTER_ID_CONTROL_JOB
public static final java.lang.String CHARACTER_ID_CONTROL_JOB
Constant indicating to perform the same function for *JOBCCSID as on the CHRID command parameter for display files, printer files, and panel groups.- See Also:
CHARACTER_ID_CONTROL
, Constant Field Values
-
CHARACTER_ID_CONTROL_SYSTEM_VALUE
public static final java.lang.String CHARACTER_ID_CONTROL_SYSTEM_VALUE
Constant indicating the value in the QCHRIDCTL system value will be used.- See Also:
CHARACTER_ID_CONTROL
, Constant Field Values
-
CHARACTER_ID_CONTROL_INITIAL_USER
public static final java.lang.String CHARACTER_ID_CONTROL_INITIAL_USER
Constant indicating the CHRIDCTL specified in the user profile under which this thread was initially running will be used.- See Also:
CHARACTER_ID_CONTROL
, Constant Field Values
-
CLIENT_IP_ADDRESS
public static final int CLIENT_IP_ADDRESS
Job attribute representing the IPv4 address of the client for which this system is doing work. An address is expressed in standard IPv4 dotted-decimal form www.xxx.yyy.zzz (for example, 130.99.128.1). This field is not guaranteed to be an IP address. This field will be blank if the address is not explicitly set to a value by the Change Job (QWTCHGJB) API.Read-only: true
Type: String
- See Also:
- Constant Field Values
-
COMPLETION_STATUS
public static final int COMPLETION_STATUS
Job attribute representing the completion status for a job. Possible values are:COMPLETION_STATUS_NOT_COMPLETED
COMPLETION_STATUS_COMPLETED_NORMALLY
COMPLETION_STATUS_COMPLETED_ABNORMALLY
Read-only: true
Type: String
- See Also:
getCompletionStatus()
, Constant Field Values
-
COMPLETION_STATUS_NOT_COMPLETED
public static final java.lang.String COMPLETION_STATUS_NOT_COMPLETED
Constant indicating that the job has not completed.- See Also:
COMPLETION_STATUS
, Constant Field Values
-
COMPLETION_STATUS_COMPLETED_NORMALLY
public static final java.lang.String COMPLETION_STATUS_COMPLETED_NORMALLY
Constant indicating that the job completed normally.- See Also:
COMPLETION_STATUS
, Constant Field Values
-
COMPLETION_STATUS_COMPLETED_ABNORMALLY
public static final java.lang.String COMPLETION_STATUS_COMPLETED_ABNORMALLY
Constant indicating that the job completed abnormally.- See Also:
COMPLETION_STATUS
, Constant Field Values
-
CONTROLLED_END_REQUESTED
public static final int CONTROLLED_END_REQUESTED
Job attribute representing whether or not the system issued a controlled cancellation. Possible values are:Read-only: true
Type: String
- See Also:
- Constant Field Values
-
END_STATUS_CANCELLED
public static final java.lang.String END_STATUS_CANCELLED
Constant indicating that the system, the subsystem in which a job is running, or the job itself is cancelled.
-
END_STATUS_NOT_CANCELLED
public static final java.lang.String END_STATUS_NOT_CANCELLED
Constant indicating that the system, the subsystem in which a job is running, or the job itself is not cancelled.
-
END_STATUS_JOB_NOT_RUNNING
public static final java.lang.String END_STATUS_JOB_NOT_RUNNING
Constant indicating that the job is not running.
-
ELAPSED_CPU_PERCENT_USED
public static final int ELAPSED_CPU_PERCENT_USED
Job attribute representing the percentage of processing time used during the elapsed time. For multiple-processor systems, this is the average across processors.Read-only: true
Type: Integer
- See Also:
resetStatistics()
, Constant Field Values
-
ELAPSED_CPU_PERCENT_USED_FOR_DATABASE
public static final int ELAPSED_CPU_PERCENT_USED_FOR_DATABASE
Job attribute representing the percentage of processing unit used for database processing during the elapsed time. For multiple-processor systems, this is the average across processors.Read-only: true
Type: Integer
- See Also:
resetStatistics()
, Constant Field Values
-
ELAPSED_CPU_TIME_USED
public static final int ELAPSED_CPU_TIME_USED
Job attribute representing the amount of processing unit time (in milliseconds) used during the elapsed time.Read-only: true
Type: Long
- See Also:
resetStatistics()
, Constant Field Values
-
ELAPSED_CPU_TIME_USED_FOR_DATABASE
public static final int ELAPSED_CPU_TIME_USED_FOR_DATABASE
Job attribute representing the amount of processing unit time (in milliseconds) used for database processing during the elapsed time.Read-only: true
Type: Long
- See Also:
resetStatistics()
, Constant Field Values
-
ELAPSED_DISK_IO
public static final int ELAPSED_DISK_IO
Job attribute representing the number of disk I/O operations performed by the job during the elapsed time. This is the sum of theasynchronous
andsynchronous
disk I/O.Read-only: true
Type: Long
- See Also:
resetStatistics()
, Constant Field Values
-
ELAPSED_DISK_IO_ASYNCH
public static final int ELAPSED_DISK_IO_ASYNCH
Job attribute representing the number of asynchronous (physical) disk I/O operations performed by the job during the elapsed time. This is the sum of the asynchronous database and nondatabase reads and writes.Read-only: true
Type: Long
- See Also:
resetStatistics()
, Constant Field Values
-
ELAPSED_DISK_IO_SYNCH
public static final int ELAPSED_DISK_IO_SYNCH
Job attribute representing the number of synchronous (physical) disk I/O operations performed by the job during the elapsed time. This is the sum of the synchronous database and nondatabase reads and writes.Read-only: true
Type: Long
- See Also:
resetStatistics()
, Constant Field Values
-
ELAPSED_INTERACTIVE_RESPONSE_TIME
public static final int ELAPSED_INTERACTIVE_RESPONSE_TIME
Job attribute representing the total interactive response time for the initial thread (in hundredths of seconds) for the job during the elapsed time. This does not include the time used by the machine, by the attached input/output (I/O) hardware, and by the transmission lines for sending and receiving data. This field is 0 for noninteractive jobs.Read-only: true
Type: Integer
- See Also:
resetStatistics()
, Constant Field Values
-
ELAPSED_INTERACTIVE_TRANSACTIONS
public static final int ELAPSED_INTERACTIVE_TRANSACTIONS
Job attribute representing the number of user interactions, such as pressing the Enter key or a function key, for the job during the elapsed time for the initial thread. This field is 0 for noninteractive jobs.Read-only: true
Type: Integer
- See Also:
resetStatistics()
, Constant Field Values
-
ELAPSED_LOCK_WAIT_TIME
public static final int ELAPSED_LOCK_WAIT_TIME
Job attribute representing the amount of time (in milliseconds) that the initial thread has to wait to obtain database, nondatabase, and internal machine locks during the elapsed time.Read-only: true
Type: Long
Can be loaded by JobList: false
- See Also:
resetStatistics()
, Constant Field Values
-
ELAPSED_PAGE_FAULTS
public static final int ELAPSED_PAGE_FAULTS
Job attribute representing the number of times an active program referenced an address that is not in main storage for the current routing step during the elapsed time.Read-only: true
Type: Long
- See Also:
resetStatistics()
, Constant Field Values
-
ELAPSED_TIME
public static final int ELAPSED_TIME
Job attribute representing the time (in milliseconds) that has elapsed between the measurement start time and the current system time. The measurement start time is reset when theresetStatistics()
method is called.Read-only: true
Type: Long
Can be loaded by JobList: false
- See Also:
resetStatistics()
, Constant Field Values
-
COUNTRY_ID
public static final int COUNTRY_ID
Job attribute representing the country or region identifier associated with this job. Possible values are:COUNTRY_ID_SYSTEM_VALUE
COUNTRY_ID_INITIAL_USER
- A country or region identifier.
Type: String
-
COUNTRY_ID_SYSTEM_VALUE
public static final java.lang.String COUNTRY_ID_SYSTEM_VALUE
Constant indicating the system value QCNTRYID is used.- See Also:
COUNTRY_ID
, Constant Field Values
-
COUNTRY_ID_INITIAL_USER
public static final java.lang.String COUNTRY_ID_INITIAL_USER
Constant indicating the country or region ID specified in the user profile under which this thread was initially running is used.- See Also:
COUNTRY_ID
, Constant Field Values
-
CPU_TIME_USED
public static final int CPU_TIME_USED
Job attribute representing the amount of processing unit time (in milliseconds) that the job used. If the processing unit time used is greater than or equal to 2,147,483,647 milliseconds, a value of -1 is returned. Use the CPU_TIME_USED_LARGE attribute to retrieve values that are greater than or equal to 2,147,483,647.Read-only: true
Type: Integer
- See Also:
getCPUUsed()
, Constant Field Values
-
CPU_TIME_USED_LARGE
public static final int CPU_TIME_USED_LARGE
Job attribute representing the amount of processing unit time (in milliseconds) that the job used across all routing steps.Read-only: true
Type: Long
- See Also:
getCPUUsed()
, Constant Field Values
-
CPU_TIME_USED_FOR_DATABASE
public static final int CPU_TIME_USED_FOR_DATABASE
Job attribute representing the amount of processing unit time (in milliseconds) that the job used for processing data base requests across all routing steps.Read-only: true
Type: Long
Only valid on V5R1 systems and higher.
- See Also:
- Constant Field Values
-
CURRENT_LIBRARY
public static final int CURRENT_LIBRARY
Job attribute representing the name of the current library for the initial thread of the job. If no current library exists, the CURRENT_LIBRARY_EXISTENCE attribute returns 0 and this attribute returns an empty string ("").Read-only: true
Type: String
Can be loaded by JobList: false
- See Also:
getCurrentLibrary()
, Constant Field Values
-
CURRENT_LIBRARY_EXISTENCE
public static final int CURRENT_LIBRARY_EXISTENCE
Job attribute representing whether or not a current library exists for the job. Returns 0 if no current library exists; 1 if a current library exists.Read-only: true
Type: Integer
Can be loaded by JobList: false
-
CURRENT_SYSTEM_POOL_ID
public static final int CURRENT_SYSTEM_POOL_ID
Job attribute representing the identifier of the system-related pool from which main storage is currently being allocated for the job's initial thread. These identifiers are not the same as those specified in the subsystem description, but are the same as the system pool identifiers shown on the system status display. If a thread reaches its time-slice end, the pool the thread is running in can be swiched based on the job's time-slice end pool value. The current system pool identifier returned will be the actual pool in which the initial thread of the job is running.Read-only: true
Type: Integer
- See Also:
- Constant Field Values
-
CURRENT_USER
public static final int CURRENT_USER
Job attribute representing the user profile that the initial thread of the job for which information is being retrieved is currently running under. This name may differ from the user portion of the job name.Read-only: true
Type: String
- See Also:
- Constant Field Values
-
DATE_ENDED
public static final int DATE_ENDED
Job attribute representing the date and time when the job completed running on the system.Read-only: true
Type: String in the format CYYMMDDHHMMSS
- See Also:
- Constant Field Values
-
DATE_ENTERED_SYSTEM
public static final int DATE_ENTERED_SYSTEM
Job attribute representing the date and time when the job was placed on the system.Read-only: true
Type: String in the format CYYMMDDHHMMSS
-
DATE_FORMAT
public static final int DATE_FORMAT
Job attribute representing the format in which dates are presented. Possible values are:Type: String
-
DATE_FORMAT_SYSTEM_VALUE
public static final java.lang.String DATE_FORMAT_SYSTEM_VALUE
Constant indicating the system value QDATFMT is used.- See Also:
DATE_FORMAT
, Constant Field Values
-
DATE_FORMAT_YMD
public static final java.lang.String DATE_FORMAT_YMD
Constant indicating a date format of year, month, and day.- See Also:
DATE_FORMAT
, Constant Field Values
-
DATE_FORMAT_MDY
public static final java.lang.String DATE_FORMAT_MDY
Constant indicating a date format of month, day, and year.- See Also:
DATE_FORMAT
, Constant Field Values
-
DATE_FORMAT_DMY
public static final java.lang.String DATE_FORMAT_DMY
Constant indicating a date format of day, month, and year.- See Also:
DATE_FORMAT
, Constant Field Values
-
DATE_FORMAT_JULIAN
public static final java.lang.String DATE_FORMAT_JULIAN
Constant indicating a Julian date format (year and day).- See Also:
DATE_FORMAT
, Constant Field Values
-
DATE_SEPARATOR
public static final int DATE_SEPARATOR
Job attribute representing the value used to separate days, months, and years when presenting a date. Possible values are:DATE_SEPARATOR_SYSTEM_VALUE
DATE_SEPARATOR_SLASH
DATE_SEPARATOR_DASH
DATE_SEPARATOR_PERIOD
DATE_SEPARATOR_BLANK
DATE_SEPARATOR_COMMA
Type: String
-
DATE_SEPARATOR_SYSTEM_VALUE
public static final java.lang.String DATE_SEPARATOR_SYSTEM_VALUE
Constant indicating the system value QDATSEP is used for the date separator.- See Also:
DATE_SEPARATOR
, Constant Field Values
-
DATE_SEPARATOR_SLASH
public static final java.lang.String DATE_SEPARATOR_SLASH
Constant indicating a slash (/) is used for the date separator.- See Also:
DATE_SEPARATOR
, Constant Field Values
-
DATE_SEPARATOR_DASH
public static final java.lang.String DATE_SEPARATOR_DASH
Constant indicating a dash (-) is used for the date separator.- See Also:
DATE_SEPARATOR
, Constant Field Values
-
DATE_SEPARATOR_PERIOD
public static final java.lang.String DATE_SEPARATOR_PERIOD
Constant indicating a period (.) is used for the date separator.- See Also:
DATE_SEPARATOR
, Constant Field Values
-
DATE_SEPARATOR_BLANK
public static final java.lang.String DATE_SEPARATOR_BLANK
Constant indicating a blank is used for the date separator.- See Also:
DATE_SEPARATOR
, Constant Field Values
-
DATE_SEPARATOR_COMMA
public static final java.lang.String DATE_SEPARATOR_COMMA
Constant indicating a comma (,) is used for the date separator.- See Also:
DATE_SEPARATOR
, Constant Field Values
-
DATE_STARTED
public static final int DATE_STARTED
Job attribute representing the date and time when the job began to run on the system. This is blank if the job did not become active.Read-only: true
Type: String in the format CYYMMDDHHMMSS
- See Also:
getJobActiveDate()
, Constant Field Values
-
DBCS_CAPABLE
public static final int DBCS_CAPABLE
Job attribute representing whether the job is DBCS-capable or not. Possible values are:Read-only: true
Type: String
- See Also:
- Constant Field Values
-
DBCS_CAPABLE_NO
public static final java.lang.String DBCS_CAPABLE_NO
Constant indicating that the job is not DBCS-capable.- See Also:
DBCS_CAPABLE
, Constant Field Values
-
DBCS_CAPABLE_YES
public static final java.lang.String DBCS_CAPABLE_YES
Constant indicating that the job is DBCS-capable.- See Also:
DBCS_CAPABLE
, Constant Field Values
-
DECIMAL_FORMAT
public static final int DECIMAL_FORMAT
Job attribute representing the decimal format used for this job. Possible values are:Type: String
-
DECIMAL_FORMAT_SYSTEM_VALUE
public static final java.lang.String DECIMAL_FORMAT_SYSTEM_VALUE
Constant indicating the value in the system value QDECFMT is used as the decimal format for this job.- See Also:
DECIMAL_FORMAT
, Constant Field Values
-
DECIMAL_FORMAT_PERIOD
public static final java.lang.String DECIMAL_FORMAT_PERIOD
Constant indicating a decimal format that uses a period for a decimal point, a comma for a 3-digit grouping character, and zero-suppresses to the left of the decimal point.- See Also:
DECIMAL_FORMAT
, Constant Field Values
-
DECIMAL_FORMAT_COMMA_J
public static final java.lang.String DECIMAL_FORMAT_COMMA_J
Constant indicating a decimal format that uses a comma for a decimal point and a period for a 3-digit grouping character. The zero-suppression character is in the second position (rather than the first) to the left of the decimal notation. Balances with zero values to the left of the comma are written with one leading zero (0,04). This constant also overrides any edit codes that might suppress the leading zero.- See Also:
DECIMAL_FORMAT
, Constant Field Values
-
DECIMAL_FORMAT_COMMA_I
public static final java.lang.String DECIMAL_FORMAT_COMMA_I
Constant indicating a decimal format that uses a comma for a decimal point, a period for a 3-digit grouping character, and zero-suppresses to the left of the decimal point.- See Also:
DECIMAL_FORMAT
, Constant Field Values
-
DEFAULT_CCSID
public static final int DEFAULT_CCSID
Job attribute representing the default coded character set identifier (CCSID) used for this job. This attribute returns zero if the job is not an active job.Read-only: true
Type: Integer
-
DEFAULT_WAIT_TIME
public static final int DEFAULT_WAIT_TIME
Job attribute representing the default maximum time (in seconds) that a thread in the job waits for a system instruction, such as a LOCK machine interface (MI) instruction, to acquire a resource. This default wait time is used when a wait time is not otherwise specified for a given situation. Normally, this is the amount of time the user is willing to wait for the system before the request is ended. If the job consists of multiple routing steps, a change to this attribute during a routing step does not appy to subsequent routing steps. The valid range is 1 through 9999999. A value of -1 represents no maximum wait time (*NOMAX).Type: Integer
-
DEVICE_RECOVERY_ACTION
public static final int DEVICE_RECOVERY_ACTION
Job attribute representing the action taken for interactive jobs when an I/O error occurs for the job's requesting program device. Possible values are:DEVICE_RECOVERY_ACTION_SYSTEM_VALUE
DEVICE_RECOVERY_ACTION_MESSAGE
DEVICE_RECOVERY_ACTION_DISCONNECT_MESSAGE
DEVICE_RECOVERY_ACTION_DISCONNECT_END_REQUEST
DEVICE_RECOVERY_ACTION_END_JOB
DEVICE_RECOVERY_ACTION_END_JOB_NO_LIST
Type: String
-
DEVICE_RECOVERY_ACTION_SYSTEM_VALUE
public static final java.lang.String DEVICE_RECOVERY_ACTION_SYSTEM_VALUE
Constant indicating the value in the system value QDEVRCYACN is used as the device recovery action for this job.- See Also:
DEVICE_RECOVERY_ACTION
, Constant Field Values
-
DEVICE_RECOVERY_ACTION_MESSAGE
public static final java.lang.String DEVICE_RECOVERY_ACTION_MESSAGE
Constant indicating a device recovery action that signals the I/O error message to the application and lets the application program perform error recovery.- See Also:
DEVICE_RECOVERY_ACTION
, Constant Field Values
-
DEVICE_RECOVERY_ACTION_DISCONNECT_MESSAGE
public static final java.lang.String DEVICE_RECOVERY_ACTION_DISCONNECT_MESSAGE
Constant indicating a device recovery action that disconnects the job when an I/O error occurs. When the job reconnects, the system sends an error message to the application program, indicating the job has reconnected and that the work station device has recovered.- See Also:
DEVICE_RECOVERY_ACTION
, Constant Field Values
-
DEVICE_RECOVERY_ACTION_DISCONNECT_END_REQUEST
public static final java.lang.String DEVICE_RECOVERY_ACTION_DISCONNECT_END_REQUEST
Constant indicating a device recovery action that disconnects the job when an I/O error occurs. When the job reconnects, the system sends the End Request (ENDRQS) command to return control to the previous request level.- See Also:
DEVICE_RECOVERY_ACTION
, Constant Field Values
-
DEVICE_RECOVERY_ACTION_END_JOB
public static final java.lang.String DEVICE_RECOVERY_ACTION_END_JOB
Constant indicating a device recovery action that ends the job when an I/O error occurs. A message is sent to the job's log and to the history log (QHST) indicating the job ended because of a device error.- See Also:
DEVICE_RECOVERY_ACTION
, Constant Field Values
-
DEVICE_RECOVERY_ACTION_END_JOB_NO_LIST
public static final java.lang.String DEVICE_RECOVERY_ACTION_END_JOB_NO_LIST
Constant indicating a device recovery action that ends the job when an I/O error occurs. There is no job log produced for the job. The system sends a message to the QHST log indicating the job ended because of a device error.- See Also:
DEVICE_RECOVERY_ACTION
, Constant Field Values
-
ELIGIBLE_FOR_PURGE
public static final int ELIGIBLE_FOR_PURGE
Job attribute representing whether or not the job is eligible to be moved out of main storage and put into auxiliary storage at the end of a time slice or when entering a long wait (such as waiting for a work station user's response). This attribute is ignored when more than one thread is active within the job. If the job consists of multiple routing steps, a change to this attribute during a routing step does not apply to subsequent routing steps. Possible values are:Type: String
- See Also:
getPurge()
,setPurge(boolean)
, Constant Field Values
-
ELIGIBLE_FOR_PURGE_YES
public static final java.lang.String ELIGIBLE_FOR_PURGE_YES
Constant indicating that the job is eligible to be moved out of main storage and put into auxiliary storage. A job with multiple threads, however, is never purged from main storage.- See Also:
ELIGIBLE_FOR_PURGE
, Constant Field Values
-
ELIGIBLE_FOR_PURGE_NO
public static final java.lang.String ELIGIBLE_FOR_PURGE_NO
Constant indicating that a job is not eligible to be moved out of main storage and put into auxiliary storage. When main storage is needed, however, pages belonging to a thread in the job may be moved to auxiliary storage. Then, when a thread in the job runs again, its pages are returned to main storage as they are needed.- See Also:
ELIGIBLE_FOR_PURGE
, Constant Field Values
-
ELIGIBLE_FOR_PURGE_IGNORED
public static final java.lang.String ELIGIBLE_FOR_PURGE_IGNORED
Constant indicating that whether a job is eligible for purge or not is ignored because the job type is either *JOBQ or *OUTQ, or the job is not valid.- See Also:
ELIGIBLE_FOR_PURGE
, Constant Field Values
-
END_SEVERITY
public static final int END_SEVERITY
Job attribute representing the message severity level of escape messages that can cause a batch job to end. The batch job ends when a request in the batch input stream sends an escape message, whose severity is equal to or greater than this value, to the request processing program.Read-only: true
Type: Integer
- See Also:
getEndSeverity()
, Constant Field Values
-
FUNCTION_NAME
public static final int FUNCTION_NAME
Job attribute representing additional information (as described by the FUNCTION_TYPE attribute) about the last high-level function initiated by the initial thread.Read-only: true
Type: String
- See Also:
getFunctionName()
, Constant Field Values
-
FUNCTION_TYPE
public static final int FUNCTION_TYPE
Job attribute representing the last high-level function initiated by the initial thread. This field may not be cleared when a function is completed. Possible values are:FUNCTION_TYPE_BLANK
FUNCTION_TYPE_COMMAND
FUNCTION_TYPE_DELAY
FUNCTION_TYPE_GROUP
FUNCTION_TYPE_INDEX
FUNCTION_TYPE_JAVA
FUNCTION_TYPE_LOG
FUNCTION_TYPE_MRT
FUNCTION_TYPE_MENU
FUNCTION_TYPE_IO
FUNCTION_TYPE_PROCEDURE
FUNCTION_TYPE_PROGRAM
FUNCTION_TYPE_SPECIAL
Read-only: true
Type: String
- See Also:
getFunctionType()
, Constant Field Values
-
FUNCTION_TYPE_BLANK
public static final java.lang.String FUNCTION_TYPE_BLANK
Constant indicating that the system is not performing a logged function.- See Also:
FUNCTION_TYPE
, Constant Field Values
-
FUNCTION_TYPE_COMMAND
public static final java.lang.String FUNCTION_TYPE_COMMAND
Constant indicating that a command is running interactively, or it is in a batch input stream, or it was requested from a system menu. Commands in CL programs or REXX procedures are not logged. The FUNCTION_NAME attribute contains the name of the command and is only updated when a command is processed.- See Also:
FUNCTION_TYPE
, Constant Field Values
-
FUNCTION_TYPE_DELAY
public static final java.lang.String FUNCTION_TYPE_DELAY
Constant indicating that the initial thread of the job is processing a Delay Job (DLYJOB) command. The FUNCTION_NAME attribute contains the number of seconds the job is delayed (up to 999999 seconds), or the time when the job is to resume processing (HH:MM:SS), depending on how you specified the command.- See Also:
FUNCTION_TYPE
, Constant Field Values
-
FUNCTION_TYPE_GROUP
public static final java.lang.String FUNCTION_TYPE_GROUP
Constant indicating that the Transfer Group Job (TFRGRPJOB) command suspended the job. The FUNCTION_NAME attribute contains the group job name for that job.- See Also:
FUNCTION_TYPE
, Constant Field Values
-
FUNCTION_TYPE_INDEX
public static final java.lang.String FUNCTION_TYPE_INDEX
Constant indicating that the initial thread of the job is rebuilding an index (access path). The FUNCTION_NAME attribute contains the name of the logical file whose index is rebuilt.- See Also:
FUNCTION_TYPE
, Constant Field Values
-
FUNCTION_TYPE_JAVA
public static final java.lang.String FUNCTION_TYPE_JAVA
Constant indicating that the initial thread of the job is running a Java Vertual Machine (JVM). The FUNCTION_NAME attribute contains the name of the java class.- See Also:
FUNCTION_TYPE
, Constant Field Values
-
FUNCTION_TYPE_LOG
public static final java.lang.String FUNCTION_TYPE_LOG
Constant indicating that the system logs history information in a database file. The FUNCTION_NAME attribute contains the name of the log (QHST is the only log currently supported).- See Also:
FUNCTION_TYPE
, Constant Field Values
-
FUNCTION_TYPE_MRT
public static final java.lang.String FUNCTION_TYPE_MRT
Constant indicating that the job is a multiple requester terminal (MRT) job if theJOB_TYPE
isJOB_TYPE_BATCH
and theJOB_SUBTYPE
isJOB_SUBTYPE_MRT
, or it is an interactive job attached to an MRT job if theJOB_TYPE
isJOB_TYPE_INTERACTIVE
.For MRT jobs, the FUNCTION_NAME attribute contains information in the following format:
- CHAR(2): The number of requesters currently attached to the MRT job.
- CHAR(1): The field is reserved for a / (slash).
- CHAR(2): The maximum number (MRTMAX) of requesters.
- CHAR(1): Reserved.
- CHAR(3): The never-ending program (NEP) indicator. If an MRT is also an NEP, the MRT stays active even if there are no requesters of the MRT. A value of NEP indicates a never-ending program. A value of blanks indicates that it is not a never-ending program.
- CHAR(1): Reserved.
For interactive jobs attached to an MRT, the FUNCTION_NAME attribute contains the name of the MRT procedure.
- See Also:
FUNCTION_TYPE
, Constant Field Values
-
FUNCTION_TYPE_MENU
public static final java.lang.String FUNCTION_TYPE_MENU
Constant indicating that the initial thread of the job is currently at a system menu. The FUNCTION_NAME field contains the name of the menu.- See Also:
FUNCTION_TYPE
, Constant Field Values
-
FUNCTION_TYPE_IO
public static final java.lang.String FUNCTION_TYPE_IO
Constant indicating that the job is a subsystem monitor that is performing input/output (I/O) operations to a work station. The FUNCTION_NAME attribute contains the name of the work station device to which the subsystem is performing an input/output operation.- See Also:
FUNCTION_TYPE
, Constant Field Values
-
FUNCTION_TYPE_PROCEDURE
public static final java.lang.String FUNCTION_TYPE_PROCEDURE
Constant indicating that the initial thread of the job is running a procedure. The FUNCTION_NAME attribute contains the name of the procedure.- See Also:
FUNCTION_TYPE
, Constant Field Values
-
FUNCTION_TYPE_PROGRAM
public static final java.lang.String FUNCTION_TYPE_PROGRAM
Constant indicating that the initial thread of the job is running a program. The FUNCTION_NAME attribute contains the name of the program.- See Also:
FUNCTION_TYPE
, Constant Field Values
-
FUNCTION_TYPE_SPECIAL
public static final java.lang.String FUNCTION_TYPE_SPECIAL
Constant indicating that the function type is a special function. For this value, the FUNCTION_NAME attribute contains one of the following values:- ADLACTJOB: Auxiliary storage is being allocated for the number of active jobs specified in the QADLACTJ system value. This may indicate that the system value for the initial number of active jobs is too low.
- ADLTOTJOB: Auxiliary storage is being allocated for the number of jobs specified in the QADLTOTJ system value.
- CMDENT: The Command Entry display is being used.
- COMMIT: A commit operation is being performed.
- DIRSHD: Directory shadowing.
- DLTSPLF: The system is deleting a spooled file.
- DUMP: A dump is in process.
- JOBIDXRCY: A damaged job index is being recovered.
- JOBLOG: The system is producing a job log.
- PASSTHRU: The job is a pass-through job.
- RCLSPLSTG: Empty spooled database members are being deleted.
- ROLLBACK: A rollback operation is being performed.
- SPLCLNUP: Spool cleanup is in process.
- See Also:
FUNCTION_TYPE
, Constant Field Values
-
INITIAL_THREAD
public static final long INITIAL_THREAD
Constant indicating that the initial thread of the job should be used when retrieving the call stack.- See Also:
getCallStack(long)
, Constant Field Values
-
INQUIRY_MESSAGE_REPLY
public static final int INQUIRY_MESSAGE_REPLY
Job attribute representing how the job answers inquiry messages. Possible values are:INQUIRY_MESSAGE_REPLY_REQUIRED
INQUIRY_MESSAGE_REPLY_DEFAULT
INQUIRY_MESSAGE_REPLY_SYSTEM_REPLY_LIST
Type: String
-
INQUIRY_MESSAGE_REPLY_REQUIRED
public static final java.lang.String INQUIRY_MESSAGE_REPLY_REQUIRED
Constant indicating that the job requires an answer for any inquiry messages that occur while this job is running.- See Also:
INQUIRY_MESSAGE_REPLY
, Constant Field Values
-
INQUIRY_MESSAGE_REPLY_DEFAULT
public static final java.lang.String INQUIRY_MESSAGE_REPLY_DEFAULT
Constant indicating that the system uses the default message reply to answer any inquiry messages issued while this job is running. The default reply is either defined in the message description or is the default system reply.- See Also:
INQUIRY_MESSAGE_REPLY
, Constant Field Values
-
INQUIRY_MESSAGE_REPLY_SYSTEM_REPLY_LIST
public static final java.lang.String INQUIRY_MESSAGE_REPLY_SYSTEM_REPLY_LIST
Constant indicating that the system reply list is checked to see if there is an entry for an inquiry message issued while this job is running. If a match occurs, the system uses the reply value for that entry. If no entry exists for that message, the system uses an inquiry message.- See Also:
INQUIRY_MESSAGE_REPLY
, Constant Field Values
-
INTERACTIVE_TRANSACTIONS
public static final int INTERACTIVE_TRANSACTIONS
Job attribute representing the count of operator interactions, such as pressing the Enter key or a function key. This field is zero for jobs that have no interactions.Read-only: true
Type: Integer
-
INTERNAL_JOB_ID
public static final int INTERNAL_JOB_ID
Deprecated. UseINTERNAL_JOB_IDENTIFIER
instead. The internal job identifier should be treated as a byte array of 16 bytes.Job attribute representing the value input to other APIs to increase the speed of locating the job on the system. The identifier is not valid following an initial program load (IPL). If you attempt to use it after an IPL, an exception occurs.Read-only: true
Type: String
Can be loaded by JobList: false
- See Also:
getInternalJobID()
, Constant Field Values
-
INTERNAL_JOB_IDENTIFIER
public static final int INTERNAL_JOB_IDENTIFIER
Job attribute representing the value input to other APIs to increase the speed of locating the job on the system. The identifier is not valid following an initial program load (IPL). If you attempt to use it after an IPL, an exception occurs.Read-only: true
Type: byte array
Can be loaded by JobList: false
-
JOB_DATE
public static final int JOB_DATE
Job attribute representing the date used for the job. This value is for jobs whose status is *JOBQ or *ACTIVE. For jobs with a status of *OUTQ, the value for this field is blank.Type: String in the format CYYMMDD
-
JOB_DESCRIPTION
public static final int JOB_DESCRIPTION
Job attribute representing a set of job-related attributes used for one or more jobs on the system. These attributes determine how the job is run on the system. Multiple jobs can also use the same job description.Read-only: true
Type: String
- See Also:
getJobDescription()
, Constant Field Values
-
JOB_END_REASON
public static final int JOB_END_REASON
Job attribute representing the most recent action that caused the job to end. Possible values are:- 0: Job not ending.
- 1: Job ending in a normal manner.
- 2: Job ended while it was still on a job queue.
- 3: System ended abnormally.
- 4: Job ending normally after a controlled end was requested.
- 5: Job ending immediately.
- 6: Job ending abnormally.
- 7: Job ended due to the CPU limit being exceeded.
- 8: Job ended due to the storage limit being exceeded.
- 9: Job ended due to the message severity level bein exceeded.
- 10: Job ended due to the disconnect time interval being exceeded.
- 11: Job ended due to the inactivity time interval being exceeded.
- 12: Job ended due to a device error.
- 13: Job ended due to a signal.
- 14: Job ended due to an unhandled error.
Read-only: true
Type: Integer
Only valid on V5R1 systems and higher.
- See Also:
- Constant Field Values
-
JOB_LOG_OUTPUT
public static final int JOB_LOG_OUTPUT
Job attribute representing how a job log will be produced when the job completes. This does not affect job logs produced when the message queue is full and the job message queue full action specifies *PRTWRAP. Messages in the job messages queue are written to a spooled file, from which the job log can be printed, unless the Control Job Log Output (QMHCTLJL) API was used in the job to specify that the messages in the job log are to be written to a database file.The job log output value can be changed at any time until the job log has been produced or removed. To change the job log output value for a job, use the Change Job (QWTCHGJB) API or the Change Job (CHGJOB) command.
The job log can be displayed at any time until the job log has been produced or removed. To display a job's job log, use the Display Job Log (DSPJOBLOG) command.
The job log can be removed when the job has completed and the job log has not yet been produced or removed. To remove the job log, use the Remove Pending Job Log (QWTRMVJL) API or the End Job (ENDJOB) command.
Possible values are:
JOB_LOG_OUTPUT_SYSTEM_VALUE
JOB_LOG_OUTPUT_JOB_LOG_SERVER
JOB_LOG_OUTPUT_JOB_END
JOB_LOG_OUTPUT_PENDING
Type: String
Only valid on V5R4 systems and higher.
- See Also:
- Constant Field Values
-
JOB_LOG_OUTPUT_SYSTEM_VALUE
public static final java.lang.String JOB_LOG_OUTPUT_SYSTEM_VALUE
Constant indicating that the value is specifed by the QLOGOUTPUT system value.- See Also:
JOB_LOG_OUTPUT
, Constant Field Values
-
JOB_LOG_OUTPUT_JOB_LOG_SERVER
public static final java.lang.String JOB_LOG_OUTPUT_JOB_LOG_SERVER
Constant indicating that the job log will be produced by a job log server. For more information about job log servers, refer to the Start Job Log Server (STRLOGSVR) command.- See Also:
JOB_LOG_OUTPUT
, Constant Field Values
-
JOB_LOG_OUTPUT_JOB_END
public static final java.lang.String JOB_LOG_OUTPUT_JOB_END
Constant indicating that the job log will be produced by the job itself. If the job cannot produce its own job log, the job log will be produced by a job log server. For example, a job does not produce its own job log when the system is processing a Power Down System (PWRDWNSYS) command.- See Also:
JOB_LOG_OUTPUT
, Constant Field Values
-
JOB_LOG_OUTPUT_PENDING
public static final java.lang.String JOB_LOG_OUTPUT_PENDING
Constant indicating that the job log will not be produced. The job log remains pending until removed.- See Also:
JOB_LOG_OUTPUT
, Constant Field Values
-
JOB_LOG_PENDING
public static final int JOB_LOG_PENDING
Job attribute representing whether a job's log has been written or not. If the system fails while the job was active or the job ends abnormally, the job log may not be written yet. This flag remains on until the job log has been written. Possible values are:Read-only: true
Type: String
Only valid on V5R1 systems and higher.
- See Also:
- Constant Field Values
-
JOB_LOG_PENDING_NO
public static final java.lang.String JOB_LOG_PENDING_NO
Constant indicating that the job log is not pending.- See Also:
JOB_LOG_PENDING
, Constant Field Values
-
JOB_LOG_PENDING_YES
public static final java.lang.String JOB_LOG_PENDING_YES
Constant indicating that the job log is pending and waiting to be written.- See Also:
JOB_LOG_PENDING
, Constant Field Values
-
JOB_NAME
public static final int JOB_NAME
Job attribute representing the name of the job as identified to the system. For an interactive job, the system assigns the job name of the work station where the job started; for a batch job, you specify the name in the command when you submit the job. Possible values are:- A specific job name.
JOB_NAME_INTERNAL
JOB_NAME_CURRENT
Type: String
-
JOB_NAME_INTERNAL
public static final java.lang.String JOB_NAME_INTERNAL
Constant indicating that the INTERNAL_JOB_ID locates the job. The user name and job number must be blank.- See Also:
JOB_NAME
, Constant Field Values
-
JOB_NAME_CURRENT
public static final java.lang.String JOB_NAME_CURRENT
Constant indicating the job that this program is running in. The user name and job number must be blank.- See Also:
JOB_NAME
, Constant Field Values
-
JOB_NUMBER
public static final int JOB_NUMBER
Job attribute representing the system-generated job number. Possible values are:- A specific job number.
JOB_NUMBER_BLANK
Type: String
-
JOB_NUMBER_BLANK
public static final java.lang.String JOB_NUMBER_BLANK
Constant indicating a blank job number. This must be used if JOB_NAME_INTERNAL or JOB_NAME_CURRENT is specified for the JOB_NAME.- See Also:
JOB_NUMBER
, Constant Field Values
-
JOB_QUEUE
public static final int JOB_QUEUE
Job attribute representing the name of the job queue that the job is currently on, or that the job was on if it is currently active. This attribute is valid to be set for jobs whose status is *JOBQ. Attempting to set this attribute for jobs with a status of *OUTQ or *ACTIVE will cause an error to be signaled. This attribute is valid to be retrieved for jobs whose status is *JOBQ or *ACTIVE. Retrieving this attribute for jobs with a status of *OUTQ will return a value of blanks.Type: String
-
JOB_QUEUE_DATE
public static final int JOB_QUEUE_DATE
Job attribute representing the date and time this job was put on this job queue. This field will contain blanks if the job was not on a job queue.Read-only: true
Type: String in the system timestamp format
-
JOB_QUEUE_PRIORITY
public static final int JOB_QUEUE_PRIORITY
Job attribute representing the scheduling priority of the job compared to other jobs on the same job queue. The highest priority is 0 and the lowest is 9. This value is valid for jobs whose status is *JOBQ or *ACTIVE. For jobs with a status of *OUTQ, attempting to set this attribute will cause an error to be signaled and Retrieving this attribute will return a value of blanks.Type: String
-
JOB_QUEUE_STATUS
public static final int JOB_QUEUE_STATUS
Job attribute representing the status of this job on the job queue. Possible values are:Read-only: true
Type: String
-
JOB_QUEUE_STATUS_BLANK
public static final java.lang.String JOB_QUEUE_STATUS_BLANK
Constant indicating that this job was not on a job queue.- See Also:
JOB_QUEUE_STATUS
, Constant Field Values
-
JOB_QUEUE_STATUS_SCHEDULED
public static final java.lang.String JOB_QUEUE_STATUS_SCHEDULED
Constant indicating that this job will run as scheduled.- See Also:
JOB_QUEUE_STATUS
, Constant Field Values
-
JOB_QUEUE_STATUS_HELD
public static final java.lang.String JOB_QUEUE_STATUS_HELD
Constant indicating that this job is being held on the job queue.- See Also:
JOB_QUEUE_STATUS
, Constant Field Values
-
JOB_QUEUE_STATUS_READY
public static final java.lang.String JOB_QUEUE_STATUS_READY
Constant indicating that this job is ready to be selected.- See Also:
JOB_QUEUE_STATUS
, Constant Field Values
-
JOB_STATUS
public static final int JOB_STATUS
Job attribute representing the status of this job. Possible values are:Read-only: true
Type: String
- See Also:
getStatus()
, Constant Field Values
-
JOB_STATUS_ACTIVE
public static final java.lang.String JOB_STATUS_ACTIVE
Constant indicating this job is an active job. This includes group jobs, system request jobs, and disconnected jobs.- See Also:
JOB_STATUS
, Constant Field Values
-
JOB_STATUS_JOBQ
public static final java.lang.String JOB_STATUS_JOBQ
Constant indicating this job is currently on a job queue.- See Also:
JOB_STATUS
, Constant Field Values
-
JOB_STATUS_OUTQ
public static final java.lang.String JOB_STATUS_OUTQ
Constant indicating this job has completed running, but still has output on an output queue.- See Also:
JOB_STATUS
, Constant Field Values
-
JOB_SUBTYPE
public static final int JOB_SUBTYPE
Job attribute representing additional information about the job type (if any exists). Possible values are:JOB_SUBTYPE_BLANK
JOB_SUBTYPE_IMMEDIATE
JOB_SUBTYPE_PROCEDURE_START_REQUEST
JOB_SUBTYPE_MACHINE_SERVER_JOB
JOB_SUBTYPE_PRESTART
JOB_SUBTYPE_PRINT_DRIVER
JOB_SUBTYPE_MRT
JOB_SUBTYPE_ALTERNATE_SPOOL_USER
Read-only: true
Type: String
- See Also:
getSubtype()
, Constant Field Values
-
JOB_SUBTYPE_BLANK
public static final java.lang.String JOB_SUBTYPE_BLANK
Constant indicating that the job has no special subtype or is not a valid job.- See Also:
JOB_SUBTYPE
, Constant Field Values
-
JOB_SUBTYPE_IMMEDIATE
public static final java.lang.String JOB_SUBTYPE_IMMEDIATE
Constant indicating that the job is an immediate job.- See Also:
JOB_SUBTYPE
, Constant Field Values
-
JOB_SUBTYPE_PROCEDURE_START_REQUEST
public static final java.lang.String JOB_SUBTYPE_PROCEDURE_START_REQUEST
Constant indicating that the job started with a procedure start request.- See Also:
JOB_SUBTYPE
, Constant Field Values
-
JOB_SUBTYPE_MACHINE_SERVER_JOB
public static final java.lang.String JOB_SUBTYPE_MACHINE_SERVER_JOB
Constant indicating that the job is an AS/400 Advanced 36 machine server job.- See Also:
JOB_SUBTYPE
, Constant Field Values
-
JOB_SUBTYPE_PRESTART
public static final java.lang.String JOB_SUBTYPE_PRESTART
Constant indicating that the job is a prestart job.- See Also:
JOB_SUBTYPE
, Constant Field Values
-
JOB_SUBTYPE_PRINT_DRIVER
public static final java.lang.String JOB_SUBTYPE_PRINT_DRIVER
Constant indicating that the job is a print driver job.- See Also:
JOB_SUBTYPE
, Constant Field Values
-
JOB_SUBTYPE_MRT
public static final java.lang.String JOB_SUBTYPE_MRT
Constant indicating that the job is a System/36 multiple requester terminal (MRT) job.- See Also:
JOB_SUBTYPE
, Constant Field Values
-
JOB_SUBTYPE_ALTERNATE_SPOOL_USER
public static final java.lang.String JOB_SUBTYPE_ALTERNATE_SPOOL_USER
Constant indicating that the job is an alternate spool user job.- See Also:
JOB_SUBTYPE
, Constant Field Values
-
JOB_SWITCHES
public static final int JOB_SWITCHES
Job attribute representing the current setting of the job switches used by this job. This value is valid for all job types.Type: String
-
JOB_TYPE
public static final int JOB_TYPE
Job attribute representing the type of job. Possible values are:JOB_TYPE_NOT_VALID
JOB_TYPE_AUTOSTART
JOB_TYPE_BATCH
JOB_TYPE_INTERACTIVE
JOB_TYPE_SUBSYSTEM_MONITOR
JOB_TYPE_SPOOLED_READER
JOB_TYPE_SYSTEM
JOB_TYPE_SPOOLED_WRITER
JOB_TYPE_SCPF_SYSTEM
Read-only: true
Type: String
- See Also:
getType()
, Constant Field Values
-
JOB_TYPE_NOT_VALID
public static final java.lang.String JOB_TYPE_NOT_VALID
Constant indicating that the job is not a valid job.- See Also:
JOB_TYPE
, Constant Field Values
-
JOB_TYPE_AUTOSTART
public static final java.lang.String JOB_TYPE_AUTOSTART
Constant indicating that the job is an autostart job.- See Also:
JOB_TYPE
, Constant Field Values
-
JOB_TYPE_BATCH
public static final java.lang.String JOB_TYPE_BATCH
Constant indicating that the job is a batch job.- See Also:
JOB_TYPE
, Constant Field Values
-
JOB_TYPE_INTERACTIVE
public static final java.lang.String JOB_TYPE_INTERACTIVE
Constant indicating that the job is an interactive job.- See Also:
JOB_TYPE
, Constant Field Values
-
JOB_TYPE_SUBSYSTEM_MONITOR
public static final java.lang.String JOB_TYPE_SUBSYSTEM_MONITOR
Constant indicating that the job is a subsystem monitor job.- See Also:
JOB_TYPE
, Constant Field Values
-
JOB_TYPE_SPOOLED_READER
public static final java.lang.String JOB_TYPE_SPOOLED_READER
Constant indicating that the job is a spooled reader job.- See Also:
JOB_TYPE
, Constant Field Values
-
JOB_TYPE_SYSTEM
public static final java.lang.String JOB_TYPE_SYSTEM
Constant indicating that the job is a system job.- See Also:
JOB_TYPE
, Constant Field Values
-
JOB_TYPE_SPOOLED_WRITER
public static final java.lang.String JOB_TYPE_SPOOLED_WRITER
Constant indicating that the job is a spooled writer job.- See Also:
JOB_TYPE
, Constant Field Values
-
JOB_TYPE_SCPF_SYSTEM
public static final java.lang.String JOB_TYPE_SCPF_SYSTEM
Constant indicating that the job is the SCPF system job.- See Also:
JOB_TYPE
, Constant Field Values
-
JOB_TYPE_ENHANCED
public static final int JOB_TYPE_ENHANCED
Job attribute representing the type of job. This attribute combines the JOB_TYPE and JOB_SUBTYPE attributes. Possible values are:JOB_TYPE_ENHANCED_AUTOSTART
JOB_TYPE_ENHANCED_BATCH
JOB_TYPE_ENHANCED_BATCH_IMMEDIATE
JOB_TYPE_ENHANCED_BATCH_MRT
JOB_TYPE_ENHANCED_BATCH_ALTERNATE_SPOOL_USER
JOB_TYPE_ENHANCED_COMM_PROCEDURE_START_REQUEST
JOB_TYPE_ENHANCED_INTERACTIVE
JOB_TYPE_ENHANCED_INTERACTIVE_GROUP
JOB_TYPE_ENHANCED_SYSREQ
JOB_TYPE_ENHANCED_INTERACTIVE_SYSREQ_AND_GROUP
JOB_TYPE_ENHANCED_PRESTART
JOB_TYPE_ENHANCED_PRESTART_BATCH
JOB_TYPE_ENHANCED_PRESTART_COMM
JOB_TYPE_ENHANCED_READER
JOB_TYPE_ENHANCED_SUBSYSTEM
JOB_TYPE_ENHANCED_SYSTEM
JOB_TYPE_ENHANCED_WRITER
Read-only: true
Type: Integer
Only valid on V5R1 systems and higher.
- See Also:
- Constant Field Values
-
JOB_TYPE_ENHANCED_AUTOSTART
public static final java.lang.Integer JOB_TYPE_ENHANCED_AUTOSTART
Constant indicating that the job is an autostart job.- See Also:
JOB_TYPE_ENHANCED
-
JOB_TYPE_ENHANCED_BATCH
public static final java.lang.Integer JOB_TYPE_ENHANCED_BATCH
Constant indicating that the job is a batch job.- See Also:
JOB_TYPE_ENHANCED
-
JOB_TYPE_ENHANCED_BATCH_IMMEDIATE
public static final java.lang.Integer JOB_TYPE_ENHANCED_BATCH_IMMEDIATE
Constant indicating that the job is a batch immediate job.- See Also:
JOB_TYPE_ENHANCED
-
JOB_TYPE_ENHANCED_BATCH_MRT
public static final java.lang.Integer JOB_TYPE_ENHANCED_BATCH_MRT
Constant indicating that the job is a batch System/36 multiple requester terminal (MRT) job.- See Also:
JOB_TYPE_ENHANCED
-
JOB_TYPE_ENHANCED_BATCH_ALTERNATE_SPOOL_USER
public static final java.lang.Integer JOB_TYPE_ENHANCED_BATCH_ALTERNATE_SPOOL_USER
Constant indicating that the job is a batch alternate spool user job.- See Also:
JOB_TYPE_ENHANCED
-
JOB_TYPE_ENHANCED_COMM_PROCEDURE_START_REQUEST
public static final java.lang.Integer JOB_TYPE_ENHANCED_COMM_PROCEDURE_START_REQUEST
Constant indicating that the job is a communications procedure start request job.- See Also:
JOB_TYPE_ENHANCED
-
JOB_TYPE_ENHANCED_INTERACTIVE
public static final java.lang.Integer JOB_TYPE_ENHANCED_INTERACTIVE
Constant indicating that the job is an interactive job.- See Also:
JOB_TYPE_ENHANCED
-
JOB_TYPE_ENHANCED_INTERACTIVE_GROUP
public static final java.lang.Integer JOB_TYPE_ENHANCED_INTERACTIVE_GROUP
Constant indicating that the job is an interactive job that is part of a group.- See Also:
JOB_TYPE_ENHANCED
-
JOB_TYPE_ENHANCED_INTERACTIVE_SYSREQ
public static final java.lang.Integer JOB_TYPE_ENHANCED_INTERACTIVE_SYSREQ
Constant indicating that the job is an interactive job that is part of a system request pair.- See Also:
JOB_TYPE_ENHANCED
-
JOB_TYPE_ENHANCED_INTERACTIVE_SYSREQ_AND_GROUP
public static final java.lang.Integer JOB_TYPE_ENHANCED_INTERACTIVE_SYSREQ_AND_GROUP
Constant indicating that the job is an interactive job that is part of a system request pair and part of a group.- See Also:
JOB_TYPE_ENHANCED
-
JOB_TYPE_ENHANCED_PRESTART
public static final java.lang.Integer JOB_TYPE_ENHANCED_PRESTART
Constant indicating that the job is a prestart job.- See Also:
JOB_TYPE_ENHANCED
-
JOB_TYPE_ENHANCED_PRESTART_BATCH
public static final java.lang.Integer JOB_TYPE_ENHANCED_PRESTART_BATCH
Constant indicating that the job is a prestart batch job.- See Also:
JOB_TYPE_ENHANCED
-
JOB_TYPE_ENHANCED_PRESTART_COMM
public static final java.lang.Integer JOB_TYPE_ENHANCED_PRESTART_COMM
Constant indicating that the job is a prestart communications job.- See Also:
JOB_TYPE_ENHANCED
-
JOB_TYPE_ENHANCED_READER
public static final java.lang.Integer JOB_TYPE_ENHANCED_READER
Constant indicating that the job is a reader job.- See Also:
JOB_TYPE_ENHANCED
-
JOB_TYPE_ENHANCED_SUBSYSTEM
public static final java.lang.Integer JOB_TYPE_ENHANCED_SUBSYSTEM
Constant indicating that the job is a subsystem job.- See Also:
JOB_TYPE_ENHANCED
-
JOB_TYPE_ENHANCED_SYSTEM
public static final java.lang.Integer JOB_TYPE_ENHANCED_SYSTEM
Constant indicating that the job is a system job (all system jobs including SCPF).- See Also:
JOB_TYPE_ENHANCED
-
JOB_TYPE_ENHANCED_WRITER
public static final java.lang.Integer JOB_TYPE_ENHANCED_WRITER
Constant indicating that the job is a writer job (including both spool writers and print drivers).- See Also:
JOB_TYPE_ENHANCED
-
JOB_USER_IDENTITY
public static final int JOB_USER_IDENTITY
Job attribute representing the user profile name by which the job is known to other jobs on the system. The job user identity is used for authorization checks when other jobs on the system attempt to operate against the job. For more detail on how the job user identity is set and used, refer to the Set Job User Identity (QWTSJUID) API. For jobs that are on a job queue or have completed running, the job user identity is same as the user name from the qualified job name. This attribute will return blanks for these jobs. A value of *N is returned if the job user identity is set, but the user profile to which it is set no longer exists.Read-only: true
Type: String
- See Also:
- Constant Field Values
-
JOB_USER_IDENTITY_SETTING
public static final int JOB_USER_IDENTITY_SETTING
Job attribute representing the method by which the job user identity was set. Possible values are:JOB_USER_IDENTITY_SETTING_DEFAULT
JOB_USER_IDENTITY_SETTING_APPLICATION
JOB_USER_IDENTITY_SETTING_SYSTEM
Read-only: true
Type: String
- See Also:
- Constant Field Values
-
JOB_USER_IDENTITY_SETTING_DEFAULT
public static final java.lang.String JOB_USER_IDENTITY_SETTING_DEFAULT
Constant indicating that the job is currently running single threaded and the job user identity is the name of the user profile under which the job is currently running. This value is also returned for jobs that are on a job queue or have completed running. This has the same meaning as a value of *DEFAULT on the Display Job Status Attributes display.
-
JOB_USER_IDENTITY_SETTING_APPLICATION
public static final java.lang.String JOB_USER_IDENTITY_SETTING_APPLICATION
Constant indicating that the job user identity was explicitly set by an application using one of the Set Job User Identity APIs, QWTSJUID or QwtSetJuid(). The job may be running either single threaded or multithreaded. This has the same meaning as a value of *APPLICATION on the Display Job Status Attributes display.
-
JOB_USER_IDENTITY_SETTING_SYSTEM
public static final java.lang.String JOB_USER_IDENTITY_SETTING_SYSTEM
Constant indicating that the job is currently running multithreaded and the job user identity was implicitly set by the system when the job became multithreaded. It was set to the name of the user profile that the job was running under when it became multithreaded. This has the same meaning as a value of *SYSTEM on the Display Job Status Attributes display.
-
KEEP_DDM_CONNECTIONS_ACTIVE
public static final int KEEP_DDM_CONNECTIONS_ACTIVE
Job attribute representing whether connections using distributed data management (DDM) protocols remain active when they are not being used. The connections include APPC conversations, active TCP/IP connections, or Opti-Connect connections. The DDM protocols are used in Distributed Relational Database Architecture (DRDA) applications, DDM applications, or DB2 Multisystem applications. Possible values are:Type: String
-
KEEP_DDM_CONNECTIONS_ACTIVE_KEEP
public static final java.lang.String KEEP_DDM_CONNECTIONS_ACTIVE_KEEP
Constant indicating that the system keeps DDM connections active when there are no users, except for the following:- The routing step ends on the source system. The routing step ends when the job ends or when the job is rerouted to another routing step.
- The Reclaim Distributed Data Management Conversation (RCLDDMCNV) command or the Reclaim Resources (RCLRSC) command runs.
- A communications failure or an internal failure occurs.
- A DRDA connection to an application server not running on an IBM i system ends.
-
KEEP_DDM_CONNECTIONS_ACTIVE_DROP
public static final java.lang.String KEEP_DDM_CONNECTIONS_ACTIVE_DROP
Constant indicating that the system ends a DDM connection when there are no users. Examples include when an application closes a DDM file, or when a DRDA application runs an SQL DISCONNECT statement.
-
LANGUAGE_ID
public static final int LANGUAGE_ID
Job attribute representing the language identifier associated with this job. The language identifier is used when *LANGIDUNQ or *LANGIDSHR is specified on the sort sequence parameter. If the job CCSID is 65535, this parameter is also used to determine the value of the job default CCSID. Possible values are:LANGUAGE_ID_SYSTEM_VALUE
LANGUAGE_ID_INITIAL_USER
- The language identifier.
Type: String
-
LANGUAGE_ID_SYSTEM_VALUE
public static final java.lang.String LANGUAGE_ID_SYSTEM_VALUE
Constant indicating the system value QLANGID is used.- See Also:
LANGUAGE_ID
, Constant Field Values
-
LANGUAGE_ID_INITIAL_USER
public static final java.lang.String LANGUAGE_ID_INITIAL_USER
Constant indicating the language ID specified in the user profile under which this thread was initially running is used.- See Also:
LANGUAGE_ID
, Constant Field Values
-
LOG_CL_PROGRAMS
public static final int LOG_CL_PROGRAMS
Job attribute representing whether or not commands are logged for CL programs that are run. Possible values are:Type: String
-
LOG_CL_PROGRAMS_YES
public static final java.lang.String LOG_CL_PROGRAMS_YES
Constant indicating that commands are logged for CL programs that are run.- See Also:
LOG_CL_PROGRAMS
, Constant Field Values
-
LOG_CL_PROGRAMS_NO
public static final java.lang.String LOG_CL_PROGRAMS_NO
Constant indicating that commands are not logged for CL programs that are run.- See Also:
LOG_CL_PROGRAMS
, Constant Field Values
-
LOGGING_LEVEL
public static final int LOGGING_LEVEL
Job attribute representing what type of information is logged. Possible values are:LOGGING_LEVEL_NONE
LOGGING_LEVEL_MESSAGES_BY_SEVERITY
LOGGING_LEVEL_REQUESTS_BY_SEVERITY_AND_ASSOCIATED_MESSAGES
LOGGING_LEVEL_ALL_REQUESTS_AND_ASSOCIATED_MESSAGES
LOGGING_LEVEL_ALL_REQUESTS_AND_MESSAGES
Type: String
-
LOGGING_LEVEL_NONE
public static final java.lang.String LOGGING_LEVEL_NONE
Constant indicating that no messages are logged.- See Also:
LOGGING_LEVEL
, Constant Field Values
-
LOGGING_LEVEL_MESSAGES_BY_SEVERITY
public static final java.lang.String LOGGING_LEVEL_MESSAGES_BY_SEVERITY
Constant indicating that all messages sent to the job's external message queue with a severity greater than or equal to the message logging severity are logged. This includes the indication of job start, job end, and job completion status.- See Also:
LOGGING_LEVEL
, Constant Field Values
-
LOGGING_LEVEL_REQUESTS_BY_SEVERITY_AND_ASSOCIATED_MESSAGES
public static final java.lang.String LOGGING_LEVEL_REQUESTS_BY_SEVERITY_AND_ASSOCIATED_MESSAGES
Constant indicating that the following information is logged:- Logging level 1 information.
- Request messages that result in a high-level message with a severity code greater than or equal to the logging severity cause the request message and all associated messages to be logged. A high-level message is one that is sent to the program message queue of the program that receives the request message. For example, QCMD is an IBM-supplied request processing program that receives request messages.
- See Also:
LOGGING_LEVEL
, Constant Field Values
-
LOGGING_LEVEL_ALL_REQUESTS_AND_ASSOCIATED_MESSAGES
public static final java.lang.String LOGGING_LEVEL_ALL_REQUESTS_AND_ASSOCIATED_MESSAGES
Constant indicating that the following information is logged:- Logging level 1 and 2 information is logged.
- All request messages are logged.
- Commands run by a CL program are logged if it is allowed by the LOG_CL_PROGRAMS attribute and the log attribute of the CL program.
- See Also:
LOGGING_LEVEL
, Constant Field Values
-
LOGGING_LEVEL_ALL_REQUESTS_AND_MESSAGES
public static final java.lang.String LOGGING_LEVEL_ALL_REQUESTS_AND_MESSAGES
Constant indicating that the following information is logged:- All request messages and all messages with a severity greater than or equal to the message logging severity, including trace messages.
- Commands run by a CL program are logged if it is allowed by the LOG_CL_PROGRAMS attribute and the log attribute of the CL program.
- See Also:
LOGGING_LEVEL
, Constant Field Values
-
LOGGING_SEVERITY
public static final int LOGGING_SEVERITY
Job attribute representing the severity level that is used in conjunction with the logging level to determine which error messages are logged in the job log. The values range from 00 through 99.Type: Integer
-
LOGGING_TEXT
public static final int LOGGING_TEXT
Job attribute representing the level of message text that is written in the job log when a message is logged according to the LOGGING_LEVEL and LOGGING_SEVERITY. Possible values are:Type: String
-
LOGGING_TEXT_MESSAGE
public static final java.lang.String LOGGING_TEXT_MESSAGE
Constant indicating that only the message text is written to the job log.- See Also:
LOGGING_TEXT
, Constant Field Values
-
LOGGING_TEXT_SECLVL
public static final java.lang.String LOGGING_TEXT_SECLVL
Constant indicating that both the message text and the message help (cause and recovery) of the error message are written to the job log.- See Also:
LOGGING_TEXT
, Constant Field Values
-
LOGGING_TEXT_NO_LIST
public static final java.lang.String LOGGING_TEXT_NO_LIST
Constant indicating that if the job ends normally, no job log is produced. If the job ends abnormally (the job end code is 20 or higher), a job log is produced. The messages that appear in the job log contain both the message text and the message. help.- See Also:
LOGGING_TEXT
, Constant Field Values
-
MAX_CPU_TIME
public static final int MAX_CPU_TIME
Job attribute representing the maximum processing unit time (in milliseconds) that the job can use. If the job consists of multiple routing steps, this is the maximum processing unit time that the current routing step can use. If the maximum time is exceeded, the job is ended. A value of -1 is returned if there is no maximum (*NOMAX). A value of zero is returned if the job is not active.Read-only: true
Type: Integer
- See Also:
- Constant Field Values
-
MAX_TEMP_STORAGE
public static final int MAX_TEMP_STORAGE
Job attribute representing the maximum amount of auxiliary storage (in kilobytes) that the job can use. If the job consists of multiple routing steps, this is the maximum temporary storage that the routing step can use. This temporary storage is used for storage required by the program itself and by implicitly created internal system objects used to support the routing step. (It does not include storage in the QTEMP library.) If the maximum temporary storage is exceeded, the job is ended. This does not apply to the use of permanent storage, which is controlled through the user profile. A value of -1 is returned if there is no maximum (*NOMAX).Read-only: true
Type: Integer
- See Also:
- Constant Field Values
-
MAX_TEMP_STORAGE_LARGE
public static final int MAX_TEMP_STORAGE_LARGE
Job attribute representing the maximum amount of auxiliary storage (in megabytes) that the job can use. If the job consists of multiple routing steps, this is the maximum temporary storage that the routing step can use. This temporary storage is used for storage required by the program itself and by implicitly created internal system objects used to support the routing step. (It does not include storage in the QTEMP library.) If the maximum temporary storage is exceeded, the job is ended. This does not apply to the use of permanent storage, which is controlled through the user profile. A value of -1 is returned if there is no maximum (*NOMAX).Read-only: true
Type: Long
- See Also:
- Constant Field Values
-
MAX_THREADS
public static final int MAX_THREADS
Job attribute representing the maximum number of threads that a job can run with at any time. If multiple threads are initiated simultaneously, this value may be exceeded. If this maximum value is exceeded, the excess threads will be allowed to run to their normal completion. Initiation of additional threads will be inhibited until the maximum number of threads in the job drops below this maximum value. A value of -1 is returned if there is no maximum (*NOMAX). Depending upon the resources used by the threads and the resources available to the system, the initiation of additional threads may be inhibited before this maximum value is reached.Read-only: true
Type: Integer
- See Also:
- Constant Field Values
-
MEMORY_POOL
public static final int MEMORY_POOL
Job attribute representing the name of the memory pool in which the job started running. The name may be a number, in which case it is a private pool associated with a subsystem. Possible values are:MEMORY_POOL_MACHINE
MEMORY_POOL_BASE
MEMORY_POOL_INTERACTIVE
MEMORY_POOL_SPOOL
- *SHRPOOL1 - *SHRPOOL60: This job is running in the identified shared pool.
- 01 - 99: This job is running in the identified private pool.
Read-only: true
Type: String
Only valid on V5R1 systems and higher.
- See Also:
- Constant Field Values
-
MEMORY_POOL_MACHINE
public static final java.lang.String MEMORY_POOL_MACHINE
Constant indicating that this job is running in the machine pool.- See Also:
MEMORY_POOL
, Constant Field Values
-
MEMORY_POOL_BASE
public static final java.lang.String MEMORY_POOL_BASE
Constant indicating that this job is running in the base system pool, which can be shared with other subsystems.- See Also:
MEMORY_POOL
, Constant Field Values
-
MEMORY_POOL_INTERACTIVE
public static final java.lang.String MEMORY_POOL_INTERACTIVE
Constant indicating that this job is running in the shared pool used for interactive work.- See Also:
MEMORY_POOL
, Constant Field Values
-
MEMORY_POOL_SPOOL
public static final java.lang.String MEMORY_POOL_SPOOL
Constant indicating that this job is running in the shared pool for spooled writers.- See Also:
MEMORY_POOL
, Constant Field Values
-
MESSAGE_REPLY
public static final int MESSAGE_REPLY
Job attribute representing whether the job is waiting for a reply to a specific message. This value applies only when either the ACTIVE_JOB_STATUS or ACTIVE_JOB_STATUS_FOR_JOBS_ENDING attributes are set to ACTIVE_JOB_STATUS_WAIT_MESSAGE. Possible values are:Read-only: true
Type: String
Only valid on V5R1 systems and higher.
- See Also:
- Constant Field Values
-
MESSAGE_REPLY_NOT_IN_MESSAGE_WAIT
public static final java.lang.String MESSAGE_REPLY_NOT_IN_MESSAGE_WAIT
Constant indicating that the job currently is not in message wait status.- See Also:
MESSAGE_REPLY
, Constant Field Values
-
MESSAGE_REPLY_WAITING
public static final java.lang.String MESSAGE_REPLY_WAITING
Constant indicating that the job is waiting for a reply to a message.- See Also:
MESSAGE_REPLY
, Constant Field Values
-
MESSAGE_REPLY_NOT_WAITING
public static final java.lang.String MESSAGE_REPLY_NOT_WAITING
Constant indicating that the job is not waiting for a reply to a message.- See Also:
MESSAGE_REPLY
, Constant Field Values
-
MESSAGE_QUEUE_ACTION
public static final int MESSAGE_QUEUE_ACTION
Job attribute representing the action to take when the message queue is full. Possible values are:MESSAGE_QUEUE_ACTION_SYSTEM_VALUE
MESSAGE_QUEUE_ACTION_NO_WRAP
MESSAGE_QUEUE_ACTION_WRAP
MESSAGE_QUEUE_ACTION_PRINT_WRAP
Type: String
-
MESSAGE_QUEUE_ACTION_SYSTEM_VALUE
public static final java.lang.String MESSAGE_QUEUE_ACTION_SYSTEM_VALUE
Constant indicating the value specified for the QJOBMSGQFL system value is used.- See Also:
MESSAGE_QUEUE_ACTION
, Constant Field Values
-
MESSAGE_QUEUE_ACTION_NO_WRAP
public static final java.lang.String MESSAGE_QUEUE_ACTION_NO_WRAP
Constant indicating that when the job message queue is full, do not wrap. This action causes the job to end.- See Also:
MESSAGE_QUEUE_ACTION
, Constant Field Values
-
MESSAGE_QUEUE_ACTION_WRAP
public static final java.lang.String MESSAGE_QUEUE_ACTION_WRAP
Constant indicating that when the job message queue is full, wrap to the beginning and start filling again.- See Also:
MESSAGE_QUEUE_ACTION
, Constant Field Values
-
MESSAGE_QUEUE_ACTION_PRINT_WRAP
public static final java.lang.String MESSAGE_QUEUE_ACTION_PRINT_WRAP
Constant indicating that when the job message queue is full, wrap the message queue and print the messages that are being overlaid because of the wrapping.- See Also:
MESSAGE_QUEUE_ACTION
, Constant Field Values
-
MESSAGE_QUEUE_MAX_SIZE
public static final int MESSAGE_QUEUE_MAX_SIZE
Job attribute representing the maximum size (in megabytes) that the job message queue can become. The range is 2 to 64.Read-only: true
Type: Integer
-
MODE
public static final int MODE
Job attribute representing the mode name of the advanced program-to-program communications (APPC) device that started the job. Possible values are:- The mode name is *BLANK.
- The mode name is blanks.
- The name of the mode.
Read-only: true
Type: String
- See Also:
- Constant Field Values
-
OUTPUT_QUEUE
public static final int OUTPUT_QUEUE
Job attribute representing the name of the default output queue that is used for spooled output produced by this job. The default output queue is only for spooled printer files that specify *JOB for the output queue. Possible values are:OUTPUT_QUEUE_DEVICE
OUTPUT_QUEUE_WORK_STATION
OUTPUT_QUEUE_INITIAL_USER
- Output queue name.
Type: String
-
OUTPUT_QUEUE_DEVICE
public static final java.lang.String OUTPUT_QUEUE_DEVICE
Constant indicating the device specified on the Create Printer File (CRTPRTF), Change Printer File (CHGPRTF), or Override with Printer File (OVRPRTF) commands is used.- See Also:
OUTPUT_QUEUE
, Constant Field Values
-
OUTPUT_QUEUE_WORK_STATION
public static final java.lang.String OUTPUT_QUEUE_WORK_STATION
Constant indicating the default output queue that is used with this job is the output queue that is assigned to the work station associated with the job at the time the job is started.- See Also:
OUTPUT_QUEUE
, Constant Field Values
-
OUTPUT_QUEUE_INITIAL_USER
public static final java.lang.String OUTPUT_QUEUE_INITIAL_USER
Constant indicating the output queue name specified in the user profile under which this thread was initially running is used.- See Also:
OUTPUT_QUEUE
, Constant Field Values
-
OUTPUT_QUEUE_PRIORITY
public static final int OUTPUT_QUEUE_PRIORITY
Job attribute representing the output priority for spooled output files that this job produces. The highest priority is 0, and the lowest is 9.Type: String
-
PRINT_KEY_FORMAT
public static final int PRINT_KEY_FORMAT
Job attribute representing whether border and header information is provided when the Print key is pressed. Possible values are:PRINT_KEY_FORMAT_SYSTEM_VALUE
PRINT_KEY_FORMAT_NONE
PRINT_KEY_FORMAT_BORDER
PRINT_KEY_FORMAT_HEADER
PRINT_KEY_FORMAT_ALL
Type: String
-
PRINT_KEY_FORMAT_SYSTEM_VALUE
public static final java.lang.String PRINT_KEY_FORMAT_SYSTEM_VALUE
Constant indicating that the value specified on the system value QPRTKEYFMT determines whether header or border information is printed.- See Also:
PRINT_KEY_FORMAT
, Constant Field Values
-
PRINT_KEY_FORMAT_NONE
public static final java.lang.String PRINT_KEY_FORMAT_NONE
Constant indicating that the border and header information is not included with output from the Print key.- See Also:
PRINT_KEY_FORMAT
, Constant Field Values
-
PRINT_KEY_FORMAT_BORDER
public static final java.lang.String PRINT_KEY_FORMAT_BORDER
Constant indicating that the border information is included with output from the Print key.- See Also:
PRINT_KEY_FORMAT
, Constant Field Values
-
PRINT_KEY_FORMAT_HEADER
public static final java.lang.String PRINT_KEY_FORMAT_HEADER
Constant indicating that the header information is included with output from the Print key.- See Also:
PRINT_KEY_FORMAT
, Constant Field Values
-
PRINT_KEY_FORMAT_ALL
public static final java.lang.String PRINT_KEY_FORMAT_ALL
Constant indicating that the border and header information is included with output from the Print key.- See Also:
PRINT_KEY_FORMAT
, Constant Field Values
-
PRINT_TEXT
public static final int PRINT_TEXT
Job attribute representing the line of text (if any) that is printed at the bottom of each page of printed output for the job. Possible values are:PRINT_TEXT_SYSTEM_VALUE
PRINT_TEXT_BLANK
- The character string that is printed at the bottom of each page. A maximum of 30 characters can be entered.
Type: String
-
PRINT_TEXT_SYSTEM_VALUE
public static final java.lang.String PRINT_TEXT_SYSTEM_VALUE
Constant indicating the system value QPRTTXT is used.- See Also:
PRINT_TEXT
, Constant Field Values
-
PRINT_TEXT_BLANK
public static final java.lang.String PRINT_TEXT_BLANK
Constant indicating that no text is printed on printed output.- See Also:
PRINT_TEXT
, Constant Field Values
-
PRINTER_DEVICE_NAME
public static final int PRINTER_DEVICE_NAME
Job attribute representing the printer device used for printing output from this job. Possible values are:PRINTER_DEVICE_NAME_SYSTEM_VALUE
PRINTER_DEVICE_NAME_WORK_STATION
PRINTER_DEVICE_NAME_INITIAL_USER
- The name of the printer device that is used with this job.
Type: String
-
PRINTER_DEVICE_NAME_SYSTEM_VALUE
public static final java.lang.String PRINTER_DEVICE_NAME_SYSTEM_VALUE
Constant indicating the value in the system value QPRTDEV is used as the printer device.- See Also:
PRINTER_DEVICE_NAME
, Constant Field Values
-
PRINTER_DEVICE_NAME_WORK_STATION
public static final java.lang.String PRINTER_DEVICE_NAME_WORK_STATION
Constant indicating that the default printer device used with this job is the printer device assigned to the work station that is associated with the job.- See Also:
PRINTER_DEVICE_NAME
, Constant Field Values
-
PRINTER_DEVICE_NAME_INITIAL_USER
public static final java.lang.String PRINTER_DEVICE_NAME_INITIAL_USER
Constant indicating that the printer device name specified in the user profile under which this thread was initially running is used.- See Also:
PRINTER_DEVICE_NAME
, Constant Field Values
-
PRODUCT_LIBRARIES
public static final int PRODUCT_LIBRARIES
Job attribute representing the libraries that contain product information for the initial thread of the job.Read-only: true
Type: String
Can be loaded by JobList: false
-
PRODUCT_RETURN_CODE
public static final int PRODUCT_RETURN_CODE
Job attribute representing the return code set by the compiler for Integrated Language Environment (ILE) languages. Refer to the appropriate ILE-conforming language manual for possible values. This attribute is scoped to the job and represents the most recent return code set by any thread within the job.Read-only: true
Type: Integer
- See Also:
- Constant Field Values
-
PROGRAM_RETURN_CODE
public static final int PROGRAM_RETURN_CODE
Job attribute representing the completion status of the last program that has finished running, if the job contains any RPG, COBOL, data file utility (DFU), or sort utility programs. If not, a value of 0 is returned.Read-only: true
Type: Integer
- See Also:
- Constant Field Values
-
ROUTING_DATA
public static final int ROUTING_DATA
Job attribute representing the routing data that is used to determine the routing entry that identifies the program to start for the routing step.Read-only: true
Type: String
- See Also:
getRoutingData()
, Constant Field Values
-
RUN_PRIORITY
public static final int RUN_PRIORITY
Job attribute representing the priority at which the job is currently running, relative to other jobs on the system. The run priority ranges from 0 (highest priority) to 99 (lowest priority).Type: Integer
-
SCHEDULE_DATE
public static final int SCHEDULE_DATE
Job attribute representing the date on which the submitted job becomes eligible to run. If your system or your job is configured to use the Julian date format, *MONTHSTR and *MONTHEND are calculated as if the system or job did not use the Julian date format. Possible values that can be used onsetValue()
are:SCHEDULE_DATE_CURRENT
SCHEDULE_DATE_MONTH_START
SCHEDULE_DATE_MONTH_END
SCHEDULE_DATE_MONDAY
SCHEDULE_DATE_TUESDAY
SCHEDULE_DATE_WEDNESDAY
SCHEDULE_DATE_THURSDAY
SCHEDULE_DATE_FRIDAY
SCHEDULE_DATE_SATURDAY
SCHEDULE_DATE_SUNDAY
- A date String in the format CYYMMDD.
Type: String on setValue(); java.util.Date on getValue().
-
SCHEDULE_DATE_CURRENT
public static final java.lang.String SCHEDULE_DATE_CURRENT
Constant indicating the submitted job becomes eligible to run on the current date.- See Also:
SCHEDULE_DATE
, Constant Field Values
-
SCHEDULE_DATE_MONTH_START
public static final java.lang.String SCHEDULE_DATE_MONTH_START
Constant indicating the submitted job becomes eligible to run on the first day of the month. If you specify this value and if today is the first day of the month and the time you specify on the SCHEDULE_TIME attribute has not passed, the job becomes eligible to run today. Otherwise, the job becomes eligible on the first day of the next month.- See Also:
SCHEDULE_DATE
, Constant Field Values
-
SCHEDULE_DATE_MONTH_END
public static final java.lang.String SCHEDULE_DATE_MONTH_END
Constant indicating the submitted job becomes eligible to run on the last day of the month. If you specify this value and if today is the last day of the month and the time you specify on the SCHEDULE_TIME attribute has not passed, the job becomes eligible to run today. Otherwise, the job becomes eligible on the last day of the next month.- See Also:
SCHEDULE_DATE
, Constant Field Values
-
SCHEDULE_DATE_MONDAY
public static final java.lang.String SCHEDULE_DATE_MONDAY
Constant indicating the job becomes eligible to run on Monday.- See Also:
SCHEDULE_DATE
, Constant Field Values
-
SCHEDULE_DATE_TUESDAY
public static final java.lang.String SCHEDULE_DATE_TUESDAY
Constant indicating the job becomes eligible to run on Tuesday.- See Also:
SCHEDULE_DATE
, Constant Field Values
-
SCHEDULE_DATE_WEDNESDAY
public static final java.lang.String SCHEDULE_DATE_WEDNESDAY
Constant indicating the job becomes eligible to run on Wednesday.- See Also:
SCHEDULE_DATE
, Constant Field Values
-
SCHEDULE_DATE_THURSDAY
public static final java.lang.String SCHEDULE_DATE_THURSDAY
Constant indicating the job becomes eligible to run on Thursday.- See Also:
SCHEDULE_DATE
, Constant Field Values
-
SCHEDULE_DATE_FRIDAY
public static final java.lang.String SCHEDULE_DATE_FRIDAY
Constant indicating the job becomes eligible to run on Friday.- See Also:
SCHEDULE_DATE
, Constant Field Values
-
SCHEDULE_DATE_SATURDAY
public static final java.lang.String SCHEDULE_DATE_SATURDAY
Constant indicating the job becomes eligible to run on Saturday.- See Also:
SCHEDULE_DATE
, Constant Field Values
-
SCHEDULE_DATE_SUNDAY
public static final java.lang.String SCHEDULE_DATE_SUNDAY
Constant indicating the job becomes eligible to run on Sunday.- See Also:
SCHEDULE_DATE
, Constant Field Values
-
SCHEDULE_TIME
public static final int SCHEDULE_TIME
Job attribute representing the time on the scheduled date at which the job becomes eligible to run. Although the time can be specified to the second, the load on the system may affect the exact time at which the job becomes eligible to run. Possible values that can be used onsetValue()
are:SCHEDULE_TIME_CURRENT
- A time you want to start the job, specified in a 24-hour format String as HHMMSS.
Type: String on setValue(); java.util.Date on getValue().
-
SCHEDULE_TIME_CURRENT
public static final java.lang.String SCHEDULE_TIME_CURRENT
Constant indicating the job is submitted on the current time.- See Also:
SCHEDULE_TIME
, Constant Field Values
-
SERVER_TYPE
public static final int SERVER_TYPE
Job attribute representing the type of server represented by the job. A value of blanks indicates that the job is not part of a server.Read-only: true
Type: String
- See Also:
- Constant Field Values
-
SIGNED_ON_JOB
public static final int SIGNED_ON_JOB
Job attribute representing whether the job is to be treated like a signed-on user on the system. Possible values are:Read-only: true
Type: String
- See Also:
getSignedOnJob()
, Constant Field Values
-
SIGNED_ON_JOB_TRUE
public static final java.lang.String SIGNED_ON_JOB_TRUE
Constant indicating that the job should be treated like a signed-on user.- See Also:
SIGNED_ON_JOB
, Constant Field Values
-
SIGNED_ON_JOB_FALSE
public static final java.lang.String SIGNED_ON_JOB_FALSE
Constant indicating that the job should not be treated like a signed-on user.- See Also:
SIGNED_ON_JOB
, Constant Field Values
-
SORT_SEQUENCE_TABLE
public static final int SORT_SEQUENCE_TABLE
Job attribute representing the sort sequence table associated with this job. Possible values are:SORT_SEQUENCE_TABLE_SYSTEM_VALUE
SORT_SEQUENCE_TABLE_INITIAL_USER
SORT_SEQUENCE_TABLE_NONE
SORT_SEQUENCE_TABLE_LANGUAGE_SHARED_WEIGHT
SORT_SEQUENCE_TABLE_LANGUAGE_UNIQUE_WEIGHT
- A sort sequence table and library.
Type: String
-
SORT_SEQUENCE_TABLE_SYSTEM_VALUE
public static final java.lang.String SORT_SEQUENCE_TABLE_SYSTEM_VALUE
Constant indicating the system value QSRTSEQ is used.- See Also:
SORT_SEQUENCE_TABLE
, Constant Field Values
-
SORT_SEQUENCE_TABLE_INITIAL_USER
public static final java.lang.String SORT_SEQUENCE_TABLE_INITIAL_USER
Constant indicating the sort sequence table specified in the user profile under which this thread was initially running is used.- See Also:
SORT_SEQUENCE_TABLE
, Constant Field Values
-
SORT_SEQUENCE_TABLE_NONE
public static final java.lang.String SORT_SEQUENCE_TABLE_NONE
Constant indicating that no sort sequence table is used. The hexadecimal values of the characters are used to determine the sort sequence.- See Also:
SORT_SEQUENCE_TABLE
, Constant Field Values
-
SORT_SEQUENCE_TABLE_LANGUAGE_SHARED_WEIGHT
public static final java.lang.String SORT_SEQUENCE_TABLE_LANGUAGE_SHARED_WEIGHT
Constant indicating that the sort sequence table used can contain the same weight for multiple characters, and it is the shared weight sort table associated with the language specified in the LANGUAGE_ID attribute.- See Also:
SORT_SEQUENCE_TABLE
, Constant Field Values
-
SORT_SEQUENCE_TABLE_LANGUAGE_UNIQUE_WEIGHT
public static final java.lang.String SORT_SEQUENCE_TABLE_LANGUAGE_UNIQUE_WEIGHT
Constant indicating that the sort sequence table used must contain a unique weight for each character in the code page, and it is the unique weight sort table associated with the language specified in the LANGUAGE_ID parameter.- See Also:
SORT_SEQUENCE_TABLE
, Constant Field Values
-
SPECIAL_ENVIRONMENT
public static final int SPECIAL_ENVIRONMENT
Job attribute representing whether a job is running in a particular environment. Possible values are:Read-only: true
Type: String
- See Also:
- Constant Field Values
-
SPECIAL_ENVIRONMENT_NONE
public static final java.lang.String SPECIAL_ENVIRONMENT_NONE
Constant indicating that the job is not running in any special environment.- See Also:
SPECIAL_ENVIRONMENT
, Constant Field Values
-
SPECIAL_ENVIRONMENT_SYSTEM_36
public static final java.lang.String SPECIAL_ENVIRONMENT_SYSTEM_36
Constant indicating that the job is running in the System/36 environment.- See Also:
SPECIAL_ENVIRONMENT
, Constant Field Values
-
SPECIAL_ENVIRONMENT_NOT_ACTIVE
public static final java.lang.String SPECIAL_ENVIRONMENT_NOT_ACTIVE
Constant indicating that the special environment is ignored because the job is not currently active.- See Also:
SPECIAL_ENVIRONMENT
, Constant Field Values
-
SPOOLED_FILE_ACTION
public static final int SPOOLED_FILE_ACTION
Job attribute representing whether spooled files can be accessed through job interfaces once a job has completed its normal activity. Possible values are:Type: String
- See Also:
- Constant Field Values
-
SPOOLED_FILE_ACTION_KEEP
public static final java.lang.String SPOOLED_FILE_ACTION_KEEP
Constant indicating that when the job completes its activity, as long as at least one spooled file for the job exists in the system auxiliary storage pool (ASP 1) or in a basic user ASP (ASPs 2-32), the spooled files are kept with the job and the status of the job is updated to indicate that the job has completed. If all remaining spooled files for the job are in independent ASPs (ASPs 33-255), the spooled files will be detached from the job and the job will be removed from the system.- See Also:
SPOOLED_FILE_ACTION
, Constant Field Values
-
SPOOLED_FILE_ACTION_DETACH
public static final java.lang.String SPOOLED_FILE_ACTION_DETACH
Constant indicating that spooled files are detached from the job when the job completes its activity.- See Also:
SPOOLED_FILE_ACTION
, Constant Field Values
-
SPOOLED_FILE_ACTION_SYSTEM_VALUE
public static final java.lang.String SPOOLED_FILE_ACTION_SYSTEM_VALUE
Constant indicating the job will take the spooled file action specified by the QSPLFACN system value.- See Also:
SPOOLED_FILE_ACTION
, Constant Field Values
-
STATUS_MESSAGE_HANDLING
public static final int STATUS_MESSAGE_HANDLING
Job attribute representing whether status messages are displayed for this job. Possible values are:STATUS_MESSAGE_HANDLING_SYSTEM_VALUE
STATUS_MESSAGE_HANDLING_INITIAL_USER
STATUS_MESSAGE_HANDLING_NONE
STATUS_MESSAGE_HANDLING_NORMAL
Type: String
-
STATUS_MESSAGE_HANDLING_SYSTEM_VALUE
public static final java.lang.String STATUS_MESSAGE_HANDLING_SYSTEM_VALUE
Constant indicating the system value QSTSMSG is used.- See Also:
STATUS_MESSAGE_HANDLING
, Constant Field Values
-
STATUS_MESSAGE_HANDLING_INITIAL_USER
public static final java.lang.String STATUS_MESSAGE_HANDLING_INITIAL_USER
Constant indicating the status message handling that is specified in the user profile under which this thread was initially running is used.- See Also:
STATUS_MESSAGE_HANDLING
, Constant Field Values
-
STATUS_MESSAGE_HANDLING_NONE
public static final java.lang.String STATUS_MESSAGE_HANDLING_NONE
Constant indicating that this job does not display status messages.- See Also:
STATUS_MESSAGE_HANDLING
, Constant Field Values
-
STATUS_MESSAGE_HANDLING_NORMAL
public static final java.lang.String STATUS_MESSAGE_HANDLING_NORMAL
Constant indicating that this job displays status messages.- See Also:
STATUS_MESSAGE_HANDLING
, Constant Field Values
-
SUBMITTED_BY_JOB_NAME
public static final int SUBMITTED_BY_JOB_NAME
Job attribute representing the job name of the submitter's job. If the job has no submitter, this value is blank.Read-only: true
Type: String
- See Also:
- Constant Field Values
-
SUBMITTED_BY_USER
public static final int SUBMITTED_BY_USER
Job attribute representing the user name of the submitter. If the job has no submitter, this value is blank.Read-only: true
Type: String
Can be loaded by JobList: false
- See Also:
- Constant Field Values
-
SUBMITTED_BY_JOB_NUMBER
public static final int SUBMITTED_BY_JOB_NUMBER
Job attribute representing the job number of the submitter's job. If the job has no submitter, this value is blank.Read-only: true
Type: String
Can be loaded by JobList: false
- See Also:
- Constant Field Values
-
SUBSYSTEM
public static final int SUBSYSTEM
Job attribute representing the subsystem description in which an active job is running. This value is only for jobs whose status is *ACTIVE. For jobs with status of *OUTQ or *JOBQ, this value is blank.Read-only: true
Type: String
- See Also:
getSubsystem()
, Constant Field Values
-
SYSTEM_POOL_ID
public static final int SYSTEM_POOL_ID
Job attribute representing the identifier of the system-related pool from which the job's main storage is allocated. These identifiers are not the same as those specified in the subsystem description, but are the same as the system pool identifiers shown on the system status display. This is the pool that the threads in the job start in. Also see the CURRENT_SYSTEM_POOL_ID for more information.Read-only: true
Type: Integer
-
SYSTEM_LIBRARY_LIST
public static final int SYSTEM_LIBRARY_LIST
Job attribute representing the system portion of the library list of the initial thread of the job.Read-only: true
Type: String
Can be loaded by JobList: false
-
TEMP_STORAGE_USED
public static final int TEMP_STORAGE_USED
Job attribute representing the amount of auxiliary storage (in kilobytes) that is currently allocated to this job. This value will reach a maximum of 2,147,483,647 kilobytes. If the actual temporary storage used is larger than that value, this attribute will return 2,147,483,647 kilobytes. It is recomended that the TEMP_STORAGE_USED_LARGE attribute be used to get over the limit.Read-only: true
Type: Integer
- See Also:
- Constant Field Values
-
TEMP_STORAGE_USED_LARGE
public static final int TEMP_STORAGE_USED_LARGE
Job attribute representing the amount of auxiliary storage (in megabytes) that is currently allocated to this job.Read-only: true
Type: Long
- See Also:
- Constant Field Values
-
THREAD_COUNT
public static final int THREAD_COUNT
Job attribute representing the count of the current number of active threads in the process at the time of the materialization. An active thread may be either actively running, suspended, or waiting for a resource.Read-only: true
Type: Integer
- See Also:
- Constant Field Values
-
TIME_SEPARATOR
public static final int TIME_SEPARATOR
Job attribute representing the value used to separate hours, minutes, and seconds when presenting a time. Possible values are:TIME_SEPARATOR_SYSTEM_VALUE
TIME_SEPARATOR_COLON
TIME_SEPARATOR_PERIOD
TIME_SEPARATOR_BLANK
TIME_SEPARATOR_COMMA
Type: String
-
TIME_SEPARATOR_SYSTEM_VALUE
public static final java.lang.String TIME_SEPARATOR_SYSTEM_VALUE
Constant indicating the time separator specified in the system value QTIMSEP is used.- See Also:
TIME_SEPARATOR
, Constant Field Values
-
TIME_SEPARATOR_COLON
public static final java.lang.String TIME_SEPARATOR_COLON
Constant indicating a colon (:) is used for the time separator.- See Also:
TIME_SEPARATOR
, Constant Field Values
-
TIME_SEPARATOR_PERIOD
public static final java.lang.String TIME_SEPARATOR_PERIOD
Constant indicating a period (.) is used for the time separator.- See Also:
TIME_SEPARATOR
, Constant Field Values
-
TIME_SEPARATOR_BLANK
public static final java.lang.String TIME_SEPARATOR_BLANK
Constant indicating a blank is used for the time separator.- See Also:
TIME_SEPARATOR
, Constant Field Values
-
TIME_SEPARATOR_COMMA
public static final java.lang.String TIME_SEPARATOR_COMMA
Constant indicating a comma (,) is used for the time separator.- See Also:
TIME_SEPARATOR
, Constant Field Values
-
TIME_SLICE
public static final int TIME_SLICE
Job attribute representing the maximum amount of processor time (in milliseconds) given to each thread in this job before other threads in this job and in other jobs are given the opportunity to run. The time slice establishes the amount of time needed by a thread in this job to accomplish a meaningful amount of processing. At the end of the time slice, the thread might be put in an inactive state so that other threads can become active in the storage pool. If the job consists of multiple routing steps, a change to this attribute during a routing step does not apply to subsequent routing steps. Values retrieved range from 8 through 9,999,999 milliseconds (that is, 9999.999 seconds). Although you can specify a value of less than 8, the system takes a minimum of 8 milliseconds to run a process.Type: Integer
- See Also:
getTimeSlice()
,setTimeSlice(int)
, Constant Field Values
-
TIME_SLICE_END_POOL
public static final int TIME_SLICE_END_POOL
Job attribute representing whether a thread in an interactive job moves to another main storage pool at the end of its time slice. Possible values are:Type: String
-
TIME_SLICE_END_POOL_SYSTEM_VALUE
public static final java.lang.String TIME_SLICE_END_POOL_SYSTEM_VALUE
Constant indicating the value in the system value QTSEPPOOL is used.- See Also:
TIME_SLICE_END_POOL
, Constant Field Values
-
TIME_SLICE_END_POOL_NONE
public static final java.lang.String TIME_SLICE_END_POOL_NONE
Constant indicating that a thread in the job does not move to another main storage pool when it reaches the end of its time slice.- See Also:
TIME_SLICE_END_POOL
, Constant Field Values
-
TIME_SLICE_END_POOL_BASE
public static final java.lang.String TIME_SLICE_END_POOL_BASE
Constant indicating that a thread in the job moves to the base pool when it reaches the end of its time slice.- See Also:
TIME_SLICE_END_POOL
, Constant Field Values
-
TOTAL_RESPONSE_TIME
public static final int TOTAL_RESPONSE_TIME
Job attribute representing the total amount of response time for the initial thread, in milliseconds. This value does not include the time used by the machine, by the attached input/output (I/O) hardware, and by the transmission lines for sending and receiving data. This value is zero for jobs that have no interactions. A value of -1 is returned if this field is not large enough to hold the actual result.Read-only: true
Type: Integer
- See Also:
getTotalResponseTime()
, Constant Field Values
-
UNIT_OF_WORK_ID
public static final int UNIT_OF_WORK_ID
Job attribute representing the unit of work ID used to track jobs across multiple systems. If a job is not associated with a source or target system using advanced program-to-program communications (APPC), this information is not used. Every job on the system is assigned a unit of work ID. The unit-of-work identifier is made up of:Read-only: true
Type: String
- See Also:
getWorkIDUnit()
, Constant Field Values
-
LOCATION_NAME
public static final int LOCATION_NAME
Job attribute representing the location name portion of the unit of work ID. This portion of the unit-of-work identifier is the name of the source system that originated the APPC job.Read-only: true
Type: String
- See Also:
UNIT_OF_WORK_ID
,getWorkIDUnit()
, Constant Field Values
-
NETWORK_ID
public static final int NETWORK_ID
Job attribute representing the network ID portion of the unit of work ID. This portion of the unit-of-work identifier is the network name associated with the unit of work.Read-only: true
Type: String
- See Also:
UNIT_OF_WORK_ID
,getWorkIDUnit()
, Constant Field Values
-
INSTANCE
public static final int INSTANCE
Job attribute representing the instance portion of the unit of work ID. This portion of the unit-of-work identifier is the value that further identifies the source of the job. This is shown as hexadecimal data.Read-only: true
Type: String
- See Also:
UNIT_OF_WORK_ID
,getWorkIDUnit()
, Constant Field Values
-
SEQUENCE_NUMBER
public static final int SEQUENCE_NUMBER
Job attribute representing the sequence number portion of the unit of work ID. This portion of the unit-of-work identifier is a value that identifies a checkpoint within the application program.Read-only: true
Type: String
- See Also:
UNIT_OF_WORK_ID
,getWorkIDUnit()
, Constant Field Values
-
USER_LIBRARY_LIST
public static final int USER_LIBRARY_LIST
Job attribute representing the user portion of the library list for the initial thread of the job.Read-only: true
Type: String
Can be loaded by JobList: false
-
USER_NAME
public static final int USER_NAME
Job attribute representing the user name of the job, which is the same as the name of the user profile under which the job was started. It can come from several different sources, depending on the type of job. This may be different than the user profile under which the job is currently running. See the CURRENT_USER attribute for more information. Possible values are:- A specific user profile name.
USER_NAME_BLANK
Type: String
-
USER_NAME_BLANK
public static final java.lang.String USER_NAME_BLANK
Constant indicating a blank user name. This must be used when JOB_NAME_INTERNAL or JOB_NAME_CURRENT is specified for the JOB_NAME.- See Also:
USER_NAME
, Constant Field Values
-
USER_RETURN_CODE
public static final int USER_RETURN_CODE
Job attribute representing the user-defined return code set by ILE high-level language constructs. An example is the program return code in the C language. This field is scoped to the job and represents the most recent return code set by any thread within the job.Read-only: true
Type: Integer
- See Also:
- Constant Field Values
-
-
Constructor Detail
-
Job
public Job()
Constructs a Job object. The system and basic job information must be set before connecting to the system.
-
Job
public Job(AS400 system)
Constructs a Job object. The job name, user name, and job number of the job that this program is running in will be used. Typically, that will be the job information for the remote command host server job associated with the specified system object.- Parameters:
system
- The system object representing the system on which the job exists.- See Also:
setName(java.lang.String)
,setNumber(java.lang.String)
,setUser(java.lang.String)
-
Job
public Job(AS400 system, java.lang.String jobName, java.lang.String userName, java.lang.String jobNumber)
Constructs a Job object.- Parameters:
system
- The system object representing the system on which the job exists.jobName
- The job name. Specify JOB_NAME_CURRENT to indicate the job that this program is running in.userName
- The user name. This must be USER_NAME_BLANK if the job name is JOB_NAME_CURRENT.jobNumber
- The job number. This must be JOB_NUMBER_BLANK if job name is JOB_NAME_CURRENT.
-
Job
public Job(AS400 system, java.lang.String internalJobID)
Deprecated. UseJob(AS400,byte[])
instead. The internal job ID should be treated as a byte array of 16 bytes.Constructs a Job object. This sets the job name to JOB_NAME_INTERNAL, the user name to USER_NAME_BLANK, and the job number to JOB_NUMBER_BLANK.- Parameters:
system
- The system object representing the system on which the job exists.internalJobID
- The internal job identifier.
-
Job
public Job(AS400 system, byte[] internalJobID)
Constructs a Job object. This sets the job name to JOB_NAME_INTERNAL, the user name to USER_NAME_BLANK, and the job number to JOB_NUMBER_BLANK.- Parameters:
system
- The system.internalJobID
- The 16-byte internal job identifier.
-
-
Method Detail
-
addPropertyChangeListener
public void addPropertyChangeListener(java.beans.PropertyChangeListener listener)
Adds a PropertyChangeListener. The specified PropertyChangeListener'spropertyChange()
method will be called each time the value of any bound property is changed.- Parameters:
listener
- The listener.- See Also:
removePropertyChangeListener(java.beans.PropertyChangeListener)
-
addVetoableChangeListener
public void addVetoableChangeListener(java.beans.VetoableChangeListener listener)
Adds a VetoableChangeListener. The specified VetoableChangeListener'svetoableChange()
method will be called each time the value of any constrained property is changed.- Parameters:
listener
- The listener.- See Also:
removeVetoableChangeListener(java.beans.VetoableChangeListener)
-
commitChanges
public void commitChanges() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Commits all uncommitted attribute changes. Calling this method will set all uncommitted attribute changes to the job on the system.
Note: To commit the changes, the Toolbox by default calls system API (QWTCHGJB) off-thread, that is, via the Remote Command Host Server.- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
commitChanges(boolean)
-
commitChanges
public void commitChanges(boolean callOnThread) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Commits all uncommitted attribute changes. Calling this method will set all uncommitted attribute changes to the job on the system.
When running on an IBM i system: If callOnThread is true, then the system API (QWTCHGJB) will be called on-thread, that is, in the same thread as the JVM. If callOnThread is false, then the system API will be called off-thread, that is, in the thread of the Remote Command Host Server job.
Caution: The QWTCHGJB API is specified as "conditionally threadsafe". Please refer to the IBM i Programmer's Guide for details on the threadsafety of specific attribute changes. Note that this method specifies format name JOBC0100 when calling QWTCHGJB.
Note: This method behaves identically tocommitChanges()
if the Java application is running remotely, that is, is not running "natively" on an IBM i system. When running remotely, the Toolbox submits all program calls through the Remote Command Host Server.- Parameters:
callOnThread
- Whether to call the system API on-thread or off-thread.- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.
-
end
public void end(int delay) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Ends this job. To end the job controlled, specify -1 for the delay. To end the job immediately, specify 0 for the delay. Specify any other amount of delay time (in seconds) allowed for the job to cleanup.- Parameters:
delay
- The delay time in seconds.- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
hold(boolean)
,release()
-
getAuxiliaryIORequests
public int getAuxiliaryIORequests() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the number of auxiliary I/O requests performed by the job across all routing steps. This includes both database and nondatabase paging. If the number of auxiliary I/O requests is greater than or equal to 2,147,483,647, a value of -1 is returned. Use the AUXILIARY_IO_REQUESTS_LARGE attribute to retrieve values that are greater than or equal to 2,147,483,647.- Returns:
- The number of auxiliary I/O requests performed by the job across all routing steps.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
AUXILIARY_IO_REQUESTS
-
getBreakMessageHandling
public java.lang.String getBreakMessageHandling() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns a value which represents how this job handles break messages.- Returns:
- How this job handles break messages. Possible values are:
BREAK_MESSAGE_HANDLING_NORMAL
- The message queue status determines break message handling.BREAK_MESSAGE_HANDLING_HOLD
- The message queue holds break messages until a user or program requests them. The work station user uses the Display Message (DPSMSG) command to display the messages; a program must issue a Receive Message (RCVMSG) command to receive a message and handle it.BREAK_MESSAGE_HANDLING_NOTIFY
- The system notifies the job's message queue when a message arrives. For interactive jobs, the audible alarm sounds if there is one, and the message-waiting light comes on.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
BREAK_MESSAGE_HANDLING
-
getCacheChanges
public boolean getCacheChanges()
Indicates if the attribute value changes are cached.- Returns:
- true if attribute value changes are cached, false if attribute value changes are committed immediatly. The default is true.
- See Also:
commitChanges()
,getValue(int)
,setCacheChanges(boolean)
,setValue(int, java.lang.Object)
-
getCallStack
public CallStackEntry[] getCallStack(long threadID) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the call stack for the specified thread in this job. This method does not cache any information and always retrieves its data from the system every time it is called.- Parameters:
threadID
- The thread identifier, orJob.INITIAL_THREAD
for the initial thread of this job.- Returns:
- The array of call stack entries in this job's call stack. The element at index 0 is the oldest entry in the stack, and the last element in the array is the newest, or highest, entry in the stack.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.
-
getCodedCharacterSetID
public int getCodedCharacterSetID() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the coded character set identifier (CCSID) used for this job.- Returns:
- The coded character set identifier (CCSID) used for this job.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
CCSID
-
getCompletionStatus
public java.lang.String getCompletionStatus() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the completion status of the job.- Returns:
- The completion status of the job. Possible values are:
COMPLETION_STATUS_NOT_COMPLETED
- The job has not completed.COMPLETION_STATUS_COMPLETED_NORMALLY
- The job completed normally.COMPLETION_STATUS_COMPLETED_ABNORMALLY
- The job completed abnormally.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed, or if the job can no longer be found (AS400Exception)..java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
COMPLETION_STATUS
-
getCountryID
public java.lang.String getCountryID() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the country or region identifier associated with this job.- Returns:
- The country or region identifier associated with this job.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
COUNTRY_ID
-
getCPUUsed
public int getCPUUsed() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the amount of processing unit time (in milliseconds) that the job used. If the processing unit time used is greater than or equal to 2,147,483,647 milliseconds, a value of -1 is returned. Use the CPU_TIME_USED_LARGE attribute to retrieve values that are greater than or equal to 2,147,483,647.- Returns:
- The amount of processing unit time (in milliseconds) that the job used.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
CPU_TIME_USED
-
getCurrentLibrary
public java.lang.String getCurrentLibrary() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the name of the current library for the initial thread of the job. If no current library exists, the CURRENT_LIBRARY_EXISTENCE attribute returns 0 and this attribute returns an empty string ("").- Returns:
- The name of the current library for the initial thread of the job.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
CURRENT_LIBRARY
-
getCurrentLibraryExistence
public boolean getCurrentLibraryExistence() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Indicates if a current library exists.- Returns:
- true if a current library exists, false otherwise.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
CURRENT_LIBRARY_EXISTENCE
-
getDate
public java.util.Date getDate() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the date and time when the job was placed on the system.- Returns:
- The date and time when the job was placed on the system.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
DATE_ENTERED_SYSTEM
-
getDateFormat
public java.lang.String getDateFormat() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the format in which dates are presented.- Returns:
- The format in which dates are presented. Possible values are:
DATE_FORMAT_YMD
- Year, month, and day format.DATE_FORMAT_MDY
- Month, day, and year format.DATE_FORMAT_DMY
- Day, month, and year format.DATE_FORMAT_JULIAN
- Julian format (year and day).
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
DATE_FORMAT
-
getDateSeparator
public java.lang.String getDateSeparator() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the value used to separate days, months, and years when presenting a date.- Returns:
- The value used to separate days, months, and years when presenting a date. Possible values are:
DATE_SEPARATOR_SLASH
- A slash (/) is used for the date separator.DATE_SEPARATOR_DASH
- A dash (-) is used for the date separator.DATE_SEPARATOR_PERIOD
- A period (.) is used for the date separator.DATE_SEPARATOR_BLANK
- A blank is used for the date separator.DATE_SEPARATOR_COMMA
- A comma (,) is used for the date separator.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
DATE_SEPARATOR
-
getDDMConversationHandling
public java.lang.String getDDMConversationHandling() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns whether connections using distributed data management (DDM) protocols remain active when they are not being used. The connections include APPC conversations, active TCP/IP connections, or Opti-Connect connections. The DDM protocols are used in Distributed Relational Database Architecture (DRDA) applications, DDM applications, or DB2 Multisystem applications.- Returns:
- Whether connections using distributed data management (DDM) protocols remain active when they are not being used. Possible values are:
KEEP_DDM_CONNECTIONS_ACTIVE_KEEP
- The system keeps DDM connections active when there are no users, except for the following:- The routing step ends on the source system. The routing step ends when the job ends or when the job is rerouted to another routing step.
- The Reclaim Distributed Data Management Conversation (RCLDDMCNV) command or the Reclaim Resources (RCLRSC) command runs.
- A communications failure or an internal failure occurs.
- A DRDA connection to an application server not running on an IBM i system ends.
KEEP_DDM_CONNECTIONS_ACTIVE_DROP
- The system ends a DDM connection when there are no users. Examples include when an application closes a DDM file, or when a DRDA application runs an SQL DISCONNECT statement.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
KEEP_DDM_CONNECTIONS_ACTIVE
-
getDecimalFormat
public java.lang.String getDecimalFormat() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the decimal format used for this job.- Returns:
- The decimal format used for this job. Possible values are:
DECIMAL_FORMAT_PERIOD
- Uses a period for a decimal point, a comma for a 3-digit grouping character, and zero-suppresses to the left of the decimal point.DECIMAL_FORMAT_COMMA_J
- Uses a comma for a decimal point, a period for a 3-digit grouping character, and zero-suppresses to the left of the decimal point.DECIMAL_FORMAT_COMMA_I
- Uses a comma for a decimal point and a period for a 3-digit grouping character. The zero-suppression character is in the second position (rather than the first) to the left of the decimal notation. Balances with zero values to the left of the comma are written with one leading zero (0,04). This constant also overrides any edit codes that might suppress the leading zero.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
DECIMAL_FORMAT
-
getDefaultCodedCharacterSetIdentifier
public int getDefaultCodedCharacterSetIdentifier() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the default coded character set identifier (CCSID) used for this job.- Returns:
- The default coded character set identifier (CCSID) used for this job. The value will be 0 if the job is not active.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
DEFAULT_CCSID
-
getDefaultWait
public int getDefaultWait() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the default maximum time (in seconds) that a thread in the job waits for a system instruction, such as a LOCK machine interface (MI) instruction, to acquire a resource. This default wait time is used when a wait time is not otherwise specified for a given situation. Normally, this is the amount of time the user is willing to wait for the system before the request is ended. If the job consists of multiple routing steps, a change to this attribute during a routing step does not appy to subsequent routing steps. The valid range is 1 through 9999999. A value of -1 represents no maximum wait time (*NOMAX).- Returns:
- The default maximum time (in seconds) that a thread in the job waits for a system instruction to acquire a resource. The value -1 means there is no maximum (*NOMAX).
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
DEFAULT_WAIT_TIME
-
getDeviceRecoveryAction
public java.lang.String getDeviceRecoveryAction() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the action taken for interactive jobs when an I/O error occurs for the job's requesting program device.- Returns:
- The action taken for interactive jobs when an I/O error occurs for the job's requesting program device. Possible values are:
DEVICE_RECOVERY_ACTION_MESSAGE
- Signals the I/O error message to the application and lets the application program perform error recovery.DEVICE_RECOVERY_ACTION_DISCONNECT_MESSAGE
- Disconnects the job when an I/O error occurs. When the job reconnects, the system sends an error message to the application program, indicating the job has reconnected and that the work station device has recovered.DEVICE_RECOVERY_ACTION_DISCONNECT_END_REQUEST
- Disconnects the job when an I/O error occurs. When the job reconnects, the system sends the End Request (ENDRQS) command to return control to the previous request level.DEVICE_RECOVERY_ACTION_END_JOB
- Ends the job when an I/O error occurs. A message is sent to the job's log and to the history log (QHST) indicating the job ended because of a device error.DEVICE_RECOVERY_ACTION_END_JOB_NO_LIST
- Ends the job when an I/O error occurs. There is no job log produced for the job. The system sends a message to the QHST log indicating the job ended because of a device error.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
DEVICE_RECOVERY_ACTION
-
getEndSeverity
public int getEndSeverity() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the message severity level of escape messages that can cause a batch job to end. The batch job ends when a request in the batch input stream sends an escape message, whose severity is equal to or greater than this value, to the request processing program.- Returns:
- The message severity level of escape messages that can cause a batch job to end.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
END_SEVERITY
-
getFunctionName
public java.lang.String getFunctionName() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns additional information (as described by the FUNCTION_TYPE attribute) about the last high-level function initiated by the initial thread.- Returns:
- The additional information (as described by the FUNCTION_TYPE attribute) about the last high-level function initiated by the initial thread.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
FUNCTION_NAME
-
getFunctionType
public java.lang.String getFunctionType() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the last high-level function initiated by the initial thread. This field may not be cleared when a function is completed.- Returns:
- The last high-level function initiated by the initial thread. Possible values are:
FUNCTION_TYPE_BLANK
- The system is not performing a logged function.FUNCTION_TYPE_COMMAND
- A command is running interactively, or it is in a batch input stream, or it was requested from a system menu. Commands in CL programs or REXX procedures are not logged. The FUNCTION_NAME attribute contains the name of the command and is only updated when a command is processed.FUNCTION_TYPE_DELAY
- The initial thread of the job is processing a Delay Job (DLYJOB) command. The FUNCTION_NAME attribute contains the number of seconds the job is delayed (up to 999999 seconds), or the time when the job is to resume processing (HH:MM:SS), depending on how you specified the command.FUNCTION_TYPE_GROUP
- The Transfer Group Job (TFRGRPJOB) command suspended the job. The FUNCTION_NAME attribute contains the group job name for that job.FUNCTION_TYPE_INDEX
- The initial thread of the job is rebuilding an index (access path). The FUNCTION_NAME attribute contains the name of the logical file whose index is rebuilt.FUNCTION_TYPE_JAVA
- The initial thread of the job is running a Java Vertual Machine (JVM). The FUNCTION_NAME attribute contains the name of the java class.FUNCTION_TYPE_LOG
- The system logs history information in a database file. The FUNCTION_NAME attribute contains the name of the log (QHST is the only log currently supported).FUNCTION_TYPE_MRT
- The job is a multiple requester terminal (MRT) job if theJOB_TYPE
isJOB_TYPE_BATCH
and theJOB_SUBTYPE
isJOB_SUBTYPE_MRT
, or it is an interactive job attached to an MRT job if theJOB_TYPE
isJOB_TYPE_INTERACTIVE
.For MRT jobs, the FUNCTION_NAME attribute contains information in the following format:
- CHAR(2): The number of requesters currently attached to the MRT job.
- CHAR(1): The field is reserved for a / (slash).
- CHAR(2): The maximum number (MRTMAX) of requesters.
- CHAR(1): Reserved.
- CHAR(3): The never-ending program (NEP) indicator. If an MRT is also an NEP, the MRT stays active even if there are no requesters of the MRT. A value of NEP indicates a never-ending program. A value of blanks indicates that it is not a never-ending program.
- CHAR(1): Reserved.
For interactive jobs attached to an MRT, the FUNCTION_NAME attribute contains the name of the MRT procedure.
FUNCTION_TYPE_MENU
- The initial thread of the job is currently at a system menu. The FUNCTION_NAME field contains the name of the menu.FUNCTION_TYPE_IO
- The job is a subsystem monitor that is performing input/output (I/O) operations to a work station. The FUNCTION_NAME attribute contains the name of the work station device to which the subsystem is performing an input/output operation.FUNCTION_TYPE_PROCEDURE
- The initial thread of the job is running a procedure. The FUNCTION_NAME attribute contains the name of the procedure.FUNCTION_TYPE_PROGRAM
- The initial thread of the job is running a program. The FUNCTION_NAME attribute contains the name of the program.FUNCTION_TYPE_SPECIAL
- The function type is a special function. For this value, the FUNCTION_NAME attribute contains one of the following values:- ADLACTJOB: Auxiliary storage is being allocated for the number of active jobs specified in the QADLACTJ system value. This may indicate that the system value for the initial number of active jobs is too low.
- ADLTOTJOB: Auxiliary storage is being allocated for the number of jobs specified in the QADLTOTJ system value.
- CMDENT: The Command Entry display is being used.
- COMMIT: A commit operation is being performed.
- DIRSHD: Directory shadowing.
- DLTSPLF: The system is deleting a spooled file.
- DUMP: A dump is in process.
- JOBIDXRCY: A damaged job index is being recovered.
- JOBLOG: The system is producing a job log.
- PASSTHRU: The job is a pass-through job.
- RCLSPLSTG: Empty spooled database members are being deleted.
- ROLLBACK: A rollback operation is being performed.
- SPLCLNUP: Spool cleanup is in process.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
FUNCTION_TYPE
-
getInquiryMessageReply
public java.lang.String getInquiryMessageReply() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns how the job answers inquiry messages.- Returns:
- How the job answers inquiry messages. Possible values are:
INQUIRY_MESSAGE_REPLY_REQUIRED
- The job requires an answer for any inquiry messages that occur while this job is running.INQUIRY_MESSAGE_REPLY_DEFAULT
- The system uses the default message reply to answer any inquiry messages issued while this job is running. The default reply is either defined in the message description or is the default system reply.INQUIRY_MESSAGE_REPLY_SYSTEM_REPLY_LIST
- The system reply list is checked to see if there is an entry for an inquiry message issued while this job is running. If a match occurs, the system uses the reply value for that entry. If no entry exists for that message, the system uses an inquiry message.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
INQUIRY_MESSAGE_REPLY
-
getInteractiveTransactions
public int getInteractiveTransactions() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the count of operator interactions, such as pressing the Enter key or a function key. This field is zero for jobs that have no interactions.- Returns:
- The count of operator interactions, such as pressing the Enter key or a function key. This field is zero for jobs that have no interactions.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
INTERACTIVE_TRANSACTIONS
-
getInternalJobID
public java.lang.String getInternalJobID()
Deprecated. UsegetInternalJobIdentifier()
instead. The internal job identifier should be treated as a byte array of 16 bytes.Returns the internal job identifier. The internal job identifier is a value input to other APIs to increase the speed of locating the job on the system. The identifier is not valid following an initial program load (IPL). If you attempt to use it after an IPL, an exception occurs.- Returns:
- The internal job identifier.
-
getInternalJobIdentifier
public byte[] getInternalJobIdentifier()
Returns the internal job identifier. The internal job identifier is a value input to other APIs to increase the speed of locating the job on the system. The identifier is not valid following an initial program load (IPL). If you attempt to use it after an IPL, an exception occurs.- Returns:
- The 16-byte internal job identifier, or null if one has not been set or retrieved from the system.
- See Also:
setInternalJobIdentifier(byte[])
-
getJobAccountingCode
public java.lang.String getJobAccountingCode() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns an identifier assigned to the job by the system to collect resource use information for the job when job accounting is active.- Returns:
- An identifier assigned to the job by the system to collect resource use information for the job when job accounting is active.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
ACCOUNTING_CODE
-
getJobActiveDate
public java.util.Date getJobActiveDate() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the date and time when the job began to run on the system.- Returns:
- The date and time when the job began to run on the system.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
DATE_STARTED
-
getJobDate
public java.util.Date getJobDate() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the date to be used for the job. This value is for jobs whose status is *JOBQ or *ACTIVE. For jobs with a status of *OUTQ, the value for this field is blank.- Returns:
- The date to be used for the job.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
JOB_DATE
-
getJobDescription
public java.lang.String getJobDescription() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the fully qualified integrated file system path name for the job description. The job description is a set of job-related attributes used for one or more jobs on the system. These attributes determine how the job is run on the system. Multiple jobs can also use the same job description.- Returns:
- The fully qualified integrated file system path name for the job description.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
JOB_DESCRIPTION
,QSYSObjectPathName
-
getJobEndedDate
public java.util.Date getJobEndedDate() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the date and time when the job completed running on the system.- Returns:
- The date and time when the job completed running on the system.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
DATE_ENDED
-
getJobEnterSystemDate
public java.util.Date getJobEnterSystemDate() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the date and time when the job was placed on the system.- Returns:
- The date and time when the job was placed on the system.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
DATE_ENTERED_SYSTEM
-
getJobLog
public JobLog getJobLog()
Returns the job log.- Returns:
- The job log.
-
getJobMessageQueueFullAction
public java.lang.String getJobMessageQueueFullAction() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the action to take when the message queue is full.- Returns:
- The action to take when the message queue is full. Possible values are:
MESSAGE_QUEUE_ACTION_NO_WRAP
- When the job message queue is full, do not wrap. This action causes the job to end.MESSAGE_QUEUE_ACTION_WRAP
- When the job message queue is full, wrap to the beginning and start filling again.MESSAGE_QUEUE_ACTION_PRINT_WRAP
- When the job message queue is full, wrap the message queue and print the messages that are being overlaid because of the wrapping.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
MESSAGE_QUEUE_ACTION
-
getJobMessageQueueMaximumSize
public int getJobMessageQueueMaximumSize() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the maximum size (in megabytes) that the job message queue can become.- Returns:
- The maximum size (in megabytes) that the job message queue can become. The range is 2 to 64.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
MESSAGE_QUEUE_MAX_SIZE
-
getJobPutOnJobQueueDate
public java.util.Date getJobPutOnJobQueueDate() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the date and time this job was put on this job queue. This field will contain blanks if the job was not on a job queue.- Returns:
- The date and time this job was put on this job queue.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
JOB_QUEUE_DATE
-
getScheduleDate
public java.util.Date getScheduleDate() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the date and time the job is scheduled to become active.- Returns:
- The date and time the job is scheduled to become active.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
SCHEDULE_DATE
-
getJobStatusInJobQueue
public java.lang.String getJobStatusInJobQueue() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the status of this job on the job queue.- Returns:
- The status of this job on the job queue. Possible values are:
JOB_QUEUE_STATUS_BLANK
- This job was not on a job queue.JOB_QUEUE_STATUS_SCHEDULED
- This job will run as scheduled.JOB_QUEUE_STATUS_HELD
- This job is being held on the job queue.JOB_QUEUE_STATUS_READY
- This job is ready to be selected.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
JOB_QUEUE_STATUS
-
getJobSwitches
public java.lang.String getJobSwitches() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the current setting of the job switches used by this job. This value is returned for all job types.- Returns:
- The current setting of the job switches used by this job.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
JOB_SWITCHES
-
getLanguageID
public java.lang.String getLanguageID() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the language identifier associated with this job. The language identifier is used when *LANGIDUNQ or *LANGIDSHR is specified on the sort sequence parameter. If the job CCSID is 65535, this parameter is also used to determine the value of the job default CCSID.- Returns:
- The language identifier associated with this job.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
LANGUAGE_ID
-
getLoggingCLPrograms
public java.lang.String getLoggingCLPrograms() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns a value indicating whether or not commands are logged for CL programs that are run.- Returns:
- The value indicating whether or not commands are logged for CL programs that are run. Possible values are:
LOG_CL_PROGRAMS_YES
- Commands are logged for CL programs that are run.LOG_CL_PROGRAMS_NO
- Commands are not logged for CL programs that are run.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
LOG_CL_PROGRAMS
-
getLoggingLevel
public int getLoggingLevel() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns what type of information is logged.- Returns:
- A value indicating what type of information is logged. Possible values are:
- 0 - No messages are logged.
- 1 - All messages sent to the job's external message queue with a severity greater than or equal to the message logging severity are logged. This includes the indication of job start, job end, and job completion status.
- 2 - The following information is logged:
- Logging level 1 information.
- Request messages that result in a high-level message with a severity code greater than or equal to the logging severity cause the request message and all associated messages to be logged. A high-level message is one that is sent to the program message queue of the program that receives the request message. For example, QCMD is an IBM-supplied request processing program that receives request messages.
- 3 - The following information is logged:
- Logging level 1 and 2 information is logged.
- All request messages are logged.
- Commands run by a CL program are logged if it is allowed by the LOG_CL_PROGRAMS attribute and the log attribute of the CL program.
- 4 - The following information is logged:
- All request messages and all messages with a severity greater than or equal to the message logging severity, including trace messages.
- Commands run by a CL program are logged if it is allowed by the LOG_CL_PROGRAMS attribute and the log attribute of the CL program.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
LOGGING_LEVEL
-
getLoggingSeverity
public int getLoggingSeverity() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the severity level that is used in conjunction with the logging level to determine which error messages are logged in the job log. The values range from 00 through 99.- Returns:
- The severity level that is used in conjunction with the logging level to determine which error messages are logged in the job log.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
LOGGING_SEVERITY
-
getLoggingText
public java.lang.String getLoggingText() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the level of message text that is written in the job log when a message is logged according to the LOGGING_LEVEL and LOGGING_SEVERITY.- Returns:
- The level of message text that is written in the job log when a message is logged according to the LOGGING_LEVEL and LOGGING_SEVERITY. Possible values are:
LOGGING_TEXT_MESSAGE
- Only the message text is written to the job log.LOGGING_TEXT_SECLVL
- Both the message text and the message help (cause and recovery) of the error message are written to the job log.LOGGING_TEXT_NO_LIST
- If the job ends normally, no job log is produced. If the job ends abnormally (the job end code is 20 or higher), a job log is produced. The messages that appear in the job log contain both the message text and the message.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
LOGGING_TEXT
-
getModeName
public java.lang.String getModeName() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the mode name of the advanced program-to-program communications (APPC) device that started the job.- Returns:
- The mode name of the advanced program-to-program communications (APPC) device that started the job. Possible values are:
- The mode name is *BLANK.
- The mode name is blanks.
- The name of the mode.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
MODE
-
getName
public java.lang.String getName()
Returns the job name.- Returns:
- The job name.
-
getNumber
public java.lang.String getNumber()
Returns the job number.- Returns:
- The job number.
-
getNumberOfLibrariesInSYSLIBL
public int getNumberOfLibrariesInSYSLIBL() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the number of libraries in the system portion of the library list of the initial thread of the job.- Returns:
- The number of libraries in the system portion of the library list of the initial thread of the job.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
SYSTEM_LIBRARY_LIST
-
getNumberOfLibrariesInUSRLIBL
public int getNumberOfLibrariesInUSRLIBL() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the number of libraries in the user portion of the library list for the initial thread of the job.- Returns:
- The number of libraries in the user portion of the library list for the initial thread of the job.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
USER_LIBRARY_LIST
-
getNumberOfProductLibraries
public int getNumberOfProductLibraries() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the number of libraries that contain product information for the initial thread of the job.- Returns:
- The number of libraries that contain product information for the initial thread of the job.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
PRODUCT_LIBRARIES
-
getOutputQueue
public java.lang.String getOutputQueue() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the fully qualified integrated file system path name of the default output queue that is used for spooled output produced by this job. The default output queue is only for spooled printer files that specify *JOB for the output queue.- Returns:
- The fully qualified integrated file system path name of the default output queue that is used for spooled output produced by this job.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
OUTPUT_QUEUE
,QSYSObjectPathName
-
getOutputQueuePriority
public int getOutputQueuePriority() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the output priority for spooled output files that this job produces. The highest priority is 0, and the lowest is 9.- Returns:
- The output priority for spooled output files that this job produces.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
OUTPUT_QUEUE_PRIORITY
-
getPoolIdentifier
public int getPoolIdentifier() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the identifier of the system-related pool from which the job's main storage is allocated. These identifiers are not the same as those specified in the subsystem description, but are the same as the system pool identifiers shown on the system status display. This is the pool that the threads in the job start in. Also see the CURRENT_SYSTEM_POOL_ID for more information.- Returns:
- The identifier of the system-related pool from which the job's main storage is allocated.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
SYSTEM_POOL_ID
-
getPrinterDeviceName
public java.lang.String getPrinterDeviceName() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the printer device used for printing output from this job.- Returns:
- The printer device used for printing output from this job.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
PRINTER_DEVICE_NAME
-
getPrintKeyFormat
public java.lang.String getPrintKeyFormat() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns a value indicating whether border and header information is provided when the Print key is pressed.- Returns:
- The value indicating whether border and header information is provided when the Print key is pressed. Possible values are:
PRINT_KEY_FORMAT_NONE
- The border and header information is not included with output from the Print key.PRINT_KEY_FORMAT_BORDER
- The border information is included with output from the Print key.PRINT_KEY_FORMAT_HEADER
- The header information is included with output from the Print key.PRINT_KEY_FORMAT_ALL
- The border and header information is included with output from the Print key.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
PRINT_KEY_FORMAT
-
getPrintText
public java.lang.String getPrintText() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the line of text (if any) that is printed at the bottom of each page of printed output for the job.- Returns:
- The line of text (if any) that is printed at the bottom of each page of printed output for the job.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
PRINT_TEXT
-
getProductLibraries
public java.lang.String[] getProductLibraries() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the libraries that contain product information for the initial thread of the job.- Returns:
- The libraries that contain product information for the initial thread of the job.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
PRODUCT_LIBRARIES
-
getPurge
public boolean getPurge() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Indicates whether or not the job is eligible to be moved out of main storage and put into auxiliary storage at the end of a time slice or when entering a long wait (such as waiting for a work station user's response). This attribute is ignored when more than one thread is active within the job. If the job consists of multiple routing steps, a change to this attribute during a routing step does not apply to subsequent routing steps.- Returns:
- true if the job is eligible to be moved out of main storage and put into auxiliary storage at the end of a time slice or when entering a long wait; false otherwise.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
ELIGIBLE_FOR_PURGE
-
getQueue
public java.lang.String getQueue() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the fully qualified integrated file system path name of the job queue that the job is currently on, or that the job was on if it is currently active. This value is for jobs whose status is *JOBQ or *ACTIVE. For jobs with a status of *OUTQ, the value for this field is blank.- Returns:
- The fully qualified integrated file system path name of the job queue that the job is currently on, or that the job was on if it is currently active.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
JOB_QUEUE
,QSYSObjectPathName
-
getQueuePriority
public int getQueuePriority() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the scheduling priority of the job compared to other jobs on the same job queue. The highest priority is 0 and the lowest is 9. This value is valid for jobs whose status is *JOBQ or *ACTIVE. For jobs with a status of *OUTQ, then the priority returned is -1.- Returns:
- The scheduling priority of the job compared to other jobs on the same job queue.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
JOB_QUEUE_PRIORITY
-
getRoutingData
public java.lang.String getRoutingData() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the routing data that is used to determine the routing entry that identifies the program to start for the routing step.- Returns:
- The routing data that is used to determine the routing entry that identifies the program to start for the routing step.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
ROUTING_DATA
-
getRunPriority
public int getRunPriority() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the priority at which the job is currently running, relative to other jobs on the system. The run priority ranges from 0 (highest priority) to 99 (lowest priority).- Returns:
- The priority at which the job is currently running, relative to other jobs on the system.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
RUN_PRIORITY
-
getSignedOnJob
public boolean getSignedOnJob() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Indicates whether the job is to be treated like a signed-on user on the system.- Returns:
- true if the job should be treateded like a signed-on user; false otherwise.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
SIGNED_ON_JOB
-
getSortSequenceTable
public java.lang.String getSortSequenceTable() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the name of the sort sequence table associated with this job.- Returns:
- The name of the sort sequence table associated with this job. Possible values are:
SORT_SEQUENCE_TABLE_NONE
- No sort sequence table is used. The hexadecimal values of the characters are used to determine the sort sequence.SORT_SEQUENCE_TABLE_LANGUAGE_SHARED_WEIGHT
- The sort sequence table used can contain the same weight for multiple characters, and it is the shared weight sort table associated with the language specified in the LANGUAGE_ID attribute.SORT_SEQUENCE_TABLE_LANGUAGE_UNIQUE_WEIGHT
- The sort sequence table used must contain a unique weight for each character in the code page, and it is the unique weight sort table associated with the language specified in the LANGUAGE_ID parameter.- The fully qualified integrated file system path name of the sort sequence table associated with this job.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
SORT_SEQUENCE_TABLE
,QSYSObjectPathName
-
getStatus
public java.lang.String getStatus() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the status of this job.- Returns:
- The status of this job. Possible values are:
JOB_STATUS_ACTIVE
- This job is an active job. This includes group jobs, system request jobs, and disconnected jobs.JOB_STATUS_JOBQ
- This job is currently on a job queue.JOB_STATUS_OUTQ
- This job has completed running, but still has output on an output queue.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed, or if the job can no longer be found (AS400Exception).java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
JOB_STATUS
-
getStatusMessageHandling
public java.lang.String getStatusMessageHandling() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns whether status messages are displayed for this job.- Returns:
- A value indicating whether status messages are displayed for this job. Possible values are:
STATUS_MESSAGE_HANDLING_NONE
- This job does not display status messages.STATUS_MESSAGE_HANDLING_NORMAL
- This job displays status messages.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
STATUS_MESSAGE_HANDLING
-
getStringValue
public java.lang.String getStringValue(int attribute) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the value for the specified job attribute, as a String. This is a generic way of retrieving string-valued job attributes, rather than using the specific getter methods. This method will either go to the system to retrieve the job attribute, or it will return a cached value if the attribute was previously retrieved or previously set by setValue() or one of the other setter methods. UseloadInformation()
to refresh the attributes from the system.- Parameters:
attribute
- The job attribute.- Returns:
- The current value of the attribute, as a blank-trimmed String. This method may return null in the rare case that the specified attribute could not be retrieved using the QUSRJOBI system API. If the attribute value is not of type String, then the result of
toString()
on the value object is returned. - Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
loadInformation()
,getValue(int)
,setValue(int, java.lang.Object)
-
getSubsystem
public java.lang.String getSubsystem() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the fully qualified integrated file system path name of the subsystem description for the subsystem in which the job is running.- Returns:
- The fully qualified integrated file system path name of the subsystem description for the subsystem in which the job is running.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
SUBSYSTEM
,QSYSObjectPathName
-
getSubtype
public java.lang.String getSubtype() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns additional information about the job type (if any exists).- Returns:
- Additional information about the job type (if any exists). Possible values are:
JOB_SUBTYPE_BLANK
- The job has no special subtype or is not a valid job.JOB_SUBTYPE_IMMEDIATE
- The job is an immediate job.JOB_SUBTYPE_PROCEDURE_START_REQUEST
- The job started with a procedure start request.JOB_SUBTYPE_MACHINE_SERVER_JOB
- The job is an AS/400 Advanced 36 machine server job.JOB_SUBTYPE_PRESTART
- The job is a prestart job.JOB_SUBTYPE_PRINT_DRIVER
- The job is a print driver job.JOB_SUBTYPE_MRT
- The job is a System/36 multiple requester terminal (MRT) job.JOB_SUBTYPE_ALTERNATE_SPOOL_USER
- The job is an alternate spool user job.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
JOB_SUBTYPE
-
getSystem
public AS400 getSystem()
Returns the system.- Returns:
- The system.
-
getSystemLibraryList
public java.lang.String[] getSystemLibraryList() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the system portion of the library list of the initial thread of the job.- Returns:
- The system portion of the library list of the initial thread of the job.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
SYSTEM_LIBRARY_LIST
-
getTimeSeparator
public java.lang.String getTimeSeparator() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the value used to separate hours, minutes, and seconds when presenting a time.- Returns:
- The value used to separate hours, minutes, and seconds when presenting a time. Possible values are:
TIME_SEPARATOR_COLON
- A colon (:) is used for the time separator.TIME_SEPARATOR_PERIOD
- A period (.) is used for the time separator.TIME_SEPARATOR_BLANK
- A blank is used for the time separator.TIME_SEPARATOR_COMMA
- A comma (,) is used for the time separator.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
TIME_SEPARATOR
-
getTimeSlice
public int getTimeSlice() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the maximum amount of processor time (in milliseconds) given to each thread in this job before other threads in this job and in other jobs are given the opportunity to run. The time slice establishes the amount of time needed by a thread in this job to accomplish a meaningful amount of processing. At the end of the time slice, the thread might be put in an inactive state so that other threads can become active in the storage pool. Values retrieved range from 8 through 9,999,999 milliseconds (that is, 9999.999 seconds). Although you can specify a value of less than 8, the system takes a minimum of 8 milliseconds to run a process.- Returns:
- The maximum amount of processor time (in milliseconds) given to each thread in this job before other threads in this job and in other jobs are given the opportunity to run.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
TIME_SLICE
-
getTimeSliceEndPool
public java.lang.String getTimeSliceEndPool() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns a value indicating whether a thread in an interactive job moves to another main storage pool at the end of its time slice.- Returns:
- The value indicating whether a thread in an interactive job moves to another main storage pool at the end of its time slice. Possible values are:
TIME_SLICE_END_POOL_NONE
- A thread in the job does not move to another main storage pool when it reaches the end of its time slice.TIME_SLICE_END_POOL_BASE
- A thread in the job moves to the base pool when it reaches the end of its time slice.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
TIME_SLICE_END_POOL
-
getTotalResponseTime
public int getTotalResponseTime() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the total amount of response time for the initial thread, in milliseconds. This value does not include the time used by the machine, by the attached input/output (I/O) hardware, and by the transmission lines for sending and receiving data. This value is zero for jobs that have no interactions. A value of -1 is returned if this field is not large enough to hold the actual result.- Returns:
- The total amount of response time for the initial thread, in milliseconds.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
TOTAL_RESPONSE_TIME
-
getType
public java.lang.String getType() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the type of job.- Returns:
- The type of job. Possible values are:
JOB_TYPE_NOT_VALID
- The job is not a valid job.JOB_TYPE_AUTOSTART
- The job is an autostart job.JOB_TYPE_BATCH
- The job is a batch job.JOB_TYPE_INTERACTIVE
- The job is an interactive job.JOB_TYPE_SUBSYSTEM_MONITOR
- The job is a subsystem monitor job.JOB_TYPE_SPOOLED_READER
- The job is a spooled reader job.JOB_TYPE_SYSTEM
- The job is a system job.JOB_TYPE_SPOOLED_WRITER
- The job is a spooled writer job.JOB_TYPE_SCPF_SYSTEM
- The job is the SCPF system job.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
JOB_TYPE
-
getUser
public java.lang.String getUser()
Returns the user name. This method will either return a cached value if theUSER_NAME
attribute was previously retrieved; or if attributes values have not yet been retrieved, the value previously by either a constructor,setUser()
, or one of the other setter methods.Note: To get the actual current user name for this job (for example, after swapping profiles), call
getStringValue(CURRENT_USER)
- Returns:
- The user name.
- See Also:
setUser(java.lang.String)
-
getUserLibraryList
public java.lang.String[] getUserLibraryList() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the user portion of the library list for the initial thread of the job.- Returns:
- The user portion of the library list for the initial thread of the job.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
USER_LIBRARY_LIST
-
getValue
public java.lang.Object getValue(int attribute) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the value for the specified job attribute. This is a generic way of retrieving job attributes, rather than using the specific getter methods. This method will either go to the system to retrieve the job attribute, or it will return a cached value if the attribute was previously retrieved or previously set by setValue() or one of the other setter methods. UseloadInformation()
to refresh the attributes from the system.- Parameters:
attribute
- The job attribute.- Returns:
- The current value of the attribute. This method may return null in the rare case that the specified attribute could not be retrieved using the QUSRJOBI system API. String values are not trimmed.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
loadInformation()
,getStringValue(int)
,setValue(int, java.lang.Object)
-
getWorkIDUnit
public java.lang.String getWorkIDUnit() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Returns the unit of work identifier. The unit of work identifier is used to track jobs across multiple systems. If a job is not associated with a source or target system using advanced program-to-program communications (APPC), this information is not used. Every job on the system is assigned a unit of work identifier.- Returns:
- The unit of work identifier, which is made up of:
- Location name - 8 Characters. The name of the source system that originated the APPC job.
- Network ID - 8 Characters. The network name associated with the unit of work.
- Instance - 6 Characters. The value that further identifies the source of the job. This is shown as hexadecimal data.
- Sequence Number - 2 Character. A value that identifies a check-point within the application program.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
LOCATION_NAME
,NETWORK_ID
,INSTANCE
,SEQUENCE_NUMBER
-
hold
public void hold(boolean holdSpooledFiles) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException
Holds this job.- Parameters:
holdSpooledFiles
- true to hold this job's spooled files; false otherwise.- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.- See Also:
end(int)
,release()
-
loadInformation
public void loadInformation()
Refreshes the values for all attributes. This does not cancel uncommitted changes. To refresh just the elapsed statistics, useloadStatistics()
.
-
loadInformation
public void loadInformation(int[] attributes)
Refreshes the values for specific attributes. This does not cancel uncommitted changes.
Note: The specified attributes will be refreshed, along with other attributes in their "format group". For more information about attribute format groups, refer to the specification of the QUSRJOBI API.- Parameters:
attributes
- The attributes to refresh.- See Also:
loadInformation()
,commitChanges()
,loadStatistics()
-
loadStatistics
public void loadStatistics() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Refreshes just the values for the elapsed statistics. Internally, this calls the QUSRJOBI API using the JOBI1000 format.- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
resetStatistics()
,loadInformation()
,ELAPSED_TIME
,ELAPSED_DISK_IO
,ELAPSED_DISK_IO_ASYNCH
,ELAPSED_DISK_IO_SYNCH
,ELAPSED_INTERACTIVE_RESPONSE_TIME
,ELAPSED_INTERACTIVE_TRANSACTIONS
,ELAPSED_CPU_PERCENT_USED
,ELAPSED_CPU_PERCENT_USED_FOR_DATABASE
,ELAPSED_CPU_TIME_USED
,ELAPSED_CPU_TIME_USED_FOR_DATABASE
,ELAPSED_LOCK_WAIT_TIME
,ELAPSED_PAGE_FAULTS
-
release
public void release() throws AS400Exception, AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException
Releases this job.- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.AS400Exception
- See Also:
end(int)
,hold(boolean)
-
removePropertyChangeListener
public void removePropertyChangeListener(java.beans.PropertyChangeListener listener)
Removes a PropertyChangeListener.- Parameters:
listener
- The listener.- See Also:
addPropertyChangeListener(java.beans.PropertyChangeListener)
-
removeVetoableChangeListener
public void removeVetoableChangeListener(java.beans.VetoableChangeListener listener)
Removes a VetoableChangeListener.- Parameters:
listener
- The listener.- See Also:
addVetoableChangeListener(java.beans.VetoableChangeListener)
-
resetStatistics
public void resetStatistics() throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Resets the measurement start time used for computing elapsed statistics.- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
loadStatistics()
,ELAPSED_TIME
,ELAPSED_DISK_IO
,ELAPSED_DISK_IO_ASYNCH
,ELAPSED_DISK_IO_SYNCH
,ELAPSED_INTERACTIVE_RESPONSE_TIME
,ELAPSED_INTERACTIVE_TRANSACTIONS
,ELAPSED_CPU_PERCENT_USED
,ELAPSED_CPU_PERCENT_USED_FOR_DATABASE
,ELAPSED_CPU_TIME_USED
,ELAPSED_CPU_TIME_USED_FOR_DATABASE
,ELAPSED_LOCK_WAIT_TIME
,ELAPSED_PAGE_FAULTS
-
setBreakMessageHandling
public void setBreakMessageHandling(java.lang.String breakMessageHandling) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets how this job handles break messages.- Parameters:
breakMessageHandling
- How this job handles break messages. Possible values are:BREAK_MESSAGE_HANDLING_NORMAL
- The message queue status determines break message handling.BREAK_MESSAGE_HANDLING_HOLD
- The message queue holds break messages until a user or program requests them. The work station user uses the Display Message (DPSMSG) command to display the messages; a program must issue a Receive Message (RCVMSG) command to receive a message and handle it.BREAK_MESSAGE_HANDLING_NOTIFY
- The system notifies the job's message queue when a message arrives. For interactive jobs, the audible alarm sounds if there is one, and the message-waiting light comes on.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
BREAK_MESSAGE_HANDLING
-
setCacheChanges
public void setCacheChanges(boolean cacheChanges)
Sets the value indicating whether attribute value changes are committed immediately. The default is true. If any cached changes are not committed before this method is called with a value of false, those changes are lost.- Parameters:
cacheChanges
- true to cache attribute value changes, false to commit all attribute value changes immediately.- See Also:
commitChanges()
,getCacheChanges()
,getValue(int)
,setValue(int, java.lang.Object)
-
setCodedCharacterSetID
public void setCodedCharacterSetID(int codedCharacterSetID) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets the coded character set identifier (CCSID) used for this job.- Parameters:
codedCharacterSetID
- The coded character set identifier (CCSID) used for this job. Possible values are:CCSID_SYSTEM_VALUE
- The CCSID specified in the system value QCCSID is used.CCSID_INITIAL_USER
- The CCSID specified in the user profile under which this thread was initially running is used.- A coded character set identifier.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
CCSID
-
setCountryID
public void setCountryID(java.lang.String countryID) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets the country or region identifier associated with this job.- Parameters:
countryID
- The country or region identifier associated with this job. Possible values are:COUNTRY_ID_SYSTEM_VALUE
- The system value QCNTRYID is used.COUNTRY_ID_INITIAL_USER
- The country or region ID specified in the user profile under which this thread was initially running is used.- A country or region identifier to be used by the job.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
COUNTRY_ID
-
setDateFormat
public void setDateFormat(java.lang.String dateFormat) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets the format in which dates are presented.- Parameters:
dateFormat
- The format in which dates are presented. Possible values are:DATE_FORMAT_SYSTEM_VALUE
- The system value QDATFMT is used.DATE_FORMAT_YMD
- Year, month, and day format.DATE_FORMAT_MDY
- Month, day, and year format.DATE_FORMAT_DMY
- Day, month, and year format.DATE_FORMAT_JULIAN
- Julian format (year and day).
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
DATE_FORMAT
-
setDateSeparator
public void setDateSeparator(java.lang.String dateSeparator) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets the value used to separate days, months, and years when presenting a date.- Parameters:
dateSeparator
- The value used to separate days, months, and years when presenting a date. Possible values are:DATE_SEPARATOR_SYSTEM_VALUE
- The system value QDATSEP is used.DATE_SEPARATOR_SLASH
- A slash (/) is used for the date separator.DATE_SEPARATOR_DASH
- A dash (-) is used for the date separator.DATE_SEPARATOR_PERIOD
- A period (.) is used for the date separator.DATE_SEPARATOR_BLANK
- A blank is used for the date separator.DATE_SEPARATOR_COMMA
- A comma (,) is used for the date separator.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
DATE_SEPARATOR
-
setDDMConversationHandling
public void setDDMConversationHandling(java.lang.String ddmConversationHandling) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets whether connections using distributed data management (DDM) protocols remain active when they are not being used. The connections include APPC conversations, active TCP/IP connections, or Opti-Connect connections. The DDM protocols are used in Distributed Relational Database Architecture (DRDA) applications, DDM applications, or DB2 Multisystem applications.- Parameters:
ddmConversationHandling
- Whether connections using distributed data management (DDM) protocols remain active when they are not being used. Possible values are:KEEP_DDM_CONNECTIONS_ACTIVE_KEEP
- The system keeps DDM connections active when there are no users, except for the following:- The routing step ends on the source system. The routing step ends when the job ends or when the job is rerouted to another routing step.
- The Reclaim Distributed Data Management Conversation (RCLDDMCNV) command or the Reclaim Resources (RCLRSC) command runs.
- A communications failure or an internal failure occurs.
- A DRDA connection to an application server not running on an IBM i system ends.
KEEP_DDM_CONNECTIONS_ACTIVE_DROP
- The system ends a DDM connection when there are no users. Examples include when an application closes a DDM file, or when a DRDA application runs an SQL DISCONNECT statement.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
KEEP_DDM_CONNECTIONS_ACTIVE
-
setDecimalFormat
public void setDecimalFormat(java.lang.String decimalFormat) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets the decimal format used for this job.- Parameters:
decimalFormat
- The decimal format used for this job. Possible values are:DECIMAL_FORMAT_SYSTEM_VALUE
- The system value QDECFMT is used as the decimal format for this job.DECIMAL_FORMAT_PERIOD
- Uses a period for a decimal point, a comma for a 3-digit grouping character, and zero-suppresses to the left of the decimal point.DECIMAL_FORMAT_COMMA_J
- Uses a comma for a decimal point, a period for a 3-digit grouping character, and zero-suppresses to the left of the decimal point.DECIMAL_FORMAT_COMMA_I
- Uses a comma for a decimal point and a period for a 3-digit grouping character. The zero-suppression character is in the second position (rather than the first) to the left of the decimal notation. Balances with zero values to the left of the comma are written with one leading zero (0,04). This constant also overrides any edit codes that might suppress the leading zero.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
DECIMAL_FORMAT
-
setDefaultWait
public void setDefaultWait(int defaultWait) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets the default maximum time (in seconds) that a thread in the job waits for a system instruction, such as a LOCK machine interface (MI) instruction, to acquire a resource. This default wait time is used when a wait time is not otherwise specified for a given situation. Normally, this is the amount of time the user is willing to wait for the system before the request is ended. If the job consists of multiple routing steps, a change to this attribute during a routing step does not appy to subsequent routing steps. The valid range is 1 through 9999999. A value of -1 represents no maximum wait time (*NOMAX).- Parameters:
defaultWait
- The default maximum time (in seconds) that a thread in the job waits for a system instruction to acquire a resource. The value -1 means there is no maximum (*NOMAX). The valid range is 1 through 9999999. The value 0 is not valid.- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
DEFAULT_WAIT_TIME
-
setDeviceRecoveryAction
public void setDeviceRecoveryAction(java.lang.String deviceRecoveryAction) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets the action taken for interactive jobs when an I/O error occurs for the job's requesting program device.- Parameters:
deviceRecoveryAction
- The action taken for interactive jobs when an I/O error occurs for the job's requesting program device. Possible values are:DEVICE_RECOVERY_ACTION_SYSTEM_VALUE
- The value in the system value QDEVRCYACN is used as the device recovery action for this job.DEVICE_RECOVERY_ACTION_MESSAGE
- Signals the I/O error message to the application and lets the application program perform error recovery.DEVICE_RECOVERY_ACTION_DISCONNECT_MESSAGE
- Disconnects the job when an I/O error occurs. When the job reconnects, the system sends an error message to the application program, indicating the job has reconnected and that the work station device has recovered.DEVICE_RECOVERY_ACTION_DISCONNECT_END_REQUEST
- Disconnects the job when an I/O error occurs. When the job reconnects, the system sends the End Request (ENDRQS) command to return control to the previous request level.DEVICE_RECOVERY_ACTION_END_JOB
- Ends the job when an I/O error occurs. A message is sent to the job's log and to the history log (QHST) indicating the job ended because of a device error.DEVICE_RECOVERY_ACTION_END_JOB_NO_LIST
- Ends the job when an I/O error occurs. There is no job log produced for the job. The system sends a message to the QHST log indicating the job ended because of a device error.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
DEVICE_RECOVERY_ACTION
-
-
setInquiryMessageReply
public void setInquiryMessageReply(java.lang.String inquiryMessageReply) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets how the job answers inquiry messages.- Parameters:
inquiryMessageReply
- How the job answers inquiry messages. Possible values are:INQUIRY_MESSAGE_REPLY_REQUIRED
- The job requires an answer for any inquiry messages that occur while this job is running.INQUIRY_MESSAGE_REPLY_DEFAULT
- The system uses the default message reply to answer any inquiry messages issued while this job is running. The default reply is either defined in the message description or is the default system reply.INQUIRY_MESSAGE_REPLY_SYSTEM_REPLY_LIST
- The system reply list is checked to see if there is an entry for an inquiry message issued while this job is running. If a match occurs, the system uses the reply value for that entry. If no entry exists for that message, the system uses an inquiry message.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
INQUIRY_MESSAGE_REPLY
-
setInternalJobID
public void setInternalJobID(java.lang.String internalJobID) throws java.beans.PropertyVetoException
Deprecated. UsesetInternalJobIdentifier(byte[])
instead. The internal job identifier should be treated as a byte array of 16 bytes.Sets the internal job identifier. This does not change the job on the system. Instead, it changes the job this Job object references. The job name must be set to "*INT" for this to be recognized. This cannot be changed if the object has established a connection to the system.- Parameters:
internalJobID
- The internal job identifier.- Throws:
java.beans.PropertyVetoException
- If the property change is vetoed.
-
setInternalJobIdentifier
public void setInternalJobIdentifier(byte[] internalJobID)
Sets the internal job identifier. This does not change the job on the system. Instead, it changes the job this Job object references. The job name must be set to "*INT" for this to be recognized. This cannot be changed if the object has established a connection to the system.- Parameters:
internalJobID
- The 16-byte internal job identifier.
-
setJobAccountingCode
public void setJobAccountingCode(java.lang.String jobAccountingCode) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets an identifier assigned to the job by the system to collect resource use information for the job when job accounting is active. The user who is changing this field must have authority to the CHGACGCDE CL command. If the user does not have the proper authority, this field is ignored and processing continues.- Parameters:
jobAccountingCode
- An identifier assigned to the job by the system to collect resource use information for the job when job accounting is active. Possible values are:ACCOUNTING_CODE_BLANK
- The accounting code is changed to all blanks.- Accounting code - The 15 character accounting code used for the next accounting segment. The accounting code may contain alphabetic or numeric characters.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
ACCOUNTING_CODE
-
setJobDate
public void setJobDate(java.util.Date jobDate) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets the date that is assigned to the job. This value will only be changed for jobs whose status is *JOBQ or *ACTIVE.- Parameters:
jobDate
- The date that is assigned to the job.- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
JOB_DATE
-
setJobMessageQueueFullAction
public void setJobMessageQueueFullAction(java.lang.String jobMessageQueueFullAction) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets the action to take when the message queue is full.- Parameters:
jobMessageQueueFullAction
- The action to take when the message queue is full. Possible values are:MESSAGE_QUEUE_ACTION_SYSTEM_VALUE
- The value specified for the QJOBMSGQFL system value is used.MESSAGE_QUEUE_ACTION_NO_WRAP
- When the job message queue is full, do not wrap. This action causes the job to end.MESSAGE_QUEUE_ACTION_WRAP
- When the job message queue is full, wrap to the beginning and start filling again.MESSAGE_QUEUE_ACTION_PRINT_WRAP
- When the job message queue is full, wrap the message queue and print the messages that are being overlaid because of the wrapping.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
MESSAGE_QUEUE_ACTION
-
setJobSwitches
public void setJobSwitches(java.lang.String jobSwitches) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets the current setting of the job switches that are used by this job. Specify any combination of eight 0's, 1's, or X's to change the job switch settings. If a switch is not being changed, enter an X in the position that represents that switch.- Parameters:
jobSwitches
- The current setting of the job switches that are used by this job.- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
JOB_SWITCHES
-
setLanguageID
public void setLanguageID(java.lang.String languageID) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets the language identifier associated with this job. The language identifier is used when *LANGIDUNQ or *LANGIDSHR is specified on the sort sequence parameter. If the job CCSID is 65535, this parameter is also used to determine the value of the job default CCSID.- Parameters:
languageID
- The language identifier associated with this job. Possible values are:LANGUAGE_ID_SYSTEM_VALUE
- The system value QLANGID is used.LANGUAGE_ID_INITIAL_USER
- The language ID specified in the user profile under which this thread was initially running is used.- The language identifier.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
LANGUAGE_ID
-
setLoggingCLPrograms
public void setLoggingCLPrograms(java.lang.String loggingCLPrograms) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets whether or not commands are logged for CL programs that are run.- Parameters:
loggingCLPrograms
- The value indicating whether or not commands are logged for CL programs that are run. Possible values are:LOG_CL_PROGRAMS_YES
- Commands are logged for CL programs that are run.LOG_CL_PROGRAMS_NO
- Commands are not logged for CL programs that are run.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
LOG_CL_PROGRAMS
-
setLoggingLevel
public void setLoggingLevel(int loggingLevel) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets what type of information is logged.- Parameters:
loggingLevel
- A value indicating what type of information is logged. Possible values are:- 0 - No messages are logged.
- 1 - All messages sent to the job's external message queue with a severity greater than or equal to the message logging severity are logged. This includes the indication of job start, job end, and job completion status.
- 2 - The following information is logged:
- Logging level 1 information.
- Request messages that result in a high-level message with a severity code greater than or equal to the logging severity cause the request message and all associated messages to be logged. A high-level message is one that is sent to the program message queue of the program that receives the request message. For example, QCMD is an IBM-supplied request processing program that receives request messages.
- 3 - The following information is logged:
- Logging level 1 and 2 information is logged.
- All request messages are logged.
- Commands run by a CL program are logged if it is allowed by the LOG_CL_PROGRAMS attribute and the log attribute of the CL program.
- 4 - The following information is logged:
- All request messages and all messages with a severity greater than or equal to the message logging severity, including trace messages.
- Commands run by a CL program are logged if it is allowed by the LOG_CL_PROGRAMS attribute and the log attribute of the CL program.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
LOGGING_LEVEL
-
setLoggingSeverity
public void setLoggingSeverity(int loggingSeverity) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets the severity level that is used in conjunction with the logging level to determine which error messages are logged in the job log. The values range from 00 through 99.- Parameters:
loggingSeverity
- The severity level that is used in conjunction with the logging level to determine which error messages are logged in the job log.- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
LOGGING_SEVERITY
-
setLoggingText
public void setLoggingText(java.lang.String loggingText) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets the level of message text that is written in the job log when a message is logged according to the LOGGING_LEVEL and LOGGING_SEVERITY.- Parameters:
loggingText
- The level of message text that is written in the job log when a message is logged according to the LOGGING_LEVEL and LOGGING_SEVERITY. Possible values are:LOGGING_TEXT_MESSAGE
- Only the message text is written to the job log.LOGGING_TEXT_SECLVL
- Both the message text and the message help (cause and recovery) of the error message are written to the job log.LOGGING_TEXT_NO_LIST
- If the job ends normally, no job log is produced. If the job ends abnormally (the job end code is 20 or higher), a job log is produced. The messages that appear in the job log contain both the message text and the message.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
LOGGING_TEXT
-
setName
public void setName(java.lang.String name) throws java.beans.PropertyVetoException
Sets the job name. This does not change the name of the actual server job. Instead, it changes the job this Job object references. This cannot be changed if the object has already established a connection to the system.- Parameters:
name
- The job name. Specify JOB_NAME_CURRENT to indicate the job this program running in, or JOB_NAME_INTERNAL to indicate that the job is specified using the internal job identifier.- Throws:
java.beans.PropertyVetoException
- If the property change is vetoed.
-
setNumber
public void setNumber(java.lang.String number) throws java.beans.PropertyVetoException
Sets the job number. This does not change the name of the actual server job. Instead, it changes the job this Job object references. This cannot be changed if the object has already established a connection to the system.- Parameters:
number
- The job number. This must be JOB_NUMBER_BLANK if the job name is JOB_NAME_CURRENT.- Throws:
java.beans.PropertyVetoException
- If the property change is vetoed.
-
setOutputQueue
public void setOutputQueue(java.lang.String outputQueue) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets the fully qualified integrated file system path name of the default output queue that is used for spooled output produced by this job. The default output queue is only for spooled printer files that specify *JOB for the output queue.- Parameters:
outputQueue
- The fully qualified integrated file system path name of the default output queue that is used for spooled output produced by this job. Possible values are:OUTPUT_QUEUE_DEVICE
- The device specified on the Create Printer File (CRTPRTF), Change Printer File (CHGPRTF), or Override with Printer File (OVRPRTF) commands is used.OUTPUT_QUEUE_WORK_STATION
- The default output queue that is used with this job is the output queue that is assigned to the work station associated with the job at the time the job is started.OUTPUT_QUEUE_INITIAL_USER
- The output queue name specified in the user profile under which this thread was initially running is used.- The fully qualified integrated file system path name of the output queue.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
OUTPUT_QUEUE
,QSYSObjectPathName
-
setOutputQueuePriority
public void setOutputQueuePriority(int outputQueuePriority) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets the output priority for spooled output files that this job produces. The highest priority is 0, and the lowest is 9.- Parameters:
outputQueuePriority
- The output priority for spooled output files that this job produces. The valid values are a range from 1 to 9. The output priority specified cannot be higher than the priority specified in the user profile under which the job is running.- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
OUTPUT_QUEUE_PRIORITY
-
setPrinterDeviceName
public void setPrinterDeviceName(java.lang.String printerDeviceName) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets the printer device used for printing output from this job.- Parameters:
printerDeviceName
- The printer device used for printing output from this job. ssible values are:PRINTER_DEVICE_NAME_SYSTEM_VALUE
- The value in the system value QPRTDEV is used as the printer device.PRINTER_DEVICE_NAME_WORK_STATION
- The default printer device used with this job is the printer device assigned to the work station that is associated with the job.PRINTER_DEVICE_NAME_INITIAL_USER
- The printer device name specified in the user profile under which this thread was initially running is used.- The name of the printer device that is used with this job.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
PRINTER_DEVICE_NAME
-
setPrintKeyFormat
public void setPrintKeyFormat(java.lang.String printKeyFormat) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets whether border and header information is provided when the Print key is pressed.- Parameters:
printKeyFormat
- Whether border and header information is provided when the Print key is pressed. Possible values are:PRINT_KEY_FORMAT_SYSTEM_VALUE
- The value specified on the system value QPRTKEYFMT determines whether header or border information is printed.PRINT_KEY_FORMAT_NONE
- The border and header information is not included with output from the Print key.PRINT_KEY_FORMAT_BORDER
- The border information is included with output from the Print key.PRINT_KEY_FORMAT_HEADER
- The header information is included with output from the Print key.PRINT_KEY_FORMAT_ALL
- The border and header information is included with output from the Print key.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
PRINT_KEY_FORMAT
-
setPrintText
public void setPrintText(java.lang.String printText) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets the line of text (if any) that is printed at the bottom of each page of printed output for the job.- Parameters:
printText
- The line of text (if any) that is printed at the bottom of each page of printed output for the job. Possible values are:PRINT_TEXT_SYSTEM_VALUE
- The system value QPRTTXT is used.PRINT_TEXT_BLANK
- No text is printed on printed output.- The character string that is printed at the bottom of each page. A maximum of 30 characters can be entered.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
PRINT_TEXT
-
setPurge
public void setPurge(boolean purge) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets the value indicating whether or not the job is eligible to be moved out of main storage and put into auxiliary storage at the end of a time slice or when entering a long wait (such as waiting for a work station user's response). This attribute is ignored when more than one thread is active within the job. If the job consists of multiple routing steps, a change to this attribute during a routing step does not apply to subsequent routing steps.- Parameters:
purge
- true to indicate that the job is eligible to be moved out of main storage and put into auxiliary storage at the end of a time slice or when entering a long wait; false otherwise.- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
ELIGIBLE_FOR_PURGE
-
setQueue
public void setQueue(java.lang.String jobQueue) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets the fully qualified integrated file system path name of the job queue that the job is to be on. This value is valid for jobs whose status is *JOBQ. For jobs with a status of *OUTQ or *ACTIVE, an error will be signaled.- Parameters:
jobQueue
- The fully qualified integrated file system path name of the job queue that the job is to be on.- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
JOB_QUEUE
,QSYSObjectPathName
-
setQueuePriority
public void setQueuePriority(int queuePriority) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets the scheduling priority of the job compared to other jobs on the same job queue. The highest priority is 0 and the lowest is 9. This value is valid for jobs whose status is *JOBQ or *ACTIVE. For jobs with a status of *OUTQ, an error will be signaled.- Parameters:
queuePriority
- The scheduling priority of the job compared to other jobs on the same job queue.- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
JOB_QUEUE_PRIORITY
-
setRunPriority
public void setRunPriority(int runPriority) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets the priority at which the job competes for the processing unit relative to the other jobs that are active at the same time. The run priority ranges from 1 (highest priority) to 99 (lowest priority). This value represents the relative (not absolute) importance of the job or thread. For example, a run priority of 25 is not twice as important as a run priority of 50. If the job consists of multiple routing steps, a change to this attribute during a routing step does not apply to subsequent routing steps.- Parameters:
runPriority
- The run priority of the job is changed. The range of values is 1 (highest priority) to 99 (lowest priority). The value may never be higher than the run priority for the job in which the thread is running. If a priority higher than the job's is entered, an error is returned. Changing the run priority of the job affects the run priorities of all threads within the job. For example, the job is running at priority 10, thread A within the job is running at priority 10, and thread B within the job is running at priority 15. The priority of the job is changed to 20. The priority of thread A would then be adjusted to 20 and the priority of thread B would be adjusted to 25.- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
RUN_PRIORITY
-
setScheduleDate
public void setScheduleDate(java.util.Date scheduleDate) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets the date and time the job is scheduled to become active.- Parameters:
scheduleDate
- The date and time the job is scheduled to become active.- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
SCHEDULE_DATE
-
setScheduleDate
public void setScheduleDate(java.lang.String scheduleDate) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets the date the job is scheduled to become active.- Parameters:
scheduleDate
- The date the job is scheduled to become active, in the format CYYMMDD, where C is the century, YY is the year, MM is the month, and DD is the day. A 0 for the century flag indicates years 19xx and a 1 indicates years 20xx.- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
SCHEDULE_DATE
-
setScheduleTime
public void setScheduleTime(java.util.Date scheduleTime) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets the date and time the job is scheduled to become active.- Parameters:
scheduleTime
- The date and time the job is scheduled to become active.- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
SCHEDULE_DATE
-
setScheduleTime
public void setScheduleTime(java.lang.String scheduleTime) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets the time the job is scheduled to become active.- Parameters:
scheduleTime
- The time the job is scheduled to become active, in the format HHMMSS, where HH are the hours, MM are the minutes, and SS are the seconds.- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
SCHEDULE_DATE
-
setSortSequenceTable
public void setSortSequenceTable(java.lang.String sortSequenceTable) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets the name of the sort sequence table associated with this job..- Parameters:
sortSequenceTable
- The name of the sort sequence table associated with this job. Possible values are:SORT_SEQUENCE_TABLE_SYSTEM_VALUE
- The system value QSRTSEQ is used.SORT_SEQUENCE_TABLE_INITIAL_USER
- The sort sequence table specified in the user profile under which this thread was initially running is used.SORT_SEQUENCE_TABLE_NONE
- No sort sequence table is used. The hexadecimal values of the characters are used to determine the sort sequence.SORT_SEQUENCE_TABLE_LANGUAGE_SHARED_WEIGHT
- The sort sequence table used can contain the same weight for multiple characters, and it is the shared weight sort table associated with the language specified in the LANGUAGE_ID attribute.SORT_SEQUENCE_TABLE_LANGUAGE_UNIQUE_WEIGHT
- The sort sequence table used must contain a unique weight for each character in the code page, and it is the unique weight sort table associated with the language specified in the LANGUAGE_ID parameter.- The fully qualified integrated file system path name of the sort sequence table associated with this job.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
SORT_SEQUENCE_TABLE
,QSYSObjectPathName
-
setStatusMessageHandling
public void setStatusMessageHandling(java.lang.String statusMessageHandling) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets the value which indicates whether status messages are displayed for this job.- Parameters:
statusMessageHandling
- The value which indicates whether status messages are displayed for this job. Possible values are:STATUS_MESSAGE_HANDLING_SYSTEM_VALUE
- The system value QSTSMSG is used.STATUS_MESSAGE_HANDLING_INITIAL_USER
- The status message handling that is specified in the user profile under which this thread was initially running is used.STATUS_MESSAGE_HANDLING_NONE
- This job does not display status messages.STATUS_MESSAGE_HANDLING_NORMAL
- This job displays status messages.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
STATUS_MESSAGE_HANDLING
-
setSystem
public void setSystem(AS400 system) throws java.beans.PropertyVetoException
Sets the system. This cannot be changed if the object has established a connection to the system.- Parameters:
system
- The system.- Throws:
java.beans.PropertyVetoException
- If the property change is vetoed.
-
setTimeSeparator
public void setTimeSeparator(java.lang.String timeSeparator) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets the value used to separate hours, minutes, and seconds when presenting a time.- Parameters:
timeSeparator
- The value used to separate hours, minutes, and seconds when presenting a time. Possible values are:TIME_SEPARATOR_SYSTEM_VALUE
- The time separator specified in the system value QTIMSEP is used.TIME_SEPARATOR_COLON
- A colon (:) is used for the time separator.TIME_SEPARATOR_PERIOD
- A period (.) is used for the time separator.TIME_SEPARATOR_BLANK
- A blank is used for the time separator.TIME_SEPARATOR_COMMA
- A comma (,) is used for the time separator.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
TIME_SEPARATOR
-
setTimeSlice
public void setTimeSlice(int timeSlice) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets the maximum amount of processor time (in milliseconds) given to each thread in this job before other threads in this job and in other jobs are given the opportunity to run. The time slice establishes the amount of time needed by a thread in this job to accomplish a meaningful amount of processing. At the end of the time slice, the thread might be put in an inactive state so that other threads can become active in the storage pool. If the job consists of multiple routing steps, a change to this attribute during a routing step does not apply to subsequent routing steps. Valid values range from 1 through 9,999,999 milliseconds (that is, 9999.999 seconds). Although you can specify a value of less than 8, the system takes a minimum of 8 milliseconds to run a process. If you display a job's run attributes, the time slice value is never less than 8.- Parameters:
timeSlice
- The maximum amount of processor time (in milliseconds) given to each thread in this job before other threads in this job and in other jobs are given the opportunity to run.- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
TIME_SLICE
-
setTimeSliceEndPool
public void setTimeSliceEndPool(java.lang.String timeSliceEndPool) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets the value which indicates whether a thread in an interactive job moves to another main storage pool at the end of its time slice.- Parameters:
timeSliceEndPool
- The value which indicates whether a thread in an interactive job moves to another main storage pool at the end of its time slice. Possible values are:TIME_SLICE_END_POOL_SYSTEM_VALUE
- The value in the system value QTSEPPOOL is used.TIME_SLICE_END_POOL_NONE
- A thread in the job does not move to another main storage pool when it reaches the end of its time slice.TIME_SLICE_END_POOL_BASE
- A thread in the job moves to the base pool when it reaches the end of its time slice.
- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
TIME_SLICE_END_POOL
-
setUser
public void setUser(java.lang.String user) throws java.beans.PropertyVetoException
Sets the user name. This does not change the name of the actual server job. Instead, it changes the job this Job object references. This cannot be changed if the object has already established a connection to the system.- Parameters:
user
- The user name. This must be USER_NAME_BLANK if the job name is JOB_NAME_CURRENT.- Throws:
java.beans.PropertyVetoException
- If the property change is vetoed.- See Also:
getUser()
-
setValue
public void setValue(int attribute, java.lang.Object value) throws AS400SecurityException, ErrorCompletingRequestException, java.lang.InterruptedException, java.io.IOException, ObjectDoesNotExistException
Sets a value for a job attribute. If caching is off, the value is immediately sent to the system. If caching is on, callcommitChanges()
to send the uncommitted values to the system.- Parameters:
attribute
- The job attribute to change.value
- The new value of the attribute.- Throws:
AS400SecurityException
- If a security or authority error occurs.ErrorCompletingRequestException
- If an error occurs before the request is completed.java.lang.InterruptedException
- If this thread is interrupted.java.io.IOException
- If an error occurs while communicating with the system.ObjectDoesNotExistException
- If the object does not exist on the system.- See Also:
commitChanges()
,getValue(int)
-
toString
public java.lang.String toString()
Returns the string representation of this Job in the format "number/user/name", or "" if any of these attributes is null.- Overrides:
toString
in classjava.lang.Object
- Returns:
- The string representation.
-