Cancel EDRS Request (QxdaCancelEDRS) API

The Cancel EDRS Request (QxdaCancelEDRS) API is used to cancel a previous call to the QxdaProcessExtDynEDRS or QxdaProcessImmediateEDRS APIs. All parameters are passed to the program by reference.

Authorities and Locks

Job Authority

To perform a cancel operation, you must be running under a user profile that is the same as the job user identity of the job being canceled, or the issuer of the command must be running under a user profile that has job control (*JOBCTL) special authority.

The job user identity is the name of the user profile by which a job is known to other jobs. It is described in more detail in the Work Management topic.

Required Parameter Groups

Connection handle

INPUT; BINARY(4)

The handle number of the connection on which to execute the cancel request. The connection handle must have been generated by the QxdaConnectEDRS API in the current job and activation group. The connection must have been made to the same system where the qualified job name, user, and number currently is executing.

Input structure

INPUT; CHAR(*)

The structure in which to pass information about the job to cancel. For the format of this parameter, see CDBI0100 Format.

Input structure format

INPUT; CHAR(8)

The format of the input structure template being used. The possible value is:

CDBI0100

Basic input structure

Error code

I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error code parameter.

CDBI0100 Format

The following table shows the information to pass in the CDBI0100 format. For more details about the fields in this table, see Field Descriptions.

Field Descriptions

Fully qualified job name. The fully qualified name of the job to cancel. The qualified job name has three parts:

Usage Notes

This function may be called from the initial thread of a job only.

Error Messages