Check21 Configuration

The component accepts one or more of the following configuration settings. Configuration settings are similar in functionality to properties, but they are rarely used. In order to avoid "polluting" the property namespace of the component, access to these internal properties is provided through the Config method.

Check21 Configuration Settings

ASCIIOutput: Indicates whether to output ASCII or EBCDIC.

If set to True, the component will create check21 files using the ASCII character set instead of the default EBCDIC character set.

Overwrite: Indicates whether local files can be overwritten.

If the file specified by Filename exists and Overwrite is False, BuildFile and BuildAndUploadFile will fail with an error indicating the file exists. Overwrite is true by default.

OverwriteRemoteFile: Indicates whether remote files can be overwritten on the FTP server.

If the file specified by RemoteFile exists and OverwriteRemoteFile is False, BuildAndUploadFile will fail with an error indicating the file exists. OverwriteRemoteFile is true by default.

ArchiveType: Indicates the type of archive that supports each Check in this file.

This code indicates the way the Checks are archived. Access method, availability, and timeframes shall be defined by clearing arrangements. Valid values for this field include:


" " (space)	Default value (not specified)
A	Microfilm.
B	Image.
C	Paper.
D	Microfilm and image.
E	Microfilm and paper.
F	Image and paper.
G	Microfilm, image, and paper.
H	Electronic Check Instrument.
I	None.

BOFDIndicator: Indicates whether the origin is also the bank of first deposit.

This code indicates whether the ECE institution specified in the Origin fields is the Bank of First Deposit (BOFD). Allowable values include:


Y	Indicates ECE institution is BOFD. (default)
N	Indicates ECE institution is not BOFD.
U	Indicates ECE institution relationship to BOFD is undetermined.

This setting is global for all checks.

AllowAllBOFDIndicators: Allows for any value to be specified within the BOFDIndicator field.

The default value is False, indicating that the BOFDIndicator is limited to the allowable values listed.

TestFile: Indicates whether the file being built is a test file or a production file.

The default value for TestFile is False, indicating that production files are being construction.

ResendIndicator: Indicates whether the file being built has been previously transmitted in its entirety.

The default value for this setting is False.

FileCreationDate: The date the file is created.

The component normally uses the current system date when building a file. You can override this functionality by setting the FileCreationDate manually through Config.

FileCreationTime: The time the file is created.

The component normally uses the current system time when building a file. You can override this functionality by setting the FileCreationTime manually through Config.

FileUserField: A User Field.

A field used at the discretion of users.

FedWorkType: Federal Reserve work type.

A code that specifies the Federal Reserve work type. Valid values include:


1	City.
2	City Group.
3	City Fine Sort.
4	RCPC.
5	RCPC Group.
6	RCPC Fine Sort.
7	High Dollar Group Sort.
8	Country.
9	Country Group Sort.
0	Country Fine Sort.
A	Other District.
B	Other District Group Sort.
C	Mixed.
D	City/RCPC Mixed.
E	Payor Group Sort.

IncludeAddendA: Whether to include Detail Addendum A Record.

Whether to include Detail Addendum A Record (Record 26) in the file. Default value is True. If set to False the Detail Addendum A Record will not be included in the file.

ReservedField: A field reserved for future use.

A field reserved for future use by the Accredited Standards Committee X9.

CashLetterCreationDate: The date the cash letter is created.

The component normally uses the current system date when building the cash letter inside a file. You can override this functionality by setting the CashLetterCreationDate manually through Config.

CashLetterCreationTime: The time the cash letter is created.

The component normally uses the current system time when building a the cash letter inside a file. You can override this functionality by setting the CashLetterCreationTime manually through Config.

CountryCode: A code that identifies the country in which the payor bank is located.

The default is "US".

FileId: A code used to uniquely identify this file.

This 1-character code permits multiple files, created on the same date, same time, and between the same institutions to be distinguished from one another. This property is part of the File Header record (type 01), and has a default value of "0".

BundleCount: Total number of bundles in the file.

By default, each cash letter contains one bundle. If you wish to specify multiple bundles, increase the BundleCount and then set the BundleIndex to the bundle you wish to operate on. The CycleNumber, ReturnRoutingNumber, and Checks properties should be set for each bundle contained in the file.

BundleCreationDate: The date the bundle is created.

The component normally uses the current system date when building the bundle inside a file. You can override this functionality by setting the BundleCreationDate manually through Config.

BundleId: Unique identifier for the bundle inside the Cash Letter.

The component normally uses the same CashLetterId as the BundleId when constructing a bundle header record. You can override this functionality by setting the BundleId manually through Config.

BundleIndex: Index of the current bundle.

ReturnAcceptance: A code that indicates whether the institution that creates this file will or will not support electronic return processing.

Valid values include:


0	Will not accept any electronic information (default).
1	Will accept preliminary return notifications, returns, and final return notifications.
2	Will accept preliminary return notifications and returns.
3	Will accept preliminary return notifications and final return notifications.
4	Will accept returns and final return notifications.
5	Will accept preliminary return notifications only.
6	Will accept returns only.
7	Will accept final return notifications only.
8	Will accept preliminary return notifications, returns, final return notifications, and image returns.
9	Will accept preliminary return notifications, returns, and image returns.
A	Will accept preliminary return notifications, final return notifications, and image returns.
B	Will accept returns, final return notifications, and image returns.
C	Will accept preliminary return notifications and image returns.
D	Will accept returns and image returns.
E	Will accept final return notifications and image returns.
F	Will accept image returns only.

DetailAddendumRecordNumber: The Check Detail Addendum A Record Number.

This field is used to specify the record number within the Check Detail Addendum A Record. The default value used is '0' but can be changed with this field.

CheckIsCredit[i]: Indicates whether a Check is to be sent as a Credit (61) Record.

Valid array indices are from 0 to Checks.Count - 1.

When set to True, the Check at the specified index 'i' will be sent as a Credit Record (61) within the X9.37 file. The DocumentationType is used in the creation of this record as are the following Checks fields: MICRAuxOnUs, MICRProcessingCode, MICRRoutingNumber, MICROnUs, Amount, and SequenceNumber. The default value is False.

Base Configuration Settings


	GUIAvailable: Tells the component whether or not a message loop is available for processing events. In a GUI-based application, long-running blocking operations may cause the application to stop responding to input until the operation returns. The component will attempt to discover whether or not the application has a message loop and, if one is discovered, it will process events in that message loop during any such blocking operation. In some non-GUI applications an invalid message loop may be discovered that will result in errant behavior. In these cases, setting GuiAvailable to false will ensure that the component does not attempt to process external events.
	UseBackgroundThread: Whether threads created by the component are background threads. If set to True, when the component creates a thread the thread's IsBackground property will be explicitly set to True. By default this setting is False.
	UseManagedSecurityAPI: Tells the component whether or not to use the system security libraries or a managed implementation. By default the component will use the system security libraries to perform cryptographic functions. This means calls to unmanaged code will be made. In certain environments this is not desirable. To use a completely managed security implementation set this setting to True. Setting this to True tells the component to use the internal managed implementation instead of using the system's security API. Note that when this value is set the product's system dll is no longer required as a reference, as all unmanaged code is stored in this file.