Job Management Partner 1/Automatic Job Management System 3 System Design (Work Tasks) Guide

Appendix 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 Monitoring time-out has occurred. 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.
In version JP1/AJS2 07-00 or later, the arrival of an event was not confirmed. This return value corresponds to return value 3 (transfer failure) for jevsendd command in an earlier version.

120 Processing continues (if the arrival of an event has not been confirmed within the maximum waiting time). In version JP1/AJS2 07-00 or later, the arrival of an event was not confirmed. This return value corresponds to return value 2 (processing continuing) for jevsendd command in an earlier version.

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/AJS mail monitoring process does not start

100 Environment settings reading error

101 Environment settings undefined error

102 JP1/AJS installation failure

103 Environment settings information is corrupted.

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)

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.8.3 Checking the return code of a job.

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	Monitoring time-out has occurred.	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

Return value	Description
0	The job ended normally.
1	Argument error
100	A transfer has failed. In version JP1/AJS2 07-00 or later, the arrival of an event was not confirmed. This return value corresponds to return value 3 (transfer failure) for jevsendd command in an earlier version.
120	Processing continues (if the arrival of an event has not been confirmed within the maximum waiting time). In version JP1/AJS2 07-00 or later, the arrival of an event was not confirmed. This return value corresponds to return value 2 (processing continuing) for jevsendd command in an earlier version.
150	Insufficient memory
255	Another error

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/AJS mail monitoring process does not start
100	Environment settings reading error
101	Environment settings undefined error
102	JP1/AJS installation failure
103	Environment settings information is corrupted.
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)
180	Acquiring the end status of a mail sending thread has failed.
182	Sending mail has failed.
255	System error

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

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

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

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.

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

Return value	Description
0	The job ended normally.
Other than 0	Local power supply control has failed.

Return value	Description
0	The job ended normally.
Other than 0	Remote power supply control has failed.

Return value	Description
128	The resource is insufficient.^#2
-1	Startup failure, forced end, ended abnormally^#3

[Contents][Back][Next]

[Trademarks]