With the SHOW function, the BCMAP command does not automatically provide a complete overview of the assignments that were made. You can obtain information on assignments which were made for specific applications, partners, or partner systems, by specifying the APPL, NAME, or ES operands respectively.
BCMAP - Displaying mapping entries | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
FUNCT=SHOW,...
Specifies the display of assignments as being the current function.
SUBFUNCT=LOCAL,...
Assignments which were specified for the application with the local name APPL (mandatory operand) in the host HOST, are displayed.
APPL=...
Name of the application in the host
APPL=([NEA],<nea-name 1..16> / <c-string 1..16>)
NEA name for the application.
For the NEA name, you use the first eight characters of the application name and the first eight characters of the HOST name (1 to 8 alphanumeric characters in each case, left-justified, and padded with blanks).
If the application name is shorter than 8 characters, the NEA name must be specified as a C string.
If only the name part containing the application name is specified, the part containing the HOST name is derived from the HOST specification when BCAM is started.
APPL=(OSI,<osi-name 1..78> / <c-string 1..78> / <x-string 1..156>)
OSI name for the application
1 to 78 alphanumeric characters
APPL=(SOCKET,<socket-name 1..78> / <c-string 1..78> / <x-string 1..156>)
SOCKET name for the application
1 to 78 alphanumeric characters
HOST=...
Name of the local host in which the application, defined using APPL, resides.
HOST= *default
Name of the default host, which is specified as the host name in DCSTART/DCOPT.
HOST=<host-name 1..8>
Name of the host
SUBFUNCT=GLOBAL,...
The assignments for partner applications with the name NAME are displayed in the end system ES.
NAME and ES are mandatory operands in this context.
HOST=...
Name of the local or virtual host to which the mapping entry is assigned.
HOST= *default
Host name that is specified as the name of the BS2000 system in DCSTART/DCOPT.
HOST=<host-name 1..8>
NEA name of the host.
NAME=...
Name of the application in the partner system
NAME=([NEA],<nea-name 1..16> / <c-string 1..16>)
NEA name for the partner application (16 alphanumeric characters, left-justified, and padded with blanks)
If nea-name is shorter than nine characters, positions 9 through 16 are determined using the specifications in the ES operand.
NAME=(OSI,<osi-name 1..78> / <c-string 1..78> / <x-string 1..156>)
OSI name for the partner application
1 to 78 alphanumeric characters
NAME=(SOCKET,<socket-name 1..78> / <c-string 1..78> / <x-string 1..156>)
SOCKET name for the partner application
1 to 78 alphanumeric characters
ES=<processor-name 1..8>
Name of the partner end system
SUBFUNCT=SPECIAL,...
The assignments between a partner application (NAME, ES) and the application APPL in the host HOST are displayed.
APPL, NAME, and ES are mandatory operands in this context.
APPL=...
Name of the application in the host
APPL=([NEA],<nea-name 1..16> / <c-string 1..16>)
NEA name for the application.
For the NEA name, you use the first eight characters of the application name and the first eight characters of the HOST name (1 to 8 alphanumeric characters, left-justified, and padded with blanks).
If the application name is shorter than 8 characters, the NEA name must be specified as a C string.
If only the name part containing the application name is specified, the part containing the HOST name is derived from the HOST specification when BCAM is started.
APPL=(OSI,<osi-name 1..78> / <c-string 1..78> / <x-string 1..156>)
OSI name for the application
1 to 78 alphanumeric characters
APPL=(SOCKET,<socket-name 1..78> / <c-string 1..78> / <x-string 1..156>)
SOCKET name for the application
1 to 78 alphanumeric characters
HOST=...
Name of the local host in which the application, defined using APPL, resides.
HOST= *default
Name of the default host, which is specified as the host name in DCSTART/DCOPT.
HOST=<host-name 1..8>
Name of the host
NAME=...
Name of the application in the partner system
NAME=([NEA],<nea-name 1..16> / <c-string 1..16>)
NEA name for the partner application (16 alphanumeric characters, left-justified, and padded with blanks)
If nea-name is shorter than nine characters, positions 9 through 16 are determined using the specifications in the ES operand.
ES=<processor-name 1..8>
Name of the partner end system
SUBFUNCT=HOST,...
The assignments for all applications residing in the host are displayed.
HOST=...
Name of the local host in which the application, defined using APPL, resides.
HOST= *default
Name of the default host, which is specified as the host name in DCSTART/DCOPT.
HOST=<host-name 1..8>
Name of the host
SUBFUNCT=APPL,...
The assignment for the APPL application, which resides in the host HOST, is displayed.
APPL=...
Name of the application in the host
APPL=([NEA],<nea-name 1..16> / <c-string 1..16> )
NEA name for the application.
For the NEA name, you use the first eight characters of the application name and the first eight characters of the HOST name (1 to 8 alphanumeric characters, left-justified, and padded with blanks).
If the application name is shorter than 8 characters, the NEA name must be specified as a C string.
If only the name part containing the application name is specified, the part containing the HOST name is derived from the HOST specification when BCAM is started.
APPL=(OSI,<osi-name 1..78> / <c-string 1..78> / <x-string 1..156>)
OSI name for the application
1 to 78 alphanumeric characters
APPL=(SOCKET,<socket-name 1..78> / <c-string 1..78> / <x-string 1..156>)
SOCKET name for the application
1 to 78 alphanumeric characters
HOST=...
Name of the local host in which the application, defined using APPL, resides.
HOST= *default
Name of the default host, which is specified as the host name in DCSTART/DCOPT.
HOST=<host-name 1..8>
Name of the host
SUBFUNCT=ES,...
The assignments for all applications residing in the partner system ES are displayed.
ES=<processor-name 1..8>
Name of the partner end system
SUBFUNCT=PTSEL-N,...
The assignment for the application with the transport selector PTSEL-N, which resides in the partner system ES, is displayed.
PTSEL-N=...
Defines the transport selector in the case of NEA transport connections for the application in the partner system.
PTSEL-N= *none
No specification of an NEA transport selector.
PTSEL-N=<name 1..8>
NEA transport selector for the partner application NAME.
ES=<processor-name 1..8>
Name of the partner end system
SUBFUNCT=PTSEL-I,...
The assignment for the application with the transport selector PTSEL-I, which resides in the partner system ES, is displayed.
PTSEL-I=...
Transport selector in the event of ISO transport connections for the application in the partner system.
PTSEL-I= *none
No specification of an ISO transport selector.
PTSEL-I=<c-string 1..32> / <x-string 1..64>
ISO transport selector for the partner application NAME.
PTSEL-I=(0)
ISO transport selector with length 0 for the partner application NAME.
ES=<processor-name 1..8>
Name of the partner end system
SUBFUNCT=PPORT#,...
The assignment for the application with the transport selector PPORT#, which resides in the partner system ES, is displayed.
PPORT#=...
Port number of the TCP/IP partner application.
PPORT#= *none
No specification of a port number.
PPORT#=<integer 1..65535> / <x-string 1..4>
Port number for the transport address of the partner application.
ES=<processor-name 1..8>
Name of the partner end system
SUBFUNCT=STATE
The state of the BCAM mapping function is displayed with message BCA0870.
MAXMSG#=...
The number of messages output for mapping entries are restricted.
MAXMSG#=10
The number of messages output for mapping entries is restricted to the default value 10.
MAXMSG#=<integer 1..2147483647>
The number of messages output for mapping entries is restricted to the specified value.
Command logging
For reasons of compatibility, positive acknowledgments are supplied in news BCA0763, and negative acknowledgments in news BCA0762.
If processing is successful, the messages BCA0870 (BCAM mapping status), BCA087A (BCAM mapping entry), BCA087C (existence of BCAM mapping host entries) and BCA062E are issued.
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 |
| BCA062F | Command not processed successfully |
| BCA0870 | Output of the BCAM mapping status |
| BCA087A | Output of a BCAM mapping definition |
| BCA0768 | Syntax error in command |
| BCA076A | Error in command /BCMAP |
| BCA0814 | BCAM is being terminated abnormally |
| BCA0816 | BCAM is terminating |
| BCA0766 | BCAM is not active |