BCMAP: Modify mapping entries

BCMAP - Modifying mapping entries

FUNCT=...

CHANGE, ...

|

SUBFUNCT = GLOBAL, ... / SPECIAL, ...

|

GLOBAL, ...

|

|

HOST = *default / <host-name 1 .. 8>

|

|

,NAME = ( [ 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>)

|

|

,ES = <processor-name 1 .. 8>

|

|

,ROUTES = *none / list-poss (8): <rout-name 1 .. 8>

|

SPECIAL, ...

|

|

APPL = ( [ 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>)

|

|

,HOST = *default / <host-name 1 .. 8>

|

|

,NAME = ( [ NEA ] , <nea-name 1 .. 16> / <c-string 1 .. 16> )

|

|

,ES = <processor-name 1 .. 8>

|

|

,ROUTES = *none / list-poss (8): <rout-name 1 .. 8>

FUNCT=CHANGE,...
Specifies modification of assignments as being the current function.

SUBFUNCT=GLOBAL,...
The routes for connection establishment from an application to a specific partner application (NAME, ES) are modified.
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

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.

SUBFUNCT=SPECIAL,...
The routes for connection establishment from the application APPL to a specific partner application (NAME, ES) are modified.
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 or 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.

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

ROUTES=...
Names of the route(s), via which the partner 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.

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)      SC1	Maincode	Meaning
0        0	CMD0001	Command successfully processed
2        0	BCA062F	Command not processed successfully
0        1	BCA0768	Syntax error in command
0       64	BCA076A	Error in command /BCMAP
0      128	BCA0814	BCAM is being terminated abnormally
0      128	BCA0816	BCAM is terminating
0      130	BCA0766	BCAM is not active