Process Command (QxdaProcessCommandEDRS) API

Required Parameter Group:

1	Connection handle	Input	Binary(4)
2	Command	Input	Char(*)
3	Length of command	Input	Binary(4)
4	Error code	I/O	Char(*)

  Service Program Name: QXDAEDRS

  Default Public Authority: *USE

  Threadsafe: Conditional; see Usage Notes

The Process Command (QxdaProcessCommandEDRS) API is used to run a system command on the database server system. The command is called exactly as passed, without coded character set identifier (CCSID) conversion.

Authorities and Locks

Any command: *USE
Library of the command: *EXECUTE

Required Parameter Group

Connection handle: INPUT; BINARY(4)
The handle number of the connection on which to call the command. The connection handle must have been generated by the QxdaConnectEDRS API in the current job and activation group.
Command: INPUT; CHAR(*)
The command you want to run entered as a character string. If the command contains blanks, it must be enclosed in apostrophes. The maximum length of the string is 32702 characters.
Length of command: INPUT; BINARY(4)
The length of the command to run.
Error code: I/O; CHAR(*)
The structure in which to return error information. For the format of the structure, see Error code parameter.

Usage Notes

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

Error Messages

Message ID	Error Message Text
CPF180C E	Function &1 not allowed.
CPF24B4 E	Severe error while addressing parameter list.
CPF3C90 E	Literal value cannot be changed.
CPF9872 E	Program or service program &1 in library &2 ended. Reason code &3.
CPFAE14 E	Cannot allocate &1 bytes.
CPFB750 E	Connection handle specified not valid.
CPFB752 E	Internal error in &1 API.
CPFB756 E	Rollback operation performed.
CPFB757 E	The connection is suspended.
CPFB758 E	The EDRS server system has been switched.
xxxnnnn E	Any escape message issued by any command may be returned.

API introduced: V4R4

[ Back to top | Database and File APIs | APIs by category ]