z/OS Common Information Model User's Guide
Previous topic | Next topic | Contents | Index | Contact z/OS | Library | PDF


IBMzOS_JES2Job

z/OS Common Information Model User's Guide
SC34-2671-00

IBMzOS_JES2Job

Purpose

This class is a subclass of IBMzOS_Job and contains those properties that are unique to a job that has run, or will run, under JES2.

Inheritance

  • IBMzOS_Job
  • ← IBMzOS_JES2Job

Module name

The module name of the CMPI provider that is registered for a CIM class which is used by the cimprovider command line tool for the administration of CMPI providers is

  • IBMzOS_JES2JobProviderModule

Provider library

The physical name of a CMPI provider’s shared object library as it is stored in the hierarchical file system is

  • libcmpiIBMzOS_JES2JobProvider.so

Properties

The following properties have been implemented for z/OS®:

string Caption
A short description of the class. Returns ‘IBM z/OS JES2 Job’.
string Description
A description of the class. Returns ‘This is an IBMzOS_JES2Job’.
string ElementName
Name given to this instance of the class (same as Name)
datetime InstallDate

Not supported for z/OS.

string Name [key]

The property is overridden by IBMzOS_JES2Job. It contains a unique identifier for this job.

uint16 OperationalStatus[]
The current status of the JES2 job.
1
No subchain exists
2
Active in CI in FSS address space
3
Awaiting postscan (batch)
4
Awaiting postscan (damsel)
5
Awaiting volume fetch
6
Awaiting start setup (JES3), Awaiting setup (JES2)
7
Awaiting/active in MDS system select processing
8
Awaiting resource allocation
9
Awaiting unavailable volumes
10
Awaiting volume mounts
11
Awaiting/active in MDS system verify processing
12
Error during MDS processing
13
Awaiting selection on main (JES3), Awaiting execution (JES2)
14
Scheduled on main (JES3), Active executing (JES2)
17
Awaiting breakdown (JES3), Active in output (JES2)
18
Awaiting MDS restart processing
19
Main MDS processing complete
20
Awaiting output service (JES3), Awaiting hardcopy (JES2)
21
Awaiting output service writer
22
Awaiting reserved services
23
Output service complete
24
Awaiting selection on main (demand select job)
25
Ending function rq waiting or I/O completion
26
Ending function rq not processed
27
Maximum rq index value
128
Active in input processing
129
Awaiting conversion
130
Active in conversion
131
Active in setup
132
Active in spin
133
Awaiting output
134
Awaiting purge
135
Active in purge
136
Active on NJE sysout received
137
Awaiting NJE transmission
138
Active on NJE job transmitter
string StatusDescriptions[]
Strings describing the various OperationalStatus values. Returns NULL.
string Status

Not supported for z/OS.

string JobStatus
A free form string containing information about the job.

The primary job status is reflected in OperationalStatus. JobStatus provides additional implementation-specific details.

datetime TimeSubmitted
The time that the Job was submitted to execute.

A value of all zeros indicates that the owning element is not capable of reporting a date and time. Therefore, the ScheduledStartTime and StartTime are reported as intervals relative to the time their values are required.

datetime ScheduledStartTime
Not supported for z/OS.
datetime StartTime
The time that the Job was actually started.

This may be represented by an actual date and time, or by an interval relative to the time that this property is requested.

Note that this property is also present in the JobProcessingStatistics class. This is necessary to capture the processing information for recurring Jobs, since only the ‘last’ run time can be stored in this single-valued property.

datetime ElapsedTime
The time interval that the Job has been executing or the total execution time if the Job is complete.

Note that this property is also present in the JobProcessingStatistics class. This is necessary to capture the processing information for recurring Jobs, since only the ‘last’ run time can be stored in this single-valued property.

uint32 JobRunTimes
Number of times that the Job should be run.

A value of 1 indicates that the Job is NOT recurring, while any non-zero value indicates a limit to the number of time that the Job will recur.

Zero indicates that there is no limit to the number of times that the Job can be processed, but that it is terminated either AFTER the UntilTime, or by manual intervention.

By default, a job is processed once.

This property is not modifiable.

uint8 RunMonth
Not supported for z/OS.
sint8 RunDay
Not supported for z/OS.
sint8 RunDayOfWeek
Not supported for z/OS.
datetime RunStartInterval
The time interval after midnight when the Job should be processed.

For example, 00000000020000.000000:000 indicates that the Job should be run on or after two o'clock, local time of UTC time (distinguished using the LocalOrUtcTime property).

This property is not modifiable.

uint16 LocalOrUtcTime
This property indicates whether the time represented in the RunStartInterval and UntilTime properties represent local or UTC times.

Time values are synchronized worldwide by using the enumeration value 2, "UTC Time". Permitted values are:

1
Local time
2
UTC time

This property is not modifiable.

datetime UntilTime
The time after which the Job is invalid or should be stopped.

This may be represented by an actual date and time, or by an interval relative to the time that this property is requested.

A value of all nines indicates that the Job can run indefinitely.

This property is not modifiable.

string Notify
User to be notified upon the Job completion or failure.

This property can be modified using the RequestPropertyChange() method.

string Owner
The User that submitted the Job or the Service/method name/etc. that caused the job to be created.
uint32 Priority
Indicates the urgency or importance of execution of the Job.

The lower the number, the higher the priority.

Note that this property is also present in the JobProcessingStatistics class. This is necessary to capture the setting information that would influence a Job's results.

This property can be modified using the RequestPropertyChange() method.

uint16 PercentComplete
Not supported for z/OS.
boolean DeleteOnCompletion
Indicates whether or not the Job should be automatically deleted upon completion.

Note that the 'completion' of a recurring Job is defined by its JobRunTimes or UntilTime properties, OR when the Job is terminated by manual intervention.

If this property is set to false and the Job completes, then the extrinsic method DeleteInstance MUST be used to delete the Job versus updating this property.

This property is not modifiable.

uint16 ErrorCode
Not supported for z/OS.
string ErrorDescription
Not supported for z/OS.
uint16 RecoveryAction
Not supported for z/OS.
string OtherRecoveryAction
Not supported for z/OS.
string AbendCode
Job completed with abend code.
string AccountNumber
Account number from job card.
boolean ARMRegistered
Job is ARM registered indicator.
string AvailableSchedEnvSystem []
System names onwhich the scheduling environment required by job is available. Only valid if job requires a scheduling environment and that environment is available on at least one system.
string AvailableSeclabelSystems []
System names on which the seclabel associated with the job is available. Only valid if seclabel by system is active in the security product and the seclabel is available on at least on system.
boolean AwaitingARMRestart
Job awaiting ARM restart indicator.
string Building
NJE building.

This property is "Expensive".

uint32 CardCount
Card (output) count.
string Class
Job class.

This property can be modified using the RequestPropertyChange() method.

uint32 CompletionCode
Completion code (set for conditions marked with + in job completion indicator).
uint8 CompletionType
Specific completion type:
0
No completion info
1
Job ended normally
2
Job ended by CC
3
JCL error
4
Canceled
5
Abended
6
Converter abended
7
Security error
8
Job failed in EOM
uint16 CopyCount
Job copy count.

This property is "Expensive".

string CSName
The scoping Computer System.
string DefaultPrintDest
Default print destination.

This property can be modified using the RequestPropertyChange() method.

string DefaultPunchDest
Default punch destination.

This property can be modified using the RequestPropertyChange() method.

string Department
NJE department.

This property is "Expensive".

string Device
Name of device job is active on.
uint32 EstimatedTimeToExecution
Estimated time to execution in seconds.

This field is only available if the job is awaiting execution, job is scheduled to run to a WLM managed class, job is not held (duplicate job name, operator hold, etc.), member it has affinity to is available, and the scheduling environment is available.

datetime ExecutionEndTime
Execution end time and date.

This property is "Expensive".

string ExecutionMember
Execution JES2 member name.

This property is "Expensive".

string ExecutionNode
Execution node.

This property can be modified using the RequestPropertyChange() method.

datetime ExecutionStartTime
Execution start time and date.

This property is "Expensive".

string ExecutionSystem
Execution MVS™ system name.

This property is "Expensive".

uint8 HoldIndicator
Job hold indicator:
1
Not held
2
Held
3
Held for duplicate job name
uint32 InputCount
Job input count.

This property is "Expensive".

string InputDevice
Input device name.

This property is "Expensive".

datetime InputStartTime
Input start time and date.

This property is "Expensive".

string InputSystem
Input system or member.
boolean JesLogSpinnable
Jeslog spinnable indicator.
boolean JobClassModeWLM
Job class mode for job. If true, mode is WLM, otherwise mode is JES.
string JobID
Job identifier.
boolean JobIsActive
Indicate job is executing.
string JobName
Job name.
uint8 JobType
Job type:
1
Started task (STC)
2
Time sharing user (TSU)
3
Batch job (JOB)
4
APPC indicator
uint32 LineCount
Line count.

This property is "Expensive".

string MemberName
JES2 member on which the job is active.
string MessageClass
Message class from job card.
string NotifyNode
Notify node.

This property is "Expensive".

string OriginalJobID
Original job identifier.
string OriginNode
Original node (node of submittal).
string OSName
The scoping Operating System’s name.
uint32 PageCount
Job page count.

This property is "Expensive".

uint8 Phase
Phase job is in:
1
No subchain exists
2
Active in CI in FSS address space
3
Awaiting postscan (batch)
4
Awaiting postscan (damsel)
5
Awaiting volume fetch
6
Awaiting start setup (JES3), Awaiting setup (JES2)
7
Awaiting/active in MDS system select processing
8
Awaiting resource allocation
9
Awaiting unavailable volumes
10
Awaiting volume mounts
11
Awaiting/active in MDS system verify processing
12
Error during MDS processing
13
Awaiting selection on main (JES3), Awaiting execution (JES2)
14
Scheduled on main (JES3), Active executing (JES2)
17
Awaiting breakdown (JES3), Active in output (JES2)
18
Awaiting MDS restart processing
19
Main MDS processing complete
20
Awaiting output service (JES3), Awaiting hardcopy (JES2)
21
Awaiting output service writer
22
Awaiting reserved services
23
Output service complete
24
Awaiting selection on main (demand select job)
25
Ending function rq waiting or I/O completion
26
Ending function rq not processed
27
Maximum rq index value
128
Active in input processing
129
Awaiting conversion
130
Active in conversion
131
Active in setup
132
Active in spin
133
Awaiting output
134
Awaiting purge
135
Active in purge
136
Active on NJE sysout received
137
Awaiting NJE transmission
138
Active on NJE job transmitter
string ProgrammerName
Programmer name from job card.
string RoomNumber
Job card room number.
string Seclabel
Seclabel from job.
boolean Spin
Indicator of whether jobs in the job class can be spun.
string Subsystem
Subsystem name.
string SystemName
MVS system name on which the job is active.
uint32 WLMActiveJobCount
Number of active jobs in this WLM service class.
uint32 WLMJobsOnQueueCount
Number of jobs on WLM service class queue.
uint32 WLMPosition
Position of this job on WLM service class queue.
uint32 WLMSchedulingEnvironment
WLM scheduling environment.

This property can be modified using the RequestPropertyChange() method.

string WLMServiceClass
WLM service class.

This property can be modified using the RequestPropertyChange() method.

string PercentSpoolUtilization
Percent of spool Used by the following CIM profiles the job.
boolean ConverterWait
Job can be converted only by CNVT PCEs that can wait for OS
boolean Independent
Job is set to independent mode.
uint32 JobKey
Job key
boolean JobNotRunReasonJobBusyOnDevice
Job not running because job busy on device
boolean JobNotRunReasonJobClassHeld
Job not running because job class held
boolean JobNotRunReasonJobClassLimitReached
Job not running because job class limit reached
boolean JobNotRunReasonNoSystem
Job not running because no system with right combination of resources
boolean JobNotRunReasonSchedulingEnvironment
Job not running due to unavailable scheduling environment
boolean JobNotRunReasonSeclabelAffinity
Job not running because of seclabel affinity
boolean JobNotRunReasonSpoolNotAvailable
Job not running because spools not available
boolean JobNotRunReasonSystemAffinity
Job not running due to system affinity
boolean Protected
Job is protected
uint32 SpoolDataToken
Spool data token
string SystemAffinity []
System affinity for job
boolean SystemDataSet
Job represents a system data set
uint32 TrackGroupCount
Number of track groups of spool space used by this job

Methods

MethodDescription
sint32 Hold()Holds a job.
ParametersDescription
[IN] datetime TimeoutPeriodSpecifies the maximum amount of time that the client expects the transition to the new state to take.
[OUT] ResponseText[]Command response messages.
[OUT] sint32 ReasonCodeReason code referencing CEA errors.
sint32 Release()Releases a job.
ParametersDescription
[IN] datetime TimeoutPeriodSpecifies the maximum amount of time that the client expects the transition to the new state to take.
[OUT] string ResponseText[]Command response messages.
[OUT] sint32 ReasonCodeReason code referencing CEA errors.
sint32 ReleaseOutput()Releases output for a job.
ParametersDescription
[IN] datetime TimeoutPeriodSpecifies the maximum amount of time that the client expects the transition to the new state to take.
[OUT] string ResponseText[]Command response messages.
[OUT] sint32 ReasonCodeReason code referencing CEA errors.
sint32 RequestPropertyChange()Changes a property and returns response messages from the generated command.
ParametersDescription
[IN] string PropertyNameThe property to be changed.
[IN] string PropertyValueThe new value for the property.
[IN] datetime TimeoutPeriodSpecifies the maximum amount of time that the client expects the transition to the new state to take.
[OUT] string ResponseText[]Command response messages.
[OUT] sint32 ReasonCodeReason code referencing CEA errors.
sint32 Restart()Restarts a job.
ParametersDescription
[IN] boolean HoldIndicates if the job should be held prior to its execution.
[IN] datetime TimeoutPeriodSpecifies the maximum amount of time that the client expects the transition to the new state to take.
[OUT] string ResponseText[]Command response messages.
[OUT] sint32 ReasonCodeReason code referencing CEA errors.
sint32 Cancel()Cancels a job.
ParametersDescription
[IN] boolean PurgeOutputIndicates if any output associated with the job is to be cancelled.
[IN] boolean TakeDumpIndicates if a dump should be taken when the job is canceled.
[IN] datetime TimeoutPeriodSpecifies the maximum amount of time that the client expects the transition to the new state to take.
[OUT] string ResponseText[]Command response messages.
[OUT] sint32 ReasonCodeReason code referencing CEA errors.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014