Qp0zGetTerminalPid()--Get Process ID for a Generic Terminal
Syntax
#include <qp0ztrml.h> int Qp0zGetTerminalPid( Qp0z_Terminal_T handle, pid_t *pid );Service Program Name: QP0ZTRML
Default Public Authority: *USE
Threadsafe: No
The Qp0zGetTerminalPid() function returns the process ID of
the interpreter process for the terminal specified by handle.
Parameters
- handle
- (Input) Handle for terminal.
- *pid
- (Output) Pointer to area to store process ID of interpreter process.
Authorities
None.
Return Value
- 0
- Qp0zGetTerminalPid() was successful.
- value
- Qp0zGetTerminalPid() was not successful. The value returned is an errno indicating the failure.
Error Conditions
If Qp0zGetTerminalPid() is not successful, the return value usually indicates one of the following errors. Under some conditions, the return value could indicate an error other than those listed here.
- [EFAULT]
The address used for an argument is not correct.
In attempting to use an argument in a call, the system detected an address that is not valid.
While attempting to access a parameter passed to this function, the system detected an address that is not valid.
- [EINVAL]
- The value specified for the argument is not correct.
A function was passed incorrect argument values, or an operation was attempted on an object and the operation specified is not supported for that type of object.
An argument value is not valid, out of range, or NULL.
- [EUNKNOWN]
Unknown system state.
The operation failed because of an unknown system state. See any messages in the job log and correct any errors that are indicated, then retry the operation.
Related Information
- The <qp0ztrml.h> file (see
Header Files for UNIX®-Type Functions)
- Qp0zControlTerminal()--Control a Generic
Terminal
- Qp0zEndTerminal()--End a Generic Terminal
- Qp0zIsATerminal()--Determine Whether Descriptor Is
Connected to a Generic Terminal
- Qp0zRunTerminal()--Run a Generic Terminal
- Qp0zSetTerminalMode()--Set Modes for a Generic
Terminal
- Qp0zStartTerminal()--Start a Generic
Terminal
API introduced: V4R2