NLS Service

Watch the training video

The NLS Service can be used to schedule the accrual process, report generation, ACH processing, archiving, and other processes that are routinely run without the need for user interaction.

The NLS Service is not installed by default on client computers and should only be installed on those computers intended to run an automated process. During the installation process, the NLS Service may be installed by selecting Custom/Complete installation and selecting the NLS Service from the list of items to install.

ASP/Switch

For ASP/Switch customers, NLS Service is already installed and ready to use in the hosted environment. Configuration is not necessary. Skip ahead to Automated Accruals.

Configuration

Navigate to the bin directory (C:\Program Files (x86)\Nortridge Software\NLS\bin) and double click NLSServiceMonitor.exe. If you receive the error message below, you will need to right-click the NLSServiceMonitor.exe and select Run as administrator.

This will present the following dialog box:

If you had a previous version of the NLSService Installed, you will see a different dialog box which will give you the option to remove the old NLSService—click Yes. After the old Service has been removed, click File > Connect to another computer. Select the computer that you want to connect to and you will then be to the screen shown above, where you may proceed with the remaining steps.
Fill in the Windows account information and click OK.
Start the service by clicking on the toolbar.
Right-click on Local Computer and select Add Server.
Fill out the database information.
This will scan the available NLS databases on the server. If there are several databases, the process could take some time. Once it is complete, select the NLS database for which you want to configure the service and click OK.
After the database has been added, it will appear in the tree of the Service Monitor.

Go to Edit > Options and fill out a path for the log file (optional) and the path of the folder where NLS is installed.

To view the log in its entirety, open the log file using a text editor.

NLS 5.33 and before

The Log view will display the first 100 events in the log file.

NLS 5.34 and later

The Log view will display the most recent 100 events in the log file.

NLS 5.36.2 and later

The Enable NLS Email Service option allows for controlling which NLSService Host can run the emailer service to limit the use of computing resources in a farm of servers. Selecting Enable NLS Email Service will allow the NLSMailService.exe to execute on this service host (this is the default behavior). Selecting Run Mail Service Only will allow NLSService to only run NLSMailService.exe and no other services.

Email/SMS Notifications

NLS 5.29 and later

Click Email/SMS Notifications in the Advanced Options dialog to configure NLSServiceHost to send an email or SMS text message when an error, warning, or success conditions occur.

SMS notifications are sent via email. Enter the email address for the carrier shown below substituting cellnumber with the actual phone number (e.g. 15555555555@txt.att.net).

Carrier	Email Address
AT&T	cellnumber@txt.att.net
Verizon	cellnumber@vtext.com
T-Mobile	cellnumber@tmomail.net
Sprint PCS	cellnumber@messaging.sprintpcs.com
Virgin Mobile	cellnumber@vmobl.com
US Cellular	cellnumber@email.uscc.net
Nextel	cellnumber@messaging.nextel.com
Boost	cellnumber@myboostmobile.com
Alltel	cellnumber@message.alltel.com

Option	Comments
Send on error	A notification is sent when an error occurs.
Send on warning	A notification is sent when there are CPU/database utilization errors or when a service fails to start two times in a row (an error message is sent when a service fails to start the third time).
Send on success	A notification is sent when a job has completed successfully. The service host itself does not send success notifications.

Proceed with the configuration under NLS Service in System Setup to set up your accrual automation.

Setting up Scheduled Services

In Setup > System > NLS Service, click Add to add a new scheduled process. In the configuration window, enter a description and the desired time of execution.

NLS 5.35 and LaterNLS 5.34 and Before

NLS 5.35 and later

Select Execute on Schedule and enter the time and frequency to execute this service or select Execute After and select a service. If Execute After is selected, this service job will only execute after the selected service has completed successfully. If one service in a chain of sequential jobs fail, the whole sequence will stop at that point.

To delete an existing scheduled service, select the service and click Modify then click Delete.

See the sections below for configuring NLS Service for different target types.

Notifications

Some scheduled services can be configured to send an email notification on an error, warning, or success condition. This option is only available if an email server is configured as the default email server in Setup > System > Communication. Select Send notification, if available, and click to configure this option. See the Email/SMS Notifications section above for details on using email to send SMS text messages.

Automated Accruals

Parameter	Notes
`/Y`	Use yesterday’s date.
`/G =` loan group number5.16+	The loan group number. Multiple group numbers may be specified separated with a comma.
`/Z =` state5.16+	2-letter US state or Canadian province code.
`/L =` acctrefno5.16+
`/I =` CPU check interval5.20+	The interval between CPU load checks in seconds. To disable CPU load checks, set to 0. This parameter is optional and must be set in conjunction with `/J` or `/K`.
`/J =` minimum CPU load5.20+	An integer representing the minimum CPU load that must be attained before additional thread for accrual is added to the process. Up to 150% of the specified maximum thread count is added. This parameter is optional and must be set in conjunction with `/I`.
`/K =` maximum CPU load5.20+	An integer representing the maximum CPU load that must be attained before a thread for accrual is removed from the process. Thread count is reduced to no less than 50% of the specified maximum thread count. This parameter is optional and must be set in conjunction with `/I`.

Automated Report Generation

Options	Notes
Send Output To Printer	Generated reports are output to the default printer. Cannot be used in the Switch environment.
Save Report to NLS	Generated reports are saved under the stored parameter.
Send Report to E-mail5.20+	Generated reports are emailed to the specified email address using the default outgoing email server. Multiple email addresses may be entered separated by a semi-colon “;”. The email will be sent at the scheduled time the report generation service is executed. The Time to Send parameter specified for the email server in Communication setup is not observed when sending email through NLS Service. Errors and logs of emailed reports are handled by the email server. Specify the email’s subject and the filename to use for the attached report. The subject will default to “Saved Reports” and the filename will default to “savedreport” if the respective fields are not specified.5.28+ Note Check with your organization’s policy on emailing reports as some reports may contain confidential information.
Save Report to a Physical Location	Generated reports are saved to the specified path. Specify the full path including the filename in the field provided. Existing file with the same filename will be overwritten. Specify the full path including the filename in the Filename Parameters field.5.23+ The file name may be formed from the following variables: `%m` = Month as a decimal number (01-12) `%d` = Day of month as a decimal number (01-31) `%y` = Year without century as a decimal number (00-99) `%Y` = Year in four digit format (yyyy) `%H` = Hour in 24-hour format (00-23) `%I` = Hour in 12-hour format (01-12) `%M` = Minute as decimal number (00-59) `%S` = Second as decimal number (00-59)
Save Report via SFTP5.14+	Generated reports are transmitted to the selected SFTP server. SFTP servers are configured in Setup > System > SFTP Settings. By default the name of the report is used as the filename. A different filename may be specified in the Filename Parameters field. Only the filename is needed as the path specified in SFTP Settings is used.5.23+ The file name may be formed from the following variables: `%m` = Month as a decimal number (01-12) `%d` = Day of month as a decimal number (01-31) `%y` = Year without century as a decimal number (00-99) `%Y` = Year in four digit format (yyyy) `%H` = Hour in 24-hour format (00-23) `%I` = Hour in 12-hour format (01-12) `%M` = Minute as decimal number (00-59) `%S` = Second as decimal number (00-59)
Delete Old Saved Reports	Saved reports in NLS matching the selected criteria are deleted.
Override Temp Directory5.21+	The specified directory is used to store temporary files during the service execution.

Automated ACH (NACHA) File Creation

Parameter	Notes
`/C =` US \| CA	ACH or AFT. Optional `US` = U.S. ACH (default) `CA` = Canadian AFT
`/H =` company header	ACH Company Header code number. Required
`/A =` ach company	ACH Company code number. Optional
`/G =` loangroup(s)	List of loan group numbers. Multiple loan groups should be separated with a comma. Optional
`/M = +`/`-` day	Defines the date to run the ACH through, relative to the current system date. This date must be later than the date specified by `/N`. Optional
`/N = +`/`-` day5.16+	Defines the date from which to run the ACH, relative to the current system date. This date must be earlier than the date specified by `/M`. Optional
`/L =` acctrefno5.16+	Acctrefno of the loan for which to process the ACH. Optional
`/Z =` billing type5.16+	Valid values are: Optional `0` = All (default) `1` = Billing `2` = One Time `3` = Recurring
`/K =` loan class 1	List of Loan Class 1, separated by commas.
`/I`5.35.0 - 5.35.265.36 - 5.42	Process same day. Must specify `/A` and is only applicable when the specified ACH Company has its Allow same-day processing option selected.
`/J =` batch details5.42+	ACH/AFT batch reference and UDF 1-5, separated by semicolons.
`/F =` filename	Location and name of the NACHA output file. Required Note This parameter is not supported on our Switch environment for ASP customers. The file can be retrieved via SFTP. The file name may be formed from the following variables: `%m` = Month as a decimal number (01-12) `%d` = Day of month as a decimal number (01-31) `%y` = Year without century as a decimal number (00-99) `%Y` = Year in four digit format (yyyy) `%H` = Hour in 24-hour format (00-23) `%I` = Hour in 12-hour format (01-12) `%M` = Minute as decimal number (00-59) `%S` = Second as decimal number (00-59)

Automated Credit Bureau Report Generation

Parameter	Notes
`/H =` header ID	Credit Bureau Header code. Required
`/F =` filename	Location and name of the output file. Required Note This parameter is not supported on our Switch environment for ASP customers. The file can be retrieved via SFTP. The file name may be formed from the following variables: `%m` = Month as a decimal number (01-12) `%d` = Day of month as a decimal number (01-31) `%y` = Year without century as a decimal number (00-99) `%Y` = Year in four digit format (yyyy) `%H` = Hour in 24-hour format (00-23) `%I` = Hour in 12-hour format (01-12) `%M` = Minute as decimal number (00-59) `%S` = Second as decimal number (00-59)
`/X`5.16+	Sets the Total Past Due and Total Current Due values to zero. The loan’s account status must be CLOSED and the payoff/closed date must be before the Metro 2 generation date.
`/Q`5.29+	The overriding credit bureau ID as configured for a branch to which to generate the report. Has no effect if overriding ID is not configured for a branch. Valid values: 0 = <ALL> (Report is generated using the identification number as configured for the credit bureau header. Default value.) 1 = Equifax 2 = Experian 3 - TransUnion

Processing Payment Cards

Parameter	Notes
`/G =` loangroup number	List of loan groups. Multiple loan groups should be separated with a comma. Optional
`/M = +`/`-` day	Set the Execute Date To +/- from system date. Optional

Interfacing with the General Ledger5.15+

Parameter	Notes
`/L =` location of DLL	Path to the GL interface wrapper DLL.
`/T =` DB type	MSSQL (also MSSQLSERVER) or ORACLE.
`/S =` Server	Name of the database server.
`/D =` Database	Name of the database.
`/U =` Username	Username to log into the database.
`/P =` Password	Password for the username.
`/A =` Parameters	Additional parameters to be passed to the DLL.

National Change of Address (NCOA)5.19+

Parameter	Notes
`/X` or `/x` = Transmit	Transmits the name and address of contacts in NLS that is not specifically excluded from NCOA processing to the NCOA server. Note The transmitted list of contacts is tested against the “change of address” data retrieved from the USPS. It is strongly recommended that transmitting the list of contacts be done no more than once per month to avoid overwhelming the NCOA server.
`/F` or `/f` = Fetch	Fetches the NCOA processing results from the NCOA server and presents it in Processing > NCOA. Note Allow at least 2 hours from the time of the last Transmit operation before fetching the results.

Sonnet

Parameter	Notes
`/T` or `/t` = DB Type	MSSQL (also MSSQLSERVER) or ORACLE.
`/S` or `/s` = Server	Name of the database server.
`/D` or `/d` = Database	Name of the database.
`/U` or `/u` = Username	Username to log into the database.
`/P` or `/p` = Password	Password for username.

Archive5.25+

Parameter	Notes
`/R`	Maximum runtime in minutes. Required only if /E is not specified
`/E`	End time in HHMM or HH:MM 24-hour format. Required only if /R is not specified
`/A`	Archive server override. Optional
`/B`	Archive database override. Optional
`/X`	Max CPU use percentage (default is 80, range is 10 – 99). Optional
`/Y`	Check CPU every Y minutes (default is 1, range is 0 – 60, use 0 to turn CPU monitor off). Optional
`/N`	Include an “In Progress” log entry every N loans archived in the target database's ArchiveLog table. Set to 0 to disable logging. Setting this value to 100 or less may degrade performance. Optional

SFTP RFP5.26+

Parameter	Notes
/F	Path to a local directory where the remote files are temporarily saved. Local copies are deleted after processing.
/R	Remote directory.
/X	Remote archive. Path to remote directory to where post processed files are moved. Optional.
/K	Path to a local directory where the decrypted files are temporarily saved. Optional. If undefined, /F will be used. Local copies are deleted after processing.
/A	Use NLS ACH/AFT SFTP settings to connect. If defined, /I, /O, /N, or /C are not used. If the SFTP Name contains a space, use ID#.
/I	SFTP host. /O, /N, and /C are required.
/O	SFTP port number. /I, /N, and /C are required.
/N	SFTP username. /I, /O, and /C are required.
/C	SFTP password. /I, /O, and /N are required.
/Q5.38+	SFTP SSH private key file. /I, /O, and /N are required. /C is required if the private key is encrypted.
/H	ACH/AFT header to use. SFTP settings are optional if stored in header.
/E	Do not delete temporary local files after processing.

ACH Disbursements5.30+

Parameter	Notes
/A	Disbursement account ID. Required. -2 = pre-select (vouchers with pre-assigned disbursement accounts).
/H	ACH header code. Required.
/B	D = debit. C = credit. B = both.
/W	Number of days from the system date to the Pay Date To date. Optional. -1 for Pre-select voucher.
/M	Number of days from the system date to set the Post Date To date. Optional.
/N	Number of days from the system date to set the GL Date From date. Optional.
/L	Acctrefno. Execute only on the loan matching the specified acctrefno. Optional.
/F	Full path to a local directory where the files are saved.

MailSource5.36+

Parameter	Notes
/I	Name of the documents to process. Required.

Other Targets

NLS Service

Configuration

Email/SMS Notifications

Setting up Scheduled Services

Notifications

About

Loan Software

Training & Support

Additional Resources