BCMAP: Ändern von Mapping-Einträgen

BCMAP - Ändern von Mapping-Einträgen

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>

SUBFUNCT=GLOBAL,...
legt als aktuelle Funktion das Ändern von Zuordnungen fest.

FUNCT=CHANGE,...
Es werden die Routen für den Verbindungsaufbau von einer Anwendung zu einer bestimmten Partneranwendung (NAME, ES) geändert.
NAME und ES sind in diesem Fall Pflichtoperand.

HOST=...
Name des eigenen bzw. virtuellen Host, dem der Mapping-Eintrag zugeordnet ist.

HOST=*default
Hostname, der bei DCSTART/DCOPT als Name des BS2000-Systems festgelegt wird.

HOST=<host-name 1..8>
NEA-Name des Host

NAME=...
Name der Anwendung im Partnerrechner 

NAME=([NEA],<nea-name 1..16> / <c-string 1..16>)
NEA-Name für die Partneranwendung (16 alphanumerische Zeichen, linksbündig und mit Leerzeichen aufgefüllt).
Ist nea-name kürzer als neun Zeichen, so werden die Stellen 9 bis 16 durch die Angaben beim Operanden ES bestimmt.

NAME=(OSI,<osi-name 1..78> / <c-string 1..78> / <x-string 1..156>)
OSI-Name für die Partneranwendung
1 bis 78 alphanumerische Zeichen

NAME=(SOCKET,<socket-name 1..78> / <c-string 1..78> /<x-string 1..156>)
SOCKET-Name für die Partneranwendung
1 bis 78 alphanumerische Zeichen

ES=<processor-name 1..8>
Name des Partner-Endsystems

ROUTES=...
Namen der Route(n), über die beim Verbindungsaufbau das Partner-Endsystem erreicht wird (siehe Makro XPRO, Operand ROUTNAM).

ROUTES=*none
Keine Angabe von Routennamen.

ROUTES=list-poss(8):<rout-name 1..8>
Es ist eine Liste von maximal acht Routennamen zulässig.

SUBFUNCT=SPECIAL,...
Es werden die Routen für den Verbindungsaufbau von der Anwendung APPL zu einer bestimmten Partneranwendung (NAME, ES) geändert.
APPL, NAME und ES sind in diesem Fall Pflichtoperanden.

APPL=...
Name der Anwendung im Host

APPL=([NEA],<nea-name 1..16> / <c-string 1..16>)
NEA-Name für die Anwendung.
Für den NEA-Namen sind die ersten acht Zeichen des Anwendungsnamens und die ersten acht Zeichen des Rechnernamens zu verwenden (jeweils 1 bis 8 alphanumerische Zeichen, linksbündig und mit Leerzeichen aufgefüllt).
Ist der Anwendungsname kürzer als 8 Zeichen, muss der NEA-Name als c-string angegeben werden.
Ist nur der Anwendungs-Namensteil angegeben, so wird der HOST-Namensteil aus der HOST-Angabe beim BCAM-Start gebildet.

APPL=(OSI, <osi-name 1..78> / <c-string 1..78> / <x-string 1..156>)
OSI-Name für die Anwendung
1 bis 78 alphanumerische Zeichen

APPL=(SOCKET,<socket-name 1..78> / <c-string 1..78>) /<x-string 1..156>)
SOCKET-Name für die Anwendung
1 bis 78 alphanumerische Zeichen

HOST=...
Name des eigenen Hosts, in dem die mit APPL definierte Anwendung residiert.

HOST=*default
Name des Standardhosts, der bei DCSTART/DCOPT als Hostname festgelegt wird.

HOST=<host-name 1 ... 8>
Name des Hosts

NAME=...
Name der Anwendung im Partnerrechner

NAME=([NEA],<nea-name 1..16> / <c-string 1..16>)
NEA-Name für die Partneranwendung (16 alphanumerische Zeichen, linksbündig und mit Leerzeichen aufgefüllt).
Ist nea-name kürzer als neun Zeichen, so werden die Stellen 9 bis 16 durch die Angaben beim Operanden ES bestimmt.

ES=<processor-name 1..8>
Name des Partner-Endsystems

ROUTES=...
Namen der Route(n), über die beim Verbindungsaufbau das Partner-Endsystem erreicht werden soll (siehe Makro XPRO, Operand ROUTNAM).

ROUTES=*none
Keine Angabe von Routennamen.

ROUTES=list-poss(8):<rout-name 1..8>
Es ist eine Liste von maximal acht Routennamen zulässig. 

Kommando-Protokollierung

Die Verarbeitung wird aus Kompatibilitätsgründen im Positiv-Fall mit der News BCA0763 und im Negativ-Fall mit der News BCA0762 quittiert. Im Positiv-Fall erscheint die Meldung BCA062E.
Die Beschreibung der bei der Kommandobearbeitung eventuell auftretenden Fehlermeldungen entnehmen Sie bitte der folgenden Tabelle. 

Kommando-Returncodes

(SC2)      SC1	Maincode	Bedeutung
0        0	CMD0001	Kommando erfolgreich abgearbeitet
2        0	BCA062F	Kommando nicht erfolgreich abgearbeitet
0        1	BCA0768	Syntaxfehler im Kommando
0       64	BCA076A	Fehler im Kommando /BCMAP
0      128	BCA0814	BCAM wird gerade abnormal beendet
0      128	BCA0816	BCAM befindet sich im Beendigungszustand
0      130	BCA0766	BCAM ist nicht aktiv