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 ]