BCAPPL: Activate or deactivate application

You use this command to activate or deactivate a predefined, or, alternatively, deactivate any selected application. System applications, i.e. applications which begin with $, can only be deactivated using the BCAPPL FORCED-DEACTIVATION command.
A predefined application can only be reopened after deactivation if it has been activated using BCAPPL MODE=ACTIVATE. However, an application which is not predefined can be reopened at any time after it has been deactivated.

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

List of valid command sources

BCAPPL

APPLICATION = ( [ 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>
,MODE = ACTIVATE / DEACTIVATE / FORCED-DEACTIVATION
	DEACTIVATE, ...
		|		TYPE = QUICK / NORMAL, ...
		|			NORMAL, ...
		|				|		W = NO / YES

APPLICATION=...
Name of the application to be activated or deactivated.

APPLICATION=([NEA],<nea-name 1..16>/ <c-string 1..16>)
NEA name of the application to be activated or deactivated.
For NEA names, the first eight characters of the application name and the first eight characters of the host name are to be used (one to eight alphanumeric characters in each case, left-justified, and padded with blanks). If the application name is shorter than eight characters, then 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 operand.

APPLICATION=(OSI,<osi-name 1..78> / <c-string 1..78> / <x-string 1..156>)
OSI name of the application to be activated or deactivated.
(1 to 78 alphanumeric characters)

APPLICATION=(SOCKET,<socket-name 1..78> / <c-string 1..78> /  <x-string 1..156>)
SOCKET name of the application to be activated or deactivated.
(1 to 78 alphanumeric characters)

HOST=...
Name of the host in which the application resides

HOST= *default
The default value for the host name is the entry from the DCSTART or DCOPT command

HOST=<host-name 1..8>
Name of the host

MODE=...
Specifies the function to be executed:

MODE=ACTIVATE
The application is to be activated.

MODE=DEACTIVATE
The application is to be deactivated.

MODE=FORCED-DEACTIVATION
The system application is to be deactivated.

TYPE=...
Specifies the type of connection shutdown, only valid for MODE=DEACTIVATE.

TYPE=QUICK
Connection shutdown does not occur in the network.

TYPE=NORMAL
A connection shutdown occurs in the network.

W=...
Mode for warning about connection shutdown, only valid for TYPE=NORMAL.

W=NO
Specifies that the application is not to be warned about connection shutdown.

W=YES
Specifies that the application is to be warned about connection shutdown. With W=YES, all applications receive a warning about connection shutdown. After the warning time has expired, all remaining connections are automatically shut down.
The length of warning time is determined by the specification for the time interval between warnings (WARN operand in the BCTIMES command).

Command logging

For reasons of compatibility, positive acknowledgments are supplied in news BCA0763, and negative acknowledgments in news BCA0762, followed by the message NBR0740. In addition, for positive acknowledgments, the messages BCA08DF and BCA088F may also appear.
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	BCA0637	Activate/deactivate not executed
0        1	BCA0768	Syntax error in command
0       64	BCA0791	Application is unknown
0       64	BCA08E5	Application is unknown
0       64	BCA0850	Warning has been output
0      128	BCA0814	BCAM is being terminated abnormally
0      128	BCA0816	BCAM is terminating
0      130	BCA0766	BCAM is not active