BCMAP: Delete mapping entries

BCMAP - Deleting mapping entries

FUNCT=...
	DELETE, ...
		|		SUBFUNCT = LOCAL, ... / GLOBAL, ... / SPECIAL, ... / HOST, ... / APPL, ... / ES, ... /
		|						PTSEL-N, ... / PTSEL-I, ... / PPORT#, ...
		|			LOCAL, ...
		|				|		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>
		|			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>
		|			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>
		|			HOST,...
		|				|		HOST = *default / <host-name 1 .. 8>
		|			APPL,...
		|				|		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>
		|			ES,...
		|				|		ES = <processor-name 1 .. 8>
		|			PTSEL-N,...
		|				|		PTSEL-N = *none / <name 1 .. 8>
		|				|		,ES = <processor-name 1 .. 8>
		|			PTSEL-I,...
		|				|		PTSEL-I = *none / <c-string 1 .. 32> / <x-string 1 .. 64> / (0)
		|				|		,ES = <processor-name 1 .. 8>
		|			PPORT# ,...
		|				|		PPORT# = *none / <integer 1 .. 65535> / <x-string 1 .. 4>
		|				|		, ES = <processor-name 1 .. 8>

FUNCT=DELETE,... 
Specifies the deletion of assignments as being the current function.

SUBFUNCT=LOCAL,...
The assignments specified for the application with the local name APPL (mandatory operand) in the host HOST are deleted.

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, the first eight characters of the application name and the first eight characters of the HOST name are to be used (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 of the application
1 to 78 alphanumeric characters

HOST=...
Name of the local host in which the application, defined by 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 deleted 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 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

SUBFUNCT=SPECIAL,...
The assignments between a partner application (NAME, ES) and the application APPL in the host HOST are deleted.
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 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

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

SUBFUNCT=HOST,...
The assignments for all applications residing in the host are deleted.

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 application APPL residing in the host is deleted.

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=ES,...
The assignments for all applications residing in the partner system ES are deleted.

ES=<processor-name 1..8>
Name of the partner end system

SUBFUNCT=PTSEL-N,...
The assignment for the application with the NEA transport selector PTSEL-N, which resides in the ES partner system, is deleted.

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 ISO transport selector PTSEL-I, which resides in the partner system ES, is deleted.

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.

ES=<processor-name 1..8>
Name of the partner end system

SUBFUNCT=PPORT#,...
The assignment for the application with the TCP/IP transport selector PPORT#, which resides in the ES partner system, is deleted.

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

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