BCSHOW: BCAM info on hosts

BCSHOW for a named host

HOST = <host-name 1 .. 8>
,SHOW = *none / list-poss (7): LINE / NODE / ROUTE / APPLICATION / TSAP-OPEN /
CONNECTION / PROCESSOR
,RANGE = *ALL / list-poss (3): LOCAL / REMOTE / *CHANGED
,STATE-OF-ROUTE = *ANY / list-poss (5): EXCLUDED / WAITING-FOR-ACTIVATION / ACTIVE /
WAITING-FOR-DEACTIVATION / INACTIVE
,TRANSFER = *ANY / list-poss (4): READY / WAITING-FOR-INITIALISATION /
WAITING-FOR-READY / NOT-READY
,INFO = list-poss (3): SHORT / LONG / TIMES
,SELECT = *none / (...)
	(...)
		|		APP# = *none / <integer 0 .. 2147483647> / <x-string 1 .. 8>
		|		,TSN = *none / <c-string 1 .. 4> / <x-string 1 .. 8>
		|		,TID = *none / <x-string 1 .. 8>
		|		,FUNCT = *none / NEA / ISO / STREAMS
		|		,PORT# = *none / (...)
		|				(...)
		|					|		OWN = <integer 1 .. 65535>
		|					|		,PART = <integer 1 .. 65535>
		|		,CON# = *none / <integer 0 .. 2147483647> / <x-string 1 .. 8>
		|		,IPSEC = *none / NO / YES
		|		,VLAN-ID = *none / *ALL / <integer 2 .. 4094>
		|		,ENDSYSTEM = *none / <processor-name 1 .. 8>
		|		,PROT = *none / *ALL / list-poss (3): LOCAL / ISO4 / TCP
		|		,PARTNER = *none / ( [ NEA ] , <nea-name 1 .. 16> / <c-string 1 .. 16> ) /
		|				( OSI , <osi-name 1 .. 78> / <c-string 1 .. 78> / <x-string 1 .. 156> ) /
		|				( SOCKET, <socket-name 1 .. 78> / <c-string 1 .. 78> / <x-string 1 .. 156> )
,MAXMSG# = <integer 1 .. 2147483647>

BCSHOW for all available (virtual) hosts                                           

SHOW = HOST

,MAXMSG# = <integer 1 .. 2147483647>

HOST=<host-name 1..8>
Using HOST, you specify the host name for which information is displayed.
The information is displayed with console message BCA08E0.

SHOW=...
Using SHOW, the additional information to be displayed is specified.
The values can also be specified as a list (list-poss).

SHOW= *none
No additional information is displayed.

SHOW=HOST
Information is displayed about all available (virtual) hosts.
The information is displayed with console message BCA08E0.

SHOW=LINE
Information is displayed about the lines to this host.
The information is displayed with console message BCA08ED.

SHOW=NODE
Information is displayed about the LAN nodes, which are connected to this host.
The information is displayed with the console messages BCA08CB and BCA08EB.

SHOW=ROUTE
Information is displayed about the routes which lead to this host.
The information is displayed with the console messages BCA08E6 and BCA08EE.

SHOW=APPLICATION
Information is displayed about applications which are set up in this host.
The information is displayed with console message BCA08E7.

SHOW=TSAP-OPEN
Information is displayed about the opening of applications which are set up in this host.The information is displayed with console message BCA08E2.

SHOW=CONNECTION
Information is displayed about connections which lead from this host.
The information is displayed with console messages BCA08A1, BCA08A2 BCA08A7, BCA08A8 or BCA08E8 (depending on the INFO operand).

SHOW=PROCESSOR
Information is displayed about the processors which can be accessed from this host.The information is to be displayed with console message BCA08EA.

RANGE=...
Using RANGE, you specify the routes or processors for which information is displayed.Apart from the value *ALL, the remaining values can also be specified as a list (list-poss).

RANGE=*ALL
Information is displayed about all routes leading to this host, and the related processors.

RANGE=LOCAL
Information is displayed about all local routes leading to this host, and the related processors.
Routes which refer to the direct connections to the host or to a LAN node of the host are defined as local.

RANGE=REMOTE
Information is displayed about all remote routes leading to this host, and the related processors.
All routes which do not describe any direct connections to the host or to a LAN node of the host are defined as remote.

RANGE=*CHANGED
Information is displayed about all changed routes leading to this host. All routes which no longer correspond to their initial definition are regarded as changed.

STATE-OF-ROUTE=...
STATE-OF-ROUTE defines the permitted administration state of routes for which information is displayed.
Apart from the value *ANY, the remaining values can also be specified as a list (list-poss).

STATE-OF-ROUTE=*ANY
The routes may have any administration state.

STATE-OF-ROUTE=EXCLUDED
The routes must have the administration state EXCLUDED.

STATE-OF-ROUTE=WAITING-FOR-ACTIVATION
The routes must have the administration state WAITING-FOR-ACTIVATION.

STATE-OF-ROUTE=ACTIVE
The routes must have the administration state ACTIVE.

STATE-OF-ROUTE=WAITING-FOR-DEACTIVATION
The routes must have the administration state WAITING-FOR-DEACTIVATION.

STATE-OF-ROUTE=INACTIVE
The routes must have the administration state INACTIVE.

TRANSFER=...
TRANSFER specifies which transfer state the routes may have in order for information to be displayed.
Apart from the value *ANY, the remaining values can also be specified as a list (list-poss).

TRANSFER=*ANY
The routes can have any transfer state.

TRANSFER=READY
The routes must have the transfer state “READY-TO-TRANSFER”.

TRANSFER=WAITING-FOR-INITIALISATION
The routes must have the transfer state “WAITING-FOR-INITIALISATION”.

TRANSFER=WAITING-FOR-READY
The routes must have the transfer state “WAITING-FOR-READY-TO-TRANSFER”.

TRANSFER=NOT-READY
The routes must have the transfer state “NOT-READY-TO-TRANSFER”.

INFO=...
Using INFO, you specify which information about connections and/or which special information about routes is displayed.
The values can also be specified as a list (list-poss).

INFO=SHORT
The dynamic information about connections is displayed.
The information is displayed with console message BCA08E8.

INFO=LONG
The static information about connections is displayed.
The information is displayed with console message BCA08A1, BCA08A2, BCA08A7 and BCA08A8.

INFO=TIMES
The route-specific timer values are displayed.
The information is displayed with console message BCA08F6.

SELECT=...
SELECT enables you to select the applications and/or connections for which information is to be displayed.

SELECT= *none
No selection of applications and/or connections for which information is to be displayed is made.

SELECT=(...)
A selection of applications and/or connections for which information is to be displayed is made.

APP#=...
APP# defines the internal (current) application number of the (related) application as a selection criterion for the applications and connections to be displayed.

APP#= *none
Selection criterion for the applications and connections to be displayed is not the internal (current) application number.

APP#=<integer 0..2147483647> / <x-string 1..8>
Selection criterion for the applications and connections to be displayed is the specified internal (current) application number APP#.

TSN=...
TSN defines the TSN of a task, which the (related) application has opened, as the selection criterion for the applications and connections to be displayed.

TSN= *none
Selection criterion for the applications and connections to be displayed is not the TSN of a task.

TSN=<c-string 1..4> / <x-string 1..8>
Selection criterion for the applications and connections to be displayed is the specified TSN.

TID=...
TID defines the task ID of a task, which the (related) application has opened, as a selection criterion for the applications and connections to be displayed.

TID= *none
Selection criterion for the applications and connections to be displayed is not the task ID of a task.

TID=<x-string 1..8>
Selection criterion for the applications and connections to be displayed is the specified task ID.

FUNCT=...
FUNCT defines the interface functionality used by the (related) application as a selection criterion for the applications and connections to be displayed.

FUNCT= *none
Selection criterion for the applications and connections to be displayed is not the interface functionality.

FUNCT=NEA
Selection criterion for the applications and connections to be displayed is the interface functionality NEA service.

FUNCT=ISO
Selection criterion for the applications and connections to be displayed is the interface functionality ISO service.

FUNCT=STREAMS
Selection criterion for the applications and connections to be displayed is the interface functionality SOCKET service.

PORT#=...
PORT# defines Port# or Port#'n as a selection criterion for the applications and connections to be displayed.

PORT#= *none
Selection criterion for the applications and connections to be displayed is not the Port# or Port#'n.

PORT#=(...)
Selection criterion for the applications and connections to be displayed is the specified Port# or Port#'n.

OWN=<integer 1..65535>
Selection criterion for the connections to be displayed is the Port# of the application or the local Port# of the connection.
If Port# 0 is specified, the OWN operand is ignored.

PART=<integer 1..65535>
Selection criterion for the connections to be displayed is the specified partner Port# of the connection.
If Port# 0 is specified, the PART operand is ignored.

CON#=...
CON# defines the internal (current) connection number as a selection criterion for the connections to be displayed.

CON#= *none
Selection criterion for the connections to be displayed is not the internal (current) connection number.

CON#=<integer 0..2147483647> / <x-string 1..8>
Selection criterion for the connections to be displayed is the specified internal (current) connection number CON#.

IPSEC=...
Defines whether the connection can be securely used via IPSec as a selection criterion.

IPSEC= *none
Selection criterion for the connections to be displayed is not secure use via IPSec.

IPSEC=NO
Selection criterion for the connections to be displayed is that the connection is not used securely via IPSec.

IPSEC=YES
Selection criterion for the connections to be displayed is that the connection is used securely via IPSec.

VLAN-ID=...
Defines whether the connection is assigned to a VLAN as a selection criterion.

VLAN-ID= *none
Selection criterion for the connections to be displayed is not the assignment to a VLAN.

VLAN-ID=*ALL
Selection criterion for the connections to be displayed is the assignment to a VLAN.

VLAN-ID=<integer 2 .. 4094>
Selection criterion for the connections to be displayed is that the connection is assigned to the VLAN with the specified VLAN ID.

ENDSYSTEM=...
Defines the partner processor of the connection as a selection criterion.

ENDSYSTEM= *none
Selection criterion for the connections to be displayed is not the partner processor.

ENDSYSTEM=<processor-name 1 .. 8>
Selection criterion for the connections to be displayed is the specified partner processor.

PROT=...
PROT defines the Layer 4 protocol used on the connection as a selection criterion.
Apart from the value *ALL, the remaining values can also be specified as a list (list-poss).

PROT= *none
Selection criterion for the connections to be displayed is not the Layer 4 protocol of the connection.

PROT=*ALL
Selection criteria for the connections to be displayed are all Layer 4 protocols.

PROT=LOCAL
Selection criterion for the connections to be displayed is the Layer 4 protocol local connection.

PROT=ISO4 / I4
Selection criterion for the connections to be displayed is the Layer 4 protocol ISO8073 Class 4.

PROT=TCP
Selection criterion for the connections to be displayed is the Layer 4 protocol TCP.

PARTNER=...
PARTNER defines the name of the partner application as a selection criterion.

PARTNER= *none
Selection criterion for the connections to be displayed is not the name of the partner application.

PARTNER=([NEA],<nea-name 1..16> / <c-string 1..16>)
The NEA name of the partner application is the selection criterion for the connections to be displayed.
For the NEA name, you use the first eight characters of the application name and the first eight characters of the processor name (one to eight alphanumeric characters in each case, left-justified, and padded with blanks). If the application name is shorter than eight characters, the NEA name must be specified as a C string.
If only the name part containing the NEA name is specified, the part containing the HOST name is derived from the HOST specification when BCAM is started.

PARTNER=(OSI,<osi-name 1..78> / <c-string 1..78> / <x-string 1..156>)
The OSI name of the partner application is a selection criterion for the connections to be displayed.
(1 to 78 alphanumeric characters)

PARTNER=(SOCKET,<socket-name 1..78> / <c-string 1..78> / <x-string 1..156>)
The SOCKET name of the partner application is a selection criterion for the applications to be displayed.
(1 to 78 alphanumeric characters)

MAXMSG#=...
Number of messages to be output for this command

MAXMSG#= *none
By default 50 messages may be output to SYSOUT and 10 displayed on the console.

MAXMSG#=<integer 1 .. 2147483647>
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 for the specified command.

Command logging

For reasons of compatibility, the processing acknowledgment is supplied in news BCA0763 if it is positive and in news BCA0762 if it is negative, followed by the message NBR0740. In addition, for positive acknowledgments, the messages BCA08E6, BCA08EE, BCA08ED, BCA08EB, BCA08EA, BCA08A1, BCA08A2, BCA08E8, BCA08A7, BCA08A8, BCA08E7, BCA08E2, BCA08E0 and BCA08F6 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	BCA0768	Syntax error in command
0       64	BCA07A4	Host does not exist
0       64	BCA08EF	Nothing found to display
0      128	BCA0814	BCAM is being terminated abnormally
0      128	BCA0816	BCAM is terminating
0      130	BCA0766	BCAM is not active