The mapping function can only be used if BCAM mapping has already been explicitly started with BCMAP FUNCT=INIT.
When creating the mapping definition (FUNCT=DEFINE), you make the following specifications:
With SUBFUNCT= you specify the validity range of the definition.
With LOCAL, you assign, for example, ISO and/or TCP/IP attributes to a single application in the local host.
With SUBFUNCT=GLOBAL you declare a corresponding name in the local system for a particular application in the partner system.
SPECIAL defines the connection between a specific application in the local host and an application in the partner system.
Mapping entries are temporary BCAM entries, i.e. all entries are lost following a BCEND command or when the mapping function is terminated with BCMAP FUNCT=TERM, unless the entries are saved with BCMAP FUNCT=SAVE, FILE=filename. The saved definitions can be re-entered in BCAM with BCMAP FUNCT=ADD,FILE=<filename> when restarting BCAM (DCSTART) or the mapping function (BCMAP FUNCT=INIT).
Another option is to use the command GENERATE-BCMAP-FILE (see "GENERATE-BCMAP-FILE") to store the saved entries in a readable and editable command file. This approach is suitable for diagnostics, for example, or for editing purposes. The mapping definitions can then be copied back with the command CALL-BCAM-COMMANDS.
The following command can be used to check whether the mapping function is active:
/BCMAP FUNCT=SHOW,SUBFUNCT=STATE
Examples
/BCMAP FUNCT=DEFINE,SUBFUNCT=GLOBAL,NAME=UNKNOWN, -
/ ES=EXTERNPRO,PTSEL-I=X'4142434445'
This is the definition of the partner application UNKNOWN, which is located in the end system EXTERNPRO. The partner application is assigned the OSI transport selector X'4142434445'.
/BCMAP FUNCT=DEFINE,SUBFUNCT=GLOBAL,NAME=ANWENDXY, -
/ ES=FREMDPRO,ROUTES=(ROUTE#1,ROUTE#5)
This command defines the possible routes used when actively setting up a connection to the partner application ANWENDXY. The course of the routes is defined in the generation.