Parameters

The parameters for the TCPIPCS command are described below.
subcommand
Default is STATE.
parameters
Each subcommand has its own parameters.
  • If a command has variable parameters, they can be omitted, specified as a single variable, or specified as a list. If no variable parameters are specified, an asterisk must be used as a placeholder if any keyword parameters are specified. If two or more variable parameters are specified, they must be enclosed in parentheses.
  • To distinguish between the variable parameters, a parameter is assumed to be one of the following:
    • An index or small number if it is four digits or less, begins with zero to nine, and contains only hexadecimal digits (0–9, a–f, A–F). If a command accepts multiple indices or small numbers, both are compared to the values and the first matching field is used.
    • An address if it is more than four digits, begins with zero to nine, and contains only hexadecimal digits. For example, for the TCPIPCS DUAF command, both the DUCB and ASCB addresses of each DUCB are compared to the address parameter, and the first matching field is used to select the DUCB to display.
    • An IPCS symbol name can also be specified for an address.
    • Otherwise, the parameter is assumed to be a character string variable (such as TCP/IP procedure or job name, user ID, and command name).
  • Keyword parameters can be in any order.
  • If there are both keyword and variable parameters, all variable parameters must precede the keywords.
TCP
Specifies which TCP/IP stack or Telnet instance. When issuing commands for Telnet, the Telnet procedure name must be specified in the tcp_proc_name variable. The stack can be specified directly or indirectly. A stack can be specified directly by coding the TCP parameter with either tcp_proc_name or tcp_index. If no stack is specified directly, the output is reported for the stack with the lowest index matching the release of the TCPIPCS command. After a particular stack is specified (whether specified directly or indirectly), that stack becomes the default. The stack index is saved as a symbol and is used as the default in future invocations of the TCPIPCS command. An alias for the TCP option is PROC.
Note: All eight stack indices are available when TCP/IP or Telnet starts, so any stack index can be selected. The existence of an index does not necessarily mean this stack can be formatted. If the stack was not included in the dump, then most of the information about a stack cannot be formatted. Most TCP/IP control blocks are in the private TCP address space. All Telnet control blocks are in the private Telnet address space.

The fact that an index exists does not necessarily mean this stack index has ever been used. If you specify a stack index that has not been used, the version and release fields for this stack are zero, so you receive a message indicating the stack is not the same version and release as the TCPIPCS command:

tcp_proc_name
TCP/IP procedure name or the Telnet procedure name (when the TN3270E Server is running in its own address space).
tcp_index
TCP/IP stack index (1-8) or Telnet index (9-16).
TITLE
The title contains information about the dump and about the TCPIPCS command. By default, the title information is displayed.
The title contains the following information.
  • TCPIPCS command input parameters.
  • Dump data set name.
  • Dump title.
  • TSAB address.
  • Table listing all TCP/IP stacks used in the dump and their
    • TSEB address
    • Stack index
    • Procedure name
    • Stack version
    • TSDB address
    • TSDX address
    • ASID
    • Trace option bits
    • Stack status
  • Count of the number of TCP/IP stacks defined (used).
  • Count of the number of active TCP/IP stacks found.
  • Count of the number of active TCP/IP stacks matching the TCPIPCS command version and release.
  • Procedure name and index of the stack being reported.
NOTITLE
Suppress the title lines. This is useful when you are processing many commands on the same dump and do not want to see the title information repeated.
Rule: If you specify multiple keywords from the set {TITLE, NOTITLE}, only the last one is used.
Parent topic: TCPIPCS command