SHOW-CONNECTION / SHCN: Show connection information

You use the SHOW-CONNECTION command to output information about transport connections. The command is mapped directly to BCSHOW.

The alias SHCN exists for SHOW-CONNECTION.

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

List of valid command sources

SHOW-CONNECTION / SHCN

CONNECTION = *ALL / [*PARAMETERS](...) / *NUMBER(...) / *VIA-HOST(...) / *VIA-NODE(...) / *VIA-LINE(...) / *VIA-PROCESSOR(...) / *VIA-ROUTE(...)
	[*PARAMETERS](...)
		|	APPLICATION = *ALL / [*NEA](...) / *OSI(...) / *SOCKETS(...) / *PORT(...) / *NUMBER(...)
		|		*[NEA](...)
		|			|	NEA-NAME = <text 1 .. 16> / <c-string 1 .. 16>
		|		*OSI(...)
		|			|	OSI-NAME = <composed-name 1 .. 78> / <text 1 .. 78> / <x-string 1 .. 156>
		|		*SOCKETS(...)
		|			|	SOCKET-NAME = <composed-name 1 .. 78> / <text 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>
		|	,PARTNER = *ALL / [*NEA](...) / *OSI(...) / *SOCKETS(...) / *PORT(...)
		|		*[NEA](...)
		|			|	NEA-NAME = <text 1 .. 16> / <c-string 1 .. 16>
		|		*OSI(...)
		|			|	OSI-NAME = <composed-name 1 .. 78> / <text 1 .. 78> / <x-string 1 .. 156>
		|		*SOCKETS(...)
		|			|	SOCKET-NAME = <composed-name 1 .. 78> / <text 1 .. 78> / <x-string 1 .. 156>
		|		*PORT(...)
		|			|	PORT-NUMBER = <integer 1 .. 65535> / <x-string 1 .. 4>
	*NUMBER(...)
		|	CONNECTION-NUMBER = <integer 0 .. 2147483647> / <x-string 1 .. 8>
	*VIA-HOST(...)
		|	HOST-NAME = <composed-name 1 .. 8> / <text 1 .. 8>
	*VIA-NODE(...)
		|	NODE-NAME = <composed-name 1 .. 8> / <text 1 .. 8>
	*VIA-LINE(...)
		|	LINE-NAME = <composed-name 1 .. 8> / <text 1 .. 8>
	*VIA-PROCESSOR(...)
		|	PROCESSOR-NAME = <composed-name 1 .. 8> / <text 1 .. 8>
	*VIA-ROUTE(...)
		|	ROUTE-NAME = <composed-name 1 .. 8> / <text 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>
		|	,IPSEC = *ANY / *NO / *YES
		|	,VLAN-ID = *ANY / *ALL / <integer 2 .. 4094>
		|	,PROCESSOR-NAME = *ANY / <composed-name 1 .. 8> / <text 1 .. 8>
		|	,INTERFACE = *ANY / *NEA / *ISO / *STREAMS / *SOCKETS
		|	,L4-PROTOCOL = *ANY / list-poss(4): *LOCAL / *ISO / *ISO-4 / *TCP
,MAX-MSG-NUMBER = *STD / <integer 1 .. 2147483647>

CONNECTION=...
Connection for which the information is output.
The information is output using the console messages BCA08A7, BCA08A8, BCA08A1, BCA08A2 and BCA08E8.

CONNECTION=*ALL
Information is output for all existing connections

CONNECTION=[*PARAMETERS](...)
Information for connections concerning applications with a NEA application name is output.

APPLICATION=...
Name of the application for whose connections information is output.

APPLICATION=*ALL
Information is output for all applications for which connections exist.

APPLICATION=[*NEA](...)
Information for connections concerning applications with a NEA application name is output.

NEA-NAME=<text 1..16>
NEA application name of the application for whose connections information is output.

APPLICATION=*OSI(...)
Information for connections concerning applications with an OSI application name is output.

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

APPLICATION=*SOCKETS(...)
Information for connections concerning applications with a SOCKET application name is output.

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

APPLICATION=*PORT(...)
Information for connections concerning applications identified via a TCP/IP port number is output.

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

APPLICATION=*NUMBER(...)
Information for connections concerning applications identified via an internal BCAM application number is output.

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

PARTNER=...
Name of the partner application for whose connections information is to be output.

PARTNER=*ALL
Information is output for all partner applications for which connections exist.

PARTNER=[*NEA](...)
Information is output for connections concerning partner applications with a NEA application name.

NEA-NAME=<text 1..16>
NEA application name of the partner application for whose connections information is to be output.

PARTNER=*OSI(...)
Information is output for connections concerning partner applications with an OSI application name.

OSI-NAME=<text 1..78> / <x-string 1..156>
OSI application name of the partner application for whose connections information is to be output.

PARTNER=*SOCKETS(...)
Information is output for connections concerning partner applications with a SOCKET application name.

SOCKET-NAME=<text 1..78> / <x-string 1..156>
SOCKET application name of the partner application for whose connections information is to be output.

PARTNER=*PORT(...)
Information for connections concerning partner applications identified via a TCP/IP port number is output.

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

CONNECTION=*NUMBER(...)
Information for connections concerning partner applications identified via an internal BCAM application number is output.

CONNECTION-NUMBER=<integer 0..2147483647> / <x-string 1..8>
Internal BCAM application number of the partner application for whose connections information is output.

CONNECTION=*VIA-HOST(...)
Outputs the information for connections which are identified via the BCAM host.

HOST-NAME=<composed-name 1 .. 8> / <text 1 .. 8>
BCAM host of the connections for which information is output.

CONNECTION=*VIA-NODE(...)
Outputs the information for connections which are identified via a BCAM node.

NODE-NAME=<composed-name 1 .. 8> / <text 1 .. 8>
BCAM node of the connections for which information is output.

CONNECTION=*VIA-LINE(...)
Outputs the information for connections which are identified via a BCAM line (with the exception of the VLAN lines).

LINE-NAME=<composed-name 1 .. 8> / <text 1 .. 8>
BCAM line of the connections for which information is output.

CONNECTION=*VIA-PROCESSOR(...)
Outputs the information for connections which are identified via the BCAM processor.

PROCESSOR-NAME=<composed-name 1 .. 8> / <text 1 .. 8>
BCAM processor of the connections for which information is output.

CONNECTION=*VIA-ROUTE(...)
Outputs the information for connections which are identified via the BCAM route.

ROUTE-NAME=<composed-name 1 .. 8> / <text 1 .. 8>
BCAM route of the connections for which information is output.

SELECT=...
Criterion used to search for a connection.

SELECT=*ALL
Information on all existing connections is output.

SELECT=[*BY-ATTRIBUTES](...)
Information is output on the connections that meet the following criteria.

JOB-IDENTIFICATION=...
Information is output on connections that were logged on under a specific task.

JOB-IDENTIFICATION=*ANY
Information on all existing connections is output.

JOB-IDENTIFICATION=*TID(...)
Information is output on connections that were logged on under a specific task ID.

TID=<x-string 1..8>
Information is output on connections that were logged on under the specified task ID.

JOB-IDENTIFICATION=*TSN(...)
Information is output on connections that were logged on under a specific TSN.

TSN=<alphanum-name 1..4>
Information is output on connections that were logged on under the specified TSN.

IPSEC=...
Information is shown for connections that are used securely via IPSec.

IPSEC=*ANY
Information is shown for all existing connections.

IPSEC=NO
Information is shown only for connections not being used securely with IPSec.

IPSEC=YES
Information is shown only for connections being used with IPSec.

VLAN-ID=...
Information is shown for connections which are assigned to a VLAN ID.

VLAN-ID=*ANY
Information is shown for all existing connections.

VLAN-ID=*ALL
Information is shown for connections to all VLAN IDs.

VLAN-ID=<integer 2..4094>
Information is shown for connections which are assigned to a VLAN ID.

PROCESSOR-NAME=...
Information is shown for connections that lead to a specific partner processor.

PROCESSOR-NAME=*ANY
Information for all existing connections is shown.

PROCESSOR-NAME=<composed-name 1..8> / <text 1..8>
Information is shown for connections that use a specific NEA interface functionality.

INTERFACE=...
Information is output on connections that use a specific interface functionality.

INTERFACE=*ANY
Information on all existing connections is output.

INTERFACE=*NEA
Information is output on connections that use NEA interface functionality.

INTERFACE=*ISO
Information is output on connections that use ISO interface functionality.

INTERFACE=*STREAMS
Information is output on connections that use STREAMS (SOCKETS) interface functionality.

INTERFACE=*SOCKETS
Information is output on connections that use STREAMS (SOCKETS) interface functionality.

L4-PROTOCOL=...
Information is output on connections with a specific protocol type

L4-PROTOCOL=*ANY
Information on all existing connections is output.

L4-PROTOCOL=*LOCAL
Information is output on all existing connections with the Layer 4 protocol for local connections.

L4-PROTOCOL=*ISO
Information is output on all existing connections with the Layer 4 protocol ISO8073.

L4-PROTOCOL=*ISO-4
Information is output on all existing connections with the Layer 4 protocol ISO8073 Class 4.

L4-PROTOCOL=*TCP
Information is output on all existing connections with the Layer 4 protocol TCP.

MAX-MSG-NUMBER=...
Maximum number of messages that can be output for this command.

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

MAX-MSG-NUMBER=<integer 1..2147483647>
Maximum number of messages that can 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

For reasons of compatibility, positive acknowledgments are supplied in news BCA0720, and negative acknowledgments in news BCA0728, followed by the message NBR0740. In addition, for positive acknowledgments, the messages BCA08E8, BCA08A1, BCA08A2, BCA08A7 and BCA08A8 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	BCA07A1	Route not found
0       64	BCA07A2	Line not found
0       64	BCA07A3	Node not found
0       64	BCA07A4	Host not found
0       64	BCA08EF	Nothing found to show
0      128	BCA0814	BCAM is being terminated abnormally
0      128	BCA0816	BCAM is terminating
0      130	BCA0766	BCAM is not active

Example

Show connections

/SHOW-CONNECTION

Equivalent BCSHOW command:

/BCSHOW SHOW=CONNECTION,INFORMATION=(SHORT,LONG)