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

[ Back to top | UNIX-Type APIs | APIs by category ]