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 ]