Qp0zGetTerminalPid()--Get Process ID for a Generic Terminal

 #include <qp0ztrml.h>

 int Qp0zGetTerminalPid( Qp0z_Terminal_T handle,
                         pid_t *pid );  

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