BCMAP - Defining mapping entries | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
FUNCT=DEFINE,...
Specifies the entry of new assignments as being the current function.
SUBFUNCT=LOCAL,...
A transport selector TSEL-N, TSEL-I and OPORT# can be assigned to the application with the local name APPL (mandatory operand in this context) in the host HOST for communication with any partner applications.
APPL=...
Name of the application in the host.
APPL=([NEA],<nea-name 1..16> / <c-string 1..16>)
NEA name for the application.
For NEA names, 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 specification for the HOST 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
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.
TSEL-N=...
Defines the transport selector in the case of NEA transport connections for the local application APPL.
TSEL-N= *none
No specification of an NEA transport selector.
TSEL-N=<name 1..8>
NEA transport selector for the application APPL.
TSEL-I=...
Transport selector in the case of OSI transport connections for the local application APPL.
TSEL-I= *none
No specification of an ISO transport selector.
TSEL-I=<c-string 1..32> / <x-string 1..64>
ISO transport selector for the application APPL.
OPORT#=...
Port number of the local application APPL in the case of TCP transport connections.
OPORT#= *none
No specification of a port number.
OPORT#=<integer 1..65535> / <x-string 1..4>
Port number for the transport address of the application.
SUBFUNCT=GLOBAL,...
For communication with any applications in the host HOST, the following can be assigned to the partner application with the name NAME in the end system ES:
transport selectors PTSEL-N, PTSEL-I, PPORT#
a list of route names ROUTES
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 defined 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
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.
PTSEL-I=...
Transport selector in the case 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 the length 0 for the partner application NAME.
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.
ROUTES=...
Name of the route(s), via which the partner end system is to be accessed when the connection is established (see XPRO macro, ROUTNAM operand).
ROUTES= *none
No specification of route names.
ROUTES=list-poss (8): <rout-name 1..8>
A list with a maximum of eight route names is valid.
SUBFUNCT=SPECIAL,...
For communication between two specified applications, transport selectors (TSEL-N, TSEL-I, OPORT#) can be assigned to the local application with the local name APPL in the host HOST, while transport selectors, an end system name, a list of routes and Layer 3 user data can be assigned to the partner application NAME in the end system. 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 defined using the specifications in the ES operand.
ES=<processor-name 1..8>
Name of the partner end system
TSEL-N=...
Defines the transport selector in the case of NEA transport connections for the local application APPL.
TSEL-N= *none
No specification of an NEA transport selector.
TSEL-N=<name 1..8>
NEA transport selector for the application APPL.
TSEL-I=...
Transport selector in the event of OSI transport connections for the local application APPL.
TSEL-I= *none
No specification of an ISO transport selector.
TSEL-I=<c-string 1..32> / <x-string 1..64>
ISO transport selector for the application APPL.
TSEL-I=(0)
ISO transport selector with length 0 for the application APPL.
OPORT#=...
Port number of the local application APPL in the case of TCP transport connections.
OPORT#= *none
No specification of a port number.
OPORT#=<integer 1..65535> / <x-string 1..4>
Port number for the transport address of the application.
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.
PTSEL-I=...
Transport selector in the case 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.
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.
ROUTES=...
Names of the route(s), via which the partner end system is accessed when the connection is established (see XPRO macro, ROUTNAM operand).
ROUTES= *none
No specification of route names.
ROUTES=list-poss (8) : <rout-name 1..8>
A list with a maximum of eight route names is valid.
Command logging
For reasons of compatibility, positive acknowledgments are supplied in news BCA0763, and negative acknowledgments in news BCA0762, followed by the message NBR0740. For positive acknowledgments the message BCA062E appears.
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 |
| 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 |