# 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:

- Name of the program or Name of the panel and library
- Starting Directory
- Template/style sheet to use
- URL to launch when complete (or Close)

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.