Setup and Installation

Transaction Maintenance

A transaction defines the program or NOMADS panel, starting directory and template to use for an iNomads application. Only those programs/applications defined as transactions can be run on iNomads. These define the entry points to the system by providing the following information:

In iNomads, transactions are defined using Transaction Maintenance and maintained in the *plus/inomads/tx.conf file.

To invoke Transaction Maintenance, use one of the following methods:

Location

Method

From the PxPlus IDE Main Launcher

Expand the Web Deployment category and select iNomads Setup. In the iNomads Setup window, select the TX Maint button.

From a Web browser

Launch iNomads from a Web browser. From the iNomads Application Launchpad window, invoke the iNomads Setup window by either clicking the Admin button or selecting admin from the Transaction drop box. Select the TX Maint button.

From the PxPlus Command prompt

Invoke the iNomads Setup window by entering the following command: RUN "*plus/inomads/admin". Select the TX Maint button.

Each transaction in the system has the following attributes:

Transaction

Name (txid) of the transaction. This case insensitive value will be used to identify the transaction on the txid parameter on the URL.

Click the Query button (binoculars) to select from a list of existing transactions, including the following pre-defined transactions:

admin

Runs *plus/inomads/admin for accessing System Administration functions. See iNomads Setup.

dashboard

Runs the IDE Dashboard.

debug

Runs a Web-based debug program for viewing and debugging processes. The Process Debugger contains five tabs:

Process

Process selection.

Stack

Program stack contents.

Files

List of open files and status.

Trace

Includes an option to enable trace of logic.

Console

Text mode display of console output.

default

Runs a sample application selector, iNomads Application Launchpad, which is used in development to select the transaction, panel name or program, library and working directory of the NOMADS panel to run.

ide_menu

Runs *ide/inomads/inomads_mnu.

rescue

Runs the Rescue process to reconnect to the task.

test

Runs a browser test routine.

webide

Runs a multi-user version of the PxPlus Web IDE launcher program and can be modified to suit your needs. See Setting Up a Web IDE Transaction.

(The webide transaction was added in PxPlus 2022 Update 1.)

Panel/Program

This field contains either the name of the program to run or the name of the NOMADS panel to invoke.

If the Panel Library field is empty, then this field will be considered the name of the program to run.

Panel Library

This field contains the name of the NOMADS panel library to use. If left blank, the panel name above is considered to be a simple program name.

Starting Directory

Directory from which the selected transaction will be run.

Call Start_UP before running

If this check box is selected, the Start_up program will be called first before performing the program.

Template

Name of the default template to be applied to the transaction. Select a template from the drop down list or manually enter the template name.

Security Info

Requires Logon

Select this check box to require users to enter a User ID and Password to launch the iNomads transaction.

To use this option, user security must be set up by using the Security Manager to define security classifications and users.

Password

(Optional) If a password is entered, users will be required to enter this additional password to launch the iNomads transaction if user security is set up.

If user security is not set up, this will be the only password that users will need to enter.

On Exit URL

This field can contain the URL to a Web page that will display when the transaction completes, or it may contain the word Close, in which case the system will attempt to close the browser window.

Note:
Some browsers will not allow the main browser window to be closed.

 

 

Test

Runs the selected transaction on a Web browser in "test" mode as it would appear to the user, using the current settings displayed on the Transaction Maintenance window. This allows you to preview the transaction and make any further adjustments if needed. When you are satisfied with the results and want to save the changes, click the Write button.

When the Test button is selected, EZWeb Server will automatically start (if not already running), using the default port and secure (HTTPS) settings specified in the Launch EZWeb Server window. If no default port has been assigned, a message will prompt you to define it.

(The ability to enable secure TLS/SSL mode for the EZWeb server was added in PxPlus 2022.)

Note:
The Test button is not applicable when running WindX.

Write

Saves/updates the selected transaction without exiting Transaction Maintenance.

Delete

Removes the selected transaction from the file without exiting Transaction Maintenance.

Clear

Clears the selected transaction from the screen without exiting Transaction Maintenance. This allows you to create a new transaction or select an existing transaction. If any unsaved changes are detected, you are prompted to save them. The cleared transaction is not deleted from the file.

Close

Exits Transaction Maintenance. If any unsaved changes are detected, you are asked if you want to save them.