BCSHOW for a named application | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
BCSHOW for all available applications or connections | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
APPLICATION=...
Using APPLICATION, you specify the name of the application for which information is displayed.
The information is displayed with console message BCA08E7.
APPLICATION=([NEA],<nea-name 1..16> / <c-string 1..16>)
The NEA name of the application for which information is 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.
APPLICATION=(OSI,<osi-name 1..78> / <c-string 1..78> / <x-string 1..156>)
The OSI name of the application for which information is displayed.
(1 to 78 alphanumeric characters)
APPLICATION=(SOCKET,<socket-name 1..78> / <c-string 1..78> / <x-string 1..156>)
The SOCKET name of the application for which information is displayed.
(1 to 78 alphanumeric characters)
SHOW=...
Using SHOW, you specify the additional information for display.
The values can also be specified as a list (list-poss).
SHOW= *none
No additional information is displayed.
SHOW=APPLICATION
If no application was named, information is displayed about all applications set up in this host using SHOW=APPLICATION.
The information is displayed with console message BCA08E7.
SHOW=TSAP-OPEN
Information is displayed about the opening of named applications (see APPLICATION=).
If no application was named, information is displayed about the opening of all applications set up in this host using SHOW=TSAP-OPEN.
The information is displayed with console message BCA08E2.
SHOW=CONNECTION
Information is displayed about connections which are maintained by the named application (see APPLICATION=).
In the event that no application was defined, information is displayed about all connections originating from this host, using SHOW=TSAP-OPEN=.
The information is displayed with console messages BCA08A1, BCA08A2, BCA08A7, BCA08A8 or BCA08E88 (depending on the INFO partner).
SHOW=ROUTE
Information is displayed about the routes which are occupied by this application.
The information is displayed with console messages BCA08E6 and BCA08EE.
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 messages 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 connections for which information is to be displayed.
SELECT= *none
No selection of the connections for which information is to be displayed is made.
SELECT=(...)
A selection of the 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 internal (current) application number APP#.
TSN=...
TSN defines the TSN of a task, which the (related) application has opened, as a 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, which the (related) application uses, 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 connections to be displayed.
PORT#= *none
Selection criterion for the connections to be displayed is not the Port# or Port#'n.
PORT#=(...)
Selection criterion for the 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.
A Port# 0 is regarded as a non-specified OWN operand.
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 which is used on the connection as a selection criterion.
Apart from the value *ALL, the remaining values can also be specified as a list (listposs).
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 a 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 connections 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, BCA08A1, BCA08A2, BCA08E8, BCA08E7, BCA08E2, BCA08A7, BCA08A8 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) | Maincode | Meaning |
| CMD0001 | Command successfully processed |
| BCA0768 | Syntax error in command |
| BCA0791 | Application is unknown |
| BCA08EF | Nothing found to display |
| BCA0814 | BCAM is being terminated abnormally |
| BCA0816 | BCAM is terminating |
| BCA0766 | BCAM is not active |