Hitachi

JP1 Version 12 JP1/Automatic Job Management System 3 System Design (Work Tasks) Guide


A. Return Values from Event Jobs and Action Jobs

The following table lists the return values from event jobs and action jobs.

Table A‒1: Return values from event jobs and action jobs

Return value

Description

Job status after execution or time-out

0

The job ended normally, or the system always assumes that the job ends normally.

Ended normally

1

The job ended normally with a matching message.

Ended normally

2

The job ended normally with detailed matching information.

Ended normally

3

The job ended normally without a matching message.

Ended normally

4

The job ended normally without detailed matching information.

Ended normally

5

Event-inherited information has exceeded the limit.

Ended normally

6

An error has occurred during event-inherited information creation.

Ended normally

7

The job ended normally after a time-out.

Ended normally

12

The job ended with a warning after a time-out.

Ended with warning

16

Condition is not satisfied (incomplete scheduled task).

Bypassed

17

The job was killed after a time-out.

Killed

18

The job was killed.

Killed

20

The system always assumes that the job ends abnormally.

Ended abnormally

21

The job ended abnormally with a matching message.

Ended abnormally

22

The job ended abnormally with detailed matching information.

Ended abnormally

23

The job ended abnormally without a matching message.

Ended abnormally

24

The job ended abnormally without detailed matching information.

Ended abnormally

25

The job ended abnormally after a time-out.

Ended abnormally

30

The job ended because the event action agent has stopped.

Ended abnormally

50

A communication error has occurred between the manager and the agent.

Ended abnormally or failed to start

55

Resources are insufficient. Alternatively, the specified file cannot be accessed.

Ended abnormally

56

Insufficient memory

Ended abnormally

64

The file cannot be read (I/O error).

Ended abnormally

90

Incorrect parameter

Ended abnormally

91

Required item was not defined.

Ended abnormally or failed to start

92

An incorrect macro variable was specified.

Ended abnormally

93

An incorrect platform was specified.

Ended abnormally

250

The mail system or message queue system is not available.

Failed to start

253

An option error occurred in a prerequisite program.

Ended abnormally

254

An error occurred in a prerequisite program.

Ended abnormally

255

System error

Ended abnormally or failed to start

Note

When an operation (such as killing a jobnet) is performed for all start conditions, or an error occurs for all start conditions, the return value of each event for all start conditions is set to 0. In this case, if an error occurs for a specific event (such as for a definition mistake), the return value is set as shown in the table.

Table A‒2: Return values from JP1 event sending jobs

Return value

Description

0

The job ended normally.

1

Argument error

100

A transfer has failed.

The arrival of an event was not confirmed. This return value corresponds to return value 3 (transfer failure) for the jevsendd command in JP1/Base.

120

Processing continues (if the arrival of an event has not been confirmed within the maximum waiting time).

The arrival of an event was not confirmed. This return value corresponds to return value 2 (processing continuing) for the jevsendd command in JP1/Base.

150

Insufficient memory

255

Another error

Note

If a return value other than 0 is returned, determine the cause of the problem from the job execution result messages.

Table A‒3: Return values from email sending jobs (in Windows)

Return value

Description

0

The job ended normally.

90

Parameter error (error in a definition item)

91

Parameter error (error in a definition)

92

Parameter error (required item undefined)

94

Parameter error (excessive number of bytes for a definition)

95

A text file, attached file, or list of attached files was not found.

99

An error indicating that the JP1/AJS3 mail monitoring process or the JP1/AJS3 Mail service does not start

100

Environment settings reading error

101

Environment settings undefined error

102

JP1/AJS installation failure

103

Environment settings information is corrupted.

104

A non-existent profile was specified when the Send Mail job was executed without using Outlook.

105

An attempt to access a profile failed when the Send Mail job was executed without using Outlook.

120

Communication with the JP1/AJS mail monitoring process or mail monitoring service has failed.

121

Sending mail information has failed.

150

Insufficient memory

151

Insufficient resources (for files)

152

Insufficient resources (for processes)

153

The Send Mail job timed out.

154

The profile is corrupted.

155

The desktop heap is insufficient.

180

Acquiring the end status of a mail sending thread has failed.

182

Sending mail has failed.

255

System error

Table A‒4: Return values from email sending jobs (in UNIX)

Return value

Description

0

The job ended normally.

90

Parameter error (error in a definition item)

95

Text file name is not found.

96

No mail address specified error

97

Error in a mail address specified

98

Reading the text file has failed.

126

The email transmission feature is not available.

130

Creating a temporary file to send mail has failed.

131

An incoming signal has interrupted mail sending.

150

Insufficient memory

254

The system command used for mail sending has no privilege for execution.

255

System error

Table A‒5: Return values from message-queue message sending jobs (in Windows)

Return value

Description

0

The job ended normally.

1

Connecting to the specified queue has partially failed.

3

A message has been sent to the dead letter queue.

90

Parameter error (error in a definition item)

91

Parameter error (error in a definition)

92

Parameter error (required item undefined)

94

Parameter error (excessive number of bytes for a definition)

95

The specified file is not found.

98

The JP1/AJS2 message queue monitoring process is not available.

99

An error indicating that the JP1/AJS2 message queue monitoring process does not start

100

Environment settings reading error

101

Environment settings undefined error

102

JP1/AJS2 installation failure

103

The type of the message queuing system used in environment settings is incorrect.

120

Communication with SUP of TP1/LiNK provided by JP1/AJS2 has failed.

121

Connecting to the specified queue has failed.

123

Error in accessing the message queue

150

Insufficient resources (for processes)

151

Insufficient resources (for files)

152

Insufficient resources (for threads)

153

Creating a mutex has failed.

154

jposupwth (the MQ monitoring process for linkage with TP1/Message Queue) has stopped.

155

Starting jposupwth (the MQ monitoring process for linkage with TP1/Message Queue) has failed.

156

Creating an event has failed.

157

Creating a file has failed.

158

Insufficient memory

159

Sending a message to the dead letter queue has failed.

180

Acquiring the end status of a message sending thread has failed.

181

Acquiring the file size has failed.

182

Reading a file has failed.

183

Closing a file has failed.

250

Another event occurred at startup of the MQSeries service.

255

System error

Table A‒6: Return values from message-queue message sending jobs (in UNIX)

Return value

Description

0

The job ended normally.

2

Error with warning during message sending

90

Parameter error (error in a definition item)

91

Parameter error (error in a definition)

95

The specified file is not found.

103

The type of the message queuing system used in environment settings is incorrect.

120

Communication with SUP of TP1/Server Base provided by JP1/AJS2 has failed.

123

Error in accessing the message queue

126

Message queue transmission processing is not available.

150

Insufficient resources (for processes)

155

Stating the MQ monitoring process for linkage with TP1/Message Queue has failed.

156

Creating an event has failed.

157

Creating a file has failed.

158

Insufficient memory

255

System error

Table A‒7: Return values from MSMQ message sending jobs

Return value

Description

0

The job ended normally.

90

Parameter error (error in a definition item)

91

Parameter error (error in an operand)

92

Parameter error (error in a definition)

93

Parameter error (required item undefined)

94

Message sending error

95

Fatal error

The MSMQ linkage functionality is not available.

Table A‒8: Return values from OpenView Status Report job

Return value

Description

0

The job ended normally.

16

Parameter error (error in a definition item)

17

Parameter error (error in an operand)

18

Parameter error (error in a definition)

19

Parameter error (required item undefined)

30

SNMP service not installed (For Windows only)

31

SNMP service not started (For Windows only)

32

SNMP service community name not specified

33

SNMP service trap sending destination not set

34

Message sending error

Table A‒9: Return values from local power control jobs

Return value

Description

0

The job ended normally.

Other than 0

Local power supply control has failed.

Table A‒10: Return values from remote power control jobs

Return value

Description

0

The job ended normally.

Other than 0

Remote power supply control has failed.

Table A‒11: Return values from action jobs (special)#1

Return value

Description

128

The resource is insufficient.#2

-1

Startup failure, forced end, ended abnormally#3

#1

These return values might be set to values other than the return values of job processes of action jobs. Actions jobs include the following:

  • JP1 event sending job

  • Email sending job

  • Message-queue message sending job

  • MSMQ message sending job

  • OpenView Status Report job

  • Local power control job

  • Remote power control job

#2

This return value is used only in Windows systems. For details, see 7.3 Notes on using PC jobs. Because the OS sets this return value, the return value may change depending on the OS version.

#3

For details, see 7.10.3 Checking the return code of a job.