Collect Hung Job Service Documentation (QPDETHNG) API

Required Parameter Group:

1	Job name	Input	Char(10)
2	Job user	Input	Char(10)
3	Job number	Input	Char(6)
4	Error Code	I/O	Char(*)

Default Public Authority: *EXCLUDE

Threadsafe: Yes

The Collect Hung Job Service Documentation (QPDETHNG) API dumps documentation associated with the hung job to help service determine the cause of the hang.

Authorities and Locks

Authority to use the API: Special authorities needed: *JOBCTL and either *SERVICE or be authorized to the Service Dump function of the IBM^® i operating system through System i^® Navigator's Application Administration support. The Change Function Usage (CHGFCNUSG) command, with a function ID of QIBM_SERVICE_DUMP, can also be used to change the list of users that are allowed to perform dump operations.

Required Parameter Group

Job name: INPUT; CHAR(10)
The name of the hung job.
Job user: INPUT; CHAR(10)
The user of the hung job.
Job number: INPUT; CHAR(6)
The number of the hung job.
Error code: I/O; CHAR(*)
The structure in which to return error information. For the format of the structure, see Error code parameter.

Error Messages

The following messages may be sent from this function:

Message ID	Error Message Text
CPF3CF1	Error code parameter not valid.
CPF3CF2	Error(s) occurred during running of * API.
CPFC1D	Input variable length in parameter * not valid.
CPF3C1E	Required parameter * omitted.
CPF3C17	Error occurred with input data parameter.
CPF3C21	Format name * is not valid.
CPF3C4A	Value not valid for field *.
CPF3C4B	Value not valid for field *.
CPF3C4C	Value not valid for field *.
CPF9872	Program or service program * in library * ended. Reason code *.

API introduced: V5R4

[ Back to top | Problem Management APIs | APIs by category ]