Hitachi

JP1 Version 11 JP1/Automatic Job Management System 3 Command Reference


7.3.2 Status information object

This object indicates the status information of the unit.

For details about whether the API can acquire the status information object, see D.3 List of members of the status information object that can be acquired by the API.

Format
{
  "unitName":"unit-full-path-name",
  "execID":"execution-ID",
  "status":"status",
  "schStartTime":"scheduled-start-time",
  "startTime":"start-time",
  "reStartTime":"rerun-start-time",
  "endTime":"end-time",
  "startDelayStatus":"whether-the-start-delayed",
  "nestStartDelayStatus":"whether-the-start-delayed-under-the-unit",
  "endDelayStatus":"whether-the-end-delayed",
  "nestEndDelayStatus":"whether-the-end-delayed-under-the-unit",
  "startDelayTime":"time-when-start-delayed",
  "endDelayTime":"time-when-end-delayed",
  "changeType":"whether-the-plan-has-changed",
  "holdAttr":"hold-attribute",
  "registerTime":"time-when-job-registered",
  "jobNumber":job-number,
  "retCode":"return-code",
  "execHost":"execution-host-name",
  "simpleUnitName":"unit-name",
  "delayedStart":"start-delay-monitoring-method",
  "delayedStartTime":"time-to-start-monitoring-of-start-delay",
  "delayedEnd":"end-delay-monitoring-method",
  "delayedEndTime":"time-to-start-monitoring-of-end-delay",
  "monitoringJobnet":"end-delay-monitoring-method-using-the-time-required-to-execute-jobnet",
  "timeRequiredForExecution":"time-required-to-execute-jobnet"
}
Member

The following table lists and describes the members to be returned.

Table 7‒23: List of members of the status information object

Member

Data type

Description

unitName

string

Returns the full name of the unit, by using a character string in the range from 1 to 930 bytes. If information cannot be acquired, a character string of 0 bytes is returned.

execID

string

Returns the execution ID in the format of @[mmmm]{A to Z}nnnn (for example, @10A200).

If information cannot be acquired, a character string of 0 bytes is returned.

status

string

Returns the unit status, by using a character string constant specified for the Status constant. For details about the Status constant, see 7.4.5(1) Status.

If information cannot be acquired, NONE (not applicable) is returned.

schStartTime

string

Returns the scheduled start time. For the scheduled start time, the time (unit: second) passed from Jan 1, 1970, 00:00:00 is converted to the following ISO 8601 format:

YYYY-MM-DDThh:mm:ssTZD

For details about the ISO 8601 format, see 6.3 Data types usable for an API.

If information cannot be acquired, a character string of 0 bytes is returned.

startTime

string

Returns the start date. For the start date, the time (unit: second) passed from Jan 1, 1970, 00:00:00 is converted to the following ISO 8601 format:

YYYY-MM-DDThh:mm:ssTZD

For details about the ISO 8601 format, see 6.3 Data types usable for an API.

If information cannot be acquired, a character string of 0 bytes is returned.

reStartTime

string

Returns the return start time. For the return start time, the time (unit: second) passed from Jan 1, 1970, 00:00:00 is converted to the following ISO 8601 format:

YYYY-MM-DDThh:mm:ssTZD

For details about the ISO 8601 format, see 6.3 Data types usable for an API.

If information cannot be acquired, a character string of 0 bytes is returned.

endTime

string

Returns the end time. For the end time, the time (unit: second) passed from Jan 1, 1970, 00:00:00 is converted to the following ISO 8601 format:

YYYY-MM-DDThh:mm:ssTZD

For details about the ISO 8601 format, see 6.3 Data types usable for an API.

If information cannot be acquired, a character string of 0 bytes is returned.

startDelayStatus

string

Returns whether the start delay occurred for this unit, by using a character string constant specified for the DelayStart constant. For details about the DelayStart constant, see 7.4.5(2) DelayStart.

If information cannot be acquired, NONE (not applicable) is returned.

nestStartDelayStatus

string

Returns whether the start delay occurred under this unit, by using a character string constant specified for the DelayStart constant. For details about the DelayStart constant, see 7.4.5(2) DelayStart.

If information cannot be acquired, NONE (not applicable) is returned.

endDelayStatus

string

Returns whether the end delay occurred for this unit, by using a character string constant specified for the Delayend constant. For details about the DelayEnd constant, see 7.4.5(3) DelayEnd.

If information cannot be acquired, NONE (not applicable) is returned.

nestEndDelayStatus

string

Returns whether the end delay occurred under this unit, by using a character string constant specified for the Delayend constant. For details about the DelayEnd constant, see 7.4.5(3) DelayEnd.

If information cannot be acquired, NONE (not applicable) is returned.

startDelayTime

string

Returns the time when start delayed. For the time when start delayed, the time (unit: second) passed from Jan 1, 1970, 00:00:00 is converted to the following ISO 8601 format:

YYYY-MM-DDThh:mm:ssTZD

For details about the ISO 8601 format, see 6.3 Data types usable for an API.

If information cannot be acquired, a character string of 0 bytes is returned.

endDelayTime

string

Returns the time when end delayed. For the time when end delayed, the time (unit: second) passed from Jan 1, 1970, 00:00:00 is converted to the following ISO 8601 format:

YYYY-MM-DDThh:mm:ssTZD

For details about the ISO 8601 format, see 6.3 Data types usable for an API.

If information cannot be acquired, a character string of 0 bytes is returned.

changeType

string

Returns whether the plan has been changed, by using a character string constant specified for the ChangeType constant. For details about the ChangeType constant, see 7.4.5(4) ChangeType.

If information cannot be acquired, NONE (not applicable) is returned.

holdAttr

string

Returns the hold attribute, by using a character string constant specified for the HoldAttr constant. For details about the HoldAttr constant, see 7.4.5(5) HoldAttr.

If information cannot be acquired, NONE (not applicable) is returned.

registerTime

string

Returns the time when the job registered. For the time when the job registered, the time (unit: second) passed from Jan 1, 1970, 00:00:00 is converted to the following ISO 8601 format:

YYYY-MM-DDThh:mm:ssTZD

For details about the ISO 8601 format, see 6.3 Data types usable for an API.

If information cannot be acquired, a character string of 0 bytes is returned.

jobNumber

int

Returns the job number.

If information cannot be acquired, or if the unit has no information, -1 is returned.

retCode

string

Returns the end code, by using a character string.

If information cannot be acquired, or if the unit has no information, a character string of 0 bytes is returned.

execHost

string

Returns the execution host name, by using a character string in the range from 0 to 255 bytes.

If information cannot be acquired, or if the unit has not started, a character string of 0 bytes is returned.

simpleUnitName

string

Returns the unit name, by using a character string in the range from 1 to 30 bytes. If information cannot be acquired, a character string of 0 bytes is returned.

delayedStart

string

Returns the method of monitoring start delays by using a character string defined in the DelayMonitor constant.

If information cannot be acquired, NONE (not applicable) is returned. For details about the DelayMonitor constant, see 7.4.5(7) DelayMonitor.

delayedStartTime

string

Returns the time to start monitoring start delays.

The time is returned as follows, with the DelayMonitor constant acquired by the delayedStart member:

  • If the DelayMonitor constant is ABSOLUTE

    This member returns the time to start monitoring of start delays in hh:mm format.

    hh: A value from 00 to 47 (hours)

    mm: A value from 00 to 59 (minutes)

  • If the DelayMonitor constant is ROOT, TOP, or OWN

    This member returns the relative time (in minutes) to start monitoring of start delays in the range from 1 to 2879.

  • If the DelayMonitor constant is other than ABSOLUTE, ROOT, TOP, and OWN, a character string of 0 bytes is returned.

delayedEnd

string

Returns the method of monitoring end delays by using a character string defined in the DelayMonitor constant.

If information cannot be acquired, NONE (not applicable) is returned. For details about the DelayMonitor constant, see 7.4.5(7) DelayMonitor.

delayedEndTime

string

Returns the time to start monitoring of end delays.

The time is returned as follows, with the DelayMonitor constant acquired by the delayedEnd member:

  • If the DelayMonitor constant is ABSOLUTE

    This member returns the time to start monitoring of end delays in hh:mm format.

    hh: A value from 00 to 47 (hours)

    mm: A value from 00 to 59 (minutes)

  • If the DelayMonitor constant is ROOT, TOP, or OWN

    This member returns the relative time (in minutes) to start monitoring of end delays in the range from 1 to 2879.

  • If the DelayMonitor constant is other than ABSOLUTE, ROOT, TOP, and OWN, a character string of 0 bytes is returned.

monitoringJobnet

string

Returns the method of monitoring end delays based on the time required for jobnet execution by using a character string defined in the MonitoringJobnet constant.

If information cannot be acquired, NONE (not applicable) is returned.

For details about the MonitoringJobnet constant, see 7.4.5(8) MonitoringJobnet.

timeRequiredForExecution

string

Returns the time required for jobnet execution.

The time is returned as follows, with the MonitoringJobnet constant acquired by the monitoringJobnet member:

  • If the MonitoringJobnet constant is TIME_REQUIRED_FOR_EXECUTION_YES, this member returns the time required for jobnet execution (in minutes) in the range from 1 to 2879.

  • If the MonitoringJobnet constant is other than TIME_REQUIRED_FOR_EXECUTION_YES, a character string of 0 bytes is returned.

  • When information cannot be acquired, a character string of 0 bytes is returned.