Atalla Boxcar Reference Guide (G06.24+)

Atalla Boxcar Reference Guide—526564-005
8
Boxcar Parameter Definitions
The following is a description of the Boxcar parameters, listed in alphabetical order.
BOXCAR-BACKUPCPU
Specifies the CPU number which runs the Boxcar backup process. This parameter is
optional, if not specified, Boxcar does not run as a persistent process pair.
BOXCAR-CRLF-REQUIRED
This parameter is required, if not specified, Boxcar logs an error, and terminates. Set
this parameter to YES if a Carriage Return and Line Feed (CRLF) characters should
be appended to each NSP response. Set this parameter to NO if the CRLF characters
should not be appended to each NSP response. Based on the value of this parameter
Boxcar will send a command 101 to the NSP to set option 23 to either enable or
disable the CRLF on the NSP’s response. A log entry will be generated based on the
value of this parameter. For example if this parameter is set to YES the following
message will appear in the Boxcar log.
Atalla NSP Option 23 will be disabled per your request. ( NSP
responses with CR/LF )
BOXCAR-DEBUG-FILE <File name>
This is the name of the debug file. The default value is blank meaning no debug file is
used.
If this parameter is provided, Boxcar tries to open the debug file, and logs a message
to the log file with the result of the OPEN operation on this file. This file must be an
existing enscribe, unstructured file. When the file is full, an error 45 is logged to EMS,
no further records are recorded.
The debug file contains two types of records:
Caution. If NSP option 23 is changed via the Secure Configuration Assistant (SCA) or via an
NSP command 101 after the Boxcar process has started, you must stop and restart the Boxcar
process prior to performing any other transactions using the SCA via the Atalla Secure Remote
Manager (ASRM), or sending commands that contain responses greater than 1024 bytes or
binary data. This ensures that Boxcar will correctly determine the status of NSP option 23.
Failure to stop and start Boxcar after NSP option 23 has been changed may result in a
situation where Boxcar will no longer process commands from host applications.
Caution. This feature will significantly degrade performance so it should only be used when
troubleshooting. It will record every command sent to the NSP and every NSP response, as
such, there is a potential security implication when using this feature. It should be noted that
significant disk space can be consumed by the debug file in high volume transaction
environments.