This report displays information about pseudo terminal user connections
and OCS remote terminals. Fields displayed in the pseudo terminal
section of the report include:
- Pseudo Terminal Main Token
- The main token for the pseudo terminal support. IBM® might request this token.
- Dev Minor
- The device minor number assigned to the terminal file.
- Connection Token
- A token associated with this connection. IBM might request this token.
- State
- The open or closed status of the master and subordinate pseudo
terminals.
- Foreground PGID
- The foreground process group ID.
- Line Discipline
- Active line discipline number.
- Session ID
- The session ID of the controlling terminal.
- Slave File Token
- A unique identifier associated with the subordinate character-special
file; or identifies the controlling terminal.
- Slave Open Count
- The number of opens for the subordinate file.
- Input Queue
- The number of bytes in the input queue. The threshold information
that follows applies to the input queue.
- Threshold
- Input queue threshold information. Included are the lower threshold,
upper threshold, and whether the upper threshold has been reached.
Once the upper threshold has been reached, the "reached" indicator
remains on until the lower threshold is reached. If the upper threshold
has been reached, subsequent master writes are blocked or rejected
until the lower threshold is reached.
- Output Queue
- The number of bytes in the output queue. The threshold information
that follows applies to the output queue.
- Threshold
- Output queue threshold information. Included are the lower threshold,
upper threshold, and whether the upper threshold has been reached.
Once the upper threshold has been reached, the "reached" indicator
remains on until the lower threshold is reached. If the upper threshold
has been reached, subsequent subordinate writes are blocked or rejected
until the lower threshold is reached.
- Pending Packet Flags
- Packet flags that have not yet been reported to a master read.
If the connection is not in packet or extended packet mode, these
flags should be zero.
- Non-canonical Data Available
- An indicator whether non-canonical data is available. Unless
the connection is in non-canonical mode (ICANON off) or 3270 Passthru
mode (PTU3270 on), this indicator should be "NO". Note that, in non-canonical
mode, data can be available with an empty input queue if MIN=0 and
TIME=0.
- Non-canonical TIME Timer Active
- An indicator whether a timer is active for non-canonical reads.
The timer is used when in non-canonical mode (ICANON off) and TIME
is greater than zero.
- xxDSY Timer Active
- An indicator whether a timer is active for delays after certain
special characters have been read from the master pseudoterminal.
These delays are used when delays are requested by setting the xxDSY
fields in the termios, and OFILL is off.
- Canonical Lines
- The number of canonical lines on the input queue.
- Slave Closed with HUPCL Set
- YES indicates the HUPCL flag was set on when the final subordinate
close occurred.
- Inoperative
- YES indicates that the PTY connection is unusable due to a catastrophic
failure.
- Termios Flags
- The flags for control, input, local, and output.
- Special Characters (c_cc array)
- The special characters used for interrupt, quit, erase, line kill,
end-of-file, end-of-line, start, stop, suspend, and the MIN and TIME
values used in non-canonical mode.
- Code Page Support Not Activated
- A message indicating that the code page change notification (CPCN)
capability was never activated for the connection. If CPCN has been
activated for the connection, termcp information (below) will
be presented instead.
- Termcp
- The termcp structure used for code page support. The next
three fields show the data from the termcp.
- Flags
- The flags from the termcp.
- Source Code Page
- The source code page name. The name is a character string delimited
with a NUL character (X'00').
- Target Code Page
- The target code page name. The name is a character string delimited
with a NUL character (X'00').
- Winsize
- The winsize structure. The next four fields show the data
from the winsize. If all four fields are zero, the master
application probably never initialized the winsize structure.
- Ws_row
- The number of rows in the window.
- Ws_col
- The number of columns in the window.
- Ws_xpixel
- The width of the window in pixels.
- Ws_ypixel
- The height of the window in pixels.
The following information is presented for each request on the
master read, write and drain queues and for each subordinate read,
write, and drain queue.
- Request
- A heading line identifying the request. A token associated with
this request is also shown.
- Token
- Unique identifier of this request.
- Userid
- The login name of the user making the request.
- Process ID
- The identifier assigned to the process.
- Bytes to Process
- Total number of bytes to process.
- PGID
- The process group identifier.
- Bytes Processed
- Number of characters processed on the current write.
- SID
- The session identifier.
- ASID
- The address space identifier.
- Scheduled
- Yes indicates that the request has been posted ready.
- TOSTOP in Effect
- Yes indicates that a background write for this session is stopped.
- I/O Control Command
- The control command in effect for this request.
The following information is presented for each request on the
master and subordinate select queues.
- Request Token
- The unique identifier of this request.
- Criteria
- Select Criteria, as follows:
- Read
- YES indicates that a select for Read criteria was requested.
- Write
- YES indicates that a select for Write criteria was requested.
- Xcept
- YES indicates that a select for Exception criteria was requested.
- Posted
- YES indicates that one or more criteria have been satisfied and
that the waiting process was posted.
If the OCS is active, then additional fields in the report include:
- OCS Token
- IBM may request this information
for diagnostic purposes.
- TBM Daemon Status (one of the following lines is displayed)
- TBM Daemon is not currently ATTACHed.
- TBM Daemon is creating the accept socket.
- TBM Daemon is binding the accept socket.
- TBM Daemon is creating the connection request queue.
- TBM Daemon is in accept wait.
- TBM Daemon is shutting down.
- TBM Daemon is in timer wait.
- TBM Daemon is creating tasks for a new connection.
- Last Issued Configuration Command
- Information about the last ocsconfig command that was issued.
- Audit Trail Information
- IBM may request this information
for diagnostic purposes.
- TBM Host Name
- The name of the terminal buffer manager connection.
- Terminal Buffer Manager Token
- IBM may request this information
for diagnostic purposes.
- TBM Flags
- IBM may request this information
for diagnostic purposes.
- TBM Status (one of the following lines is displayed)
- TBM is connected.
- TBM is configured.
- TBM is not configured.
- Port Number
- The INET port address.
- INET Address
- The INET address or NETID.
The following information is presented for each configured terminal
device:
- Dev Minor
- The device minor number assigned to the terminal file.
- Token
- IBM may request this information
for diagnostic purposes.
- Foreground PGID
- The foreground process group ID.
- Session ID
- The session ID of the controlling terminal.
- Open Count
- The number of open() requests processed.
- Syscall Count
- The number of syscalls sent to OCS for this device.
- Pending Syscall Count
- The number of syscalls sent to OCS for this device that
are still pending, that is, in reply-wait.
- MVS™ File Name
- The z/OS UNIX terminal
device name.
- OCS File Name
- The OCS terminal device name.
- User Login Name
- The name of the user that logged in to this device.
- UID
- The user ID of the user that logged in to this device.
- Termios Flags
- The flags for control, input, local, and output.
The following information is presented for each request on the
select queue:
- Criteria
- Select Criteria, as follows:
- Read
- YES indicates that a select for Read criteria was requested.
- Write
- YES indicates that a select for Write criteria was requested.
- Xcept
- YES indicates that a select for Exception criteria was requested.
- Asynchronous Request Information
- IBM may request this information
for diagnostic purposes.
The following information is presented for each request on the
reply/wait queue and the background read/write queue:
- Request Token
- IBM may request this information
for diagnostic purposes.
- Process ID
- The identifier assigned to the process.
- Thread ID
- The identifier assigned to the thread.
- Sequence Number
- The identifier assigned to this syscall request.