BCMAP: Manage mapping function

In order to have the previously made assignments and definitions available again for the next session, the following must be noted:
Before BCEND, save relevant assignments and definitions with:

/BCMAP FUNCT=SAVE,FILE=MY.BEST.MAPPINGS

After /DCSTART, retrieve the saved assignments and definitions with the following entries:

/BCMAP FUNCT=INIT
/BCMAP FUNCT=ADD,FILE=MY.BEST.MAPPINGS

In addition, you can 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 retrieved with the command CALL-BCAM-COMMANDS.

BCMAP - Managing the mapping function

FUNCT=...
	ADD,...
		|		FILE = <filename>
	INIT ,...
		|		MAXMAP = 500 / <integer 1 .. 100000>
	REORG,...
		|		MAXMAP = 500 / <integer 1 .. 100000>
	SAVE,...
		|		FILE = <filename>
	TERM

FUNCT=...
Current function of the command

ADD,...
The assignments saved in the file FILE using the SAVE function are used. Existing assignments remain valid.

FILE=<filename>
Fully qualified file name, which contains the saved assignments.
The file must always be cataloged in the home pubset, otherwise errors may occur in connection with files cataloged on data pubsets or shared pubsets. In addition, no temporary file name may be used.

INIT,...
The BCAM mapping function is initialized for the maximum number of assignments specified with MAXMAP.

MAXMAP=<integer 1..100000>
Using MAXMAP, the maximum number of assignments permitted is defined.
Default: 500

REORG,...
The maximum number of assignments defined using INIT is modified according to the specification in MAXMAP.

MAXMAP=<integer 1..100000>
Using MAXMAP, the maximum number of assignments permitted is defined.
Default: 500

MAP initialization for the BCAM command BCMAP FUNCT=INIT before the start of openFT always takes place with default values. If you use the MAXMAP parameter for the BCAM command BCMAP FUNCT=INIT then the command must therefore be initiated before the start of openFT. This should be one of the first commands in the SOF file.

SAVE,...
All assignments existing at the time are saved in the file defined using FILE.

FILE=<filename>
Fully qualified file name, which contains the saved assignments. The file must always be cataloged in the home pubset, otherwise errors may occur in connection with files cataloged on data pubsets or shared pubsets. In addition, no temporary file name may be used.

TERM
Termination of the BCAM mapping function.

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