SHOW-TSAP-OPEN / SHTO: Show information on TSAP

You use the SHOW-TSAP-OPEN command to display information on an application.

The SDF alias SHTO exists for SHOW-TSAP-OPEN.

BS2000 console	BS2000 SDF command	Command/ SOF file	SNMP management	Parameter service
x	x

List of valid command sources

SHOW-TSAP-OPEN / SHTO

APPLICATION = *ALL / [*NEA](...) / *OSI(...) / *SOCKETS(...) / *PORT(...) / *NUMBER(...)
	*[NEA](...)
		|	NEA-NAME = <text 1 .. 16> / <c-string 1 .. 16>
	*OSI(...)
		|	OSI-NAME = <text 1 .. 78> / <c-string 1 .. 78> / <x-string 1 .. 156>
	*SOCKETS(...)
		|	SOCKET-NAME = <text 1 .. 78> / <c-string 1 .. 78> / <x-string 1 .. 156>
	*PORT(...)
		|	PORT-NUMBER = <integer 1 .. 65535> / <x-string 1 .. 4>
	*NUMBER(...)
		|	APPLICATION-NUMBER = <integer 0 .. 2147483647> / <x-string 1 .. 8>
,SELECT = *ALL / [*BY-ATTRIBUTES](...)
	[*BY-ATTRIBUTES](...)
		|	JOB-IDENTIFICATION = *ANY / *TID(...) / *TSN(...)
		|		*TID(...)
		|		|		TID = <x-string 1 .. 8>
		|		*TSN(...)
		|		|		TSN = <alphanum-name 1 .. 4>
		|	,INTERFACE = *ANY / *NEA / *ISO / *STREAMS / *SOCKETS
,MAX-MSG-NUMBER = *STD / <integer 1 .. 2147483647>

APPLICATION=...
Name of the application for which the information is output.
The information is output with console message BCA08E7.

APPLICATION=*ALL
Information is output for all existing applications.

APPLICATION=[*NEA](...)
Information is output for applications with NEA application names.

NEA-NAME=<text 1..16> / <c-string 1..16>
NEA application name of the application for which information is output.

APPLICATION=*OSI(...)
Information is output for applications with OSI application names.

OSI-NAME=<text 1..78> / <c-string 1..78> / <x-string 1..156>
OSI application name of the application for which information is output.

APPLICATION=*SOCKETS(...)
Information is output for applications with SOCKET application names.

SOCKET-NAME=<text 1..78> / <c-string 1..78> / <x-string 1..156>
SOCKET application name of the application for which information is output.

APPLICATION=*PORT(...)
Information is output for applications which are identified by means of TCP/IP port numbers.

PORT-NUMBER=<integer 1..65535> / <x-string 1..4>
TCP/IP port number of the application for which information is output.

APPLICATION=*NUMBER(...)
Information is output for applications which are identified by means of the BCAM-internal application number.

APPLICATION-NUMBER=<integer 0..2147483647> / <x-string 1..8>
BCAM-internal application number of the application for which information is output.

SELECT=...
Criterion used to search for an application.

SELECT=*ALL
Information is output for all existing applications.

SELECT=[*BY-ATTRIBUTES](...)
Information is output for applications which meet the following criteria.

JOB-IDENTIFICATION=...
Information is output for applications which were logged on under a particular task.

JOB-IDENTIFICATION=*ANY
Information is output for all existing applications.

JOB-IDENTIFICATION=*TID(...)
Information is output for applications which were logged on under a particular task ID.

TID=<x-string 1..8>
Information is output for applications which were logged on under this task ID.

JOB-IDENTIFICATION=*TSN(...)
Information is output for applications which were logged on under a particular TSN.

TSN=<alphanum-name 1..4>
Information is output for applications which were logged on under this TSN.

INTERFACE=...
Information is output for applications which use a particular interface functionality.

INTERFACE=*ANY
Information is output for all existing applications.

INTERFACE=*NEA
Information is output for applications which use the NEA interface functionality.

INTERFACE=*ISO
Information is output for applications which use the ISO interface functionality.

INTERFACE=*STREAMS
Information is output for applications which use the STREAMS (SOCKETS) interface functionality.

INTERFACE=*SOCKETS
Information is output for applications which use the STREAMS (SOCKETS) interface functionality.

MAX-MSG-NUMBER=...
Maximum number of messages which may be output for this command.

MAX-MSG-NUMBER=*STD
A maximum of 50 messages may be output to SYSOUT and a maximum of 10 on the console.

MAX-MSG-NUMBER=<integer 1..2147483647>
Maximum number of messages which may be output for this command.

The number of messages issued can be exceeded when information is output because of the restricted output length of a message.
Multiple messages are frequently output for BCAM objects. Within BCAM these messages are counted as just one message.
In some cases the message BCA0765 is also issued in order to facilitate the assignment of the output information to the specified command.

Command logging

Positive acknowledgments are supplied in news BCA0720 and negative acknowledgments in news BCA0728 followed by the message NBR0740. If processing is positive the message BCA08E2 may also appear.
A description of the error messages that may be issued during command processing is provided in the table below.

Command return codes

(SC2)      SC1	Maincode	Meaning
0        0	CMD0001	Command successfully processed
0        1	CMD0202	Error in command
0        1	BCA0768	Syntax error in command
0       64	BCA0791	Anwendung nicht gefunden
0       64	BCA08EF	Nothing found to show
0      128	BCA0814	BCAM is being terminated abnormally
0      128	BCA0816	BCAM is terminating
0      128	BCA0766	BCAM is not active

Examples

Show application information

/SHOW-TSAP-OPEN

Analogous BCSHOW command:

/BCSHOW SHOW=TSAP-OPEN