# PXFTCSETATTR (L*X, M*X)

POSIX Subroutine: Writes new terminal settings.

## Module

USE IFPOSIX

CALL PXFTCSETATTR (ifildes,ioptacts,jtermios,ierror)

ifildes | (Input) INTEGER(4). The file descriptor associated with the terminal.
ioptacts | (Input) INTEGER(4). Specifies when the terminal changes take effect.
jtermios | (Input) INTEGER(4). A handle for structure `termios`. Contains the new terminal settings.
ierror | (Output) INTEGER(4). The error status.

If successful, ierror is set to zero; otherwise, an error code.

The PXFTCSETATTR subroutine copies all terminal parameters from structure `termios`into the terminal associated with ifildes. When the terminal settings will change depends on the value of ioptacts, which must be one of the following constant names:

Constant 1 | Action
--- | ---
TCSANOW | The changes occur immediately.
TCSADRAIN | The changes occur after all output written to ifildes has been transmitted.
TCSAFLUSH | The changes occur after all output written to ifildes has been transmitted, and all input that had been received but not read has been discarded.
1These names can be used in PXFCONST or IPXFCONST.

### Note

To get a handle for an instance of the `termios`structure, use PXFSTRUCTCREATE with the string 'termios' for the structure name.

Parent topic: POSIX* Library Routines

## See Also

PXFSTRUCTCREATE
PXFTCGETATTR