qtos – Query server

Use this general command to query the TPF Operations Server and to determine detailed host port information for all or some host port connections.

Format

-s

Specifies the session, where:

ipaddr: The Internet Protocol (IP) address of the TPF Operations Server.
hostname: The host name of the TPF Operations Server.

-p portnum

Specifies the port, where portnum is the port number of the TPF Operations Server.

-hp hostport

Specifies the host port, where hostport is the host port number of the TPF Operations Server.

-all

Displays all active and backup, critical and noncritical terminal addresses (TAs) that are currently connected to the TPF Operations Server.

Additional information

If you specify 1000 as the host port, this command displays information for all host ports rather than one host port.

Examples

The following command checks the status of the TPF Operations Server.

qtos -s 127.0.0.1 -p 10001 -hp 1

The following shows the results of the previous command followed by a description of the results.

HOST PORT: 1
- HOST INTERFACE: TPFSIM
- PATH: e:\IBM TOS\simulator
- IN USE: YES
- NUMBER OF CONNECTIONS: 1
- LAST I/O TIME STAMP: NONE
  TA  FSC    Client IP Address
  -- ------  -----------------
1- 0  4000    127.0.0.1

Query output complete.

HOST PORT: shows the host port number.
HOST INTERFACE: shows the host interface for the host port.
PATH: shows the path to the TPF Operations Server simulator response files.
IN USE: indicates whether or not a connection has been established to the host port.
NUMBER OF CONNECTIONS: shows the number of connections to the TPF Operations Server on this particular host port.
LAST I/O TIME STAMP: shows the time stamp of the last successful read or write to the TPF host system.
TA: shows the terminal address number of the console connection.
FSC: shows the functional support console bit settings of the console connection.
Client IP Address: shows the current connected client IP address.

The following command queries all host ports of a local TPF Operations Server.

qtos -hp 1000 -ALL

The following message shows the results of the previous command followed by a description of the results.

AAES0007I QUERY SERVER REQUEST HAS BEEN RECEIVED
HOST PORT: 1
 - SYSTEM NAME: DANBURY.SS0001
 - SYSTEM CPUID: B
 - HOST INTERFACE: TELNET
 - IP ADDRESS/PORT: 9.12.20.79/3215
 - SESSION NAME: T78_Z15_TPF01
 - IN USE: YES
 - LAST TPF I/O TIME STAMP: 10/13/21 08:37:59
 - NUMBER OF CONNECTIONS: 6
      TA  Shadow    FSC    Client IP Address  Flags   Client ID
      --  -------  ------  -----------------  -----   ---------
   1- 00   NONE     4000    127.0.0.1         A C      UNKNOWN
   2- 02    FF      C000    9.57.9.11         I C      UNKNOWN
   3- 02    FF      C000    9.57.9.16         ABC      UNKNOWN
   4- 0A    FF      C000    9.57.9.11         A C      UNKNOWN
   5- 10    00      4000    9.57.9.12         A        tosclient1
   6- 11    00      4000    9.56.134.176      A        tosclient2

Query output complete.

Flags

Shows the client status flag, which is a two-character field. The first character contains the connection status to the TPF Operations Server.

A: Active, which means that this client is currently in use.
I: Inactive, which means that this client is in standby mode.

The second character represents the type of client.

B: Backup client.

The third character indicates that the terminal address is a critical client.

C: Indicates that the terminal address is a critical client.

Client ID

Shows the first field of the authentication credentials. This information is displayed only when the authentication feature is enabled in the server. See Server configuration options for more information.

The following command queries the fifth host port of a local TPF Operations Server.

qtos -s localhost -hp 5

The following message shows the results of querying a TELNET port connected to the Open Systems Adapter-Express Integrated Console Controller for 3215 (OSA-ICC 3215) interface.

AAES0007I QUERY SERVER REQUEST HAS BEEN RECEIVED
HOST PORT: 5
 - SYSTEM NAME: ********.********
 - SYSTEM CPUID: **
 - HOST INTERFACE: TELNET
 - IP ADDRESS/PORT: 9.57.191.114
 - SESSION NAME: OSCICC3215TPFP1
 - IN USE: YES
 - LAST TPF I/O TIME STAMP: 04/29/08 15:38:37
 - NUMBER OF CONNECTIONS: 1
      TA  Shadow    FSC    Client IP Address
      --  -------  ------  -----------------
   1- 00   NONE     4000    127.0.0.1

Query output complete.

IP ADDRESS/PORT: shows the Internet Protocol (IP) and TELNET server port.
SESSION NAME: shows the OSA-ICC 3215 session name. This field is only displayed for OSA-ICC 3215 sessions.