CREATE-PROCESSOR / CRPRR: Create processor

CREATE-PROCESSOR creates a (partner) processor and consequently provides part of the functionality of dynamic BCIN. If the CREATE-PROCESSOR command is executed successfully the processor has the status INCLUDED.

The alias name CRPRR exists for CREATE-PROCESSOR in order to provide SNMP support.

BS2000 console	BS2000 SDF command	Command/ SOF file	SNMP management	Parameter service
x	x	x	x

List of valid command sources

CREATE-PROCESSOR / CRPRR

PROCESSOR-NAME = <composed-name 1..8>

,SOCKETHOST-NAME = *PROCESSOR-NAME / *DYNAMIC / <composed-name 1 .. 32> / <c-string 1 .. 32>

,MAX-TSDU-SIZE = 4096 / <integer 4096 .. 65530>

,ROUTE-SELECTION = *SEQUENTIAL-WITH-RETRY / *SEQUENTIAL / *BALANCED-WITH-RETRY /

*BALANCED

,MAPPING = *ALLOWED / *NOT-ALLOWED

,ADMINISTRATION-TYPE = *UNKNOWN / *BCAM

PROCESSOR-NAME=<composed-name 1..8>
Name of the (partner) processor to be created.

SOCKETHOST-NAME=...
Specifies the socket host name of the (partner) processor.

SOCKETHOST-NAME=*PROCESSOR-NAME
The name defined for the (partner) processor with PROCESSOR-NAME is used as the socket host name.

SOCKETHOST-NAME=*DYNAMIC
The socket host name is taken from the socket host file as soon as the (partner) processor is assigned an IP route by means of CREATE-ROUTE (or BCIN GEN=).

SOCKETHOST-NAME=<composed-name 1..32> / <c-string 1..32>
Socket host name of the (partner) processor.

MAX-TSDU-SIZE=4096 / <integer 4096..65530>
This operand describes the maximum message length (in bytes) that the partner processor can receive.

ROUTE-SELECTION=...
ROUTE-SELECTION determines how transport connections are distributed over the routes to a (partner) processor when a connection is being actively established.

ROUTE-SELECTION=*SEQUENTIAL-WITH-RETRY
Sequential distribution (i.e. the next route is not tried until the maximum number of transport connections for the previous route has been reached) with repetition of the connection on a different route if the attempt using the currently selected route fails.

ROUTE-SELECTION=*SEQUENTIAL
Sequential distribution (i.e. the next route is not tried until the maximum number of transport connections for the previous route has been reached) without repetition of the connection on a different route if the attempt using the currently selected route fails.

ROUTE-SELECTION=*BALANCED-WITH-RETRY
Balanced distribution of transport connections across the routes with repetition of the connection on a different route if the attempt using the currently selected route fails.

ROUTE-SELECTION=*BALANCED
Balanced distribution of transport connections across the routes without repetition of the connection on a different route if the attempt using the currently selected route fails.

MAPPING=...
With MAPPING you specify whether the name of the (partner) processor can be used in a mapping definition (BCMAP command).

MAPPING=*ALLOWED
The name of the (partner) processor may be used in a mapping definition (BCMAP command).

MAPPING=*NOT-ALLOWED
The name of the (partner) processor may not be used in a mapping definition (BCMAP command).

ADMINISTRATION-TYPE=...
In ADMINISTRATION-TYPE you specify the administration type for the (partner) processor.

ADMINISTRATION-TYPE=*UNKNOWN
The administration type for the (partner) processor is unknown.

ADMINISTRATION-TYPE=*BCAM
The (partner) processor is administered by BCAM.

Command logging

Positive acknowledgments are supplied in news BCA0672, and negative acknowledgments in news BCA06C2.
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
0        1	CMD0202	Error in command
0        1	BCA0768	Syntax error in command
0       64	BCA0770	Parameter error
0       64	BCA0773	Incorrect data type for PROCESSOR-NAME
0       64	BCA07E0	Name is already being used as PROCESSOR-NAME
0       64	BCA07E3	Name is already being used as NODE-NAME
0       64	BCA07E4	Name is already being used as HOST-NAME
0       64	BCA0833	Name already exists
0      128	BCA0814	BCAM is being terminated abnormally
0      128	BCA0816	BCAM is terminating
0      130	BCA0766	BCAM is not active