Getting Started

System Utilities

 

PxPlus comes equipped with several utilities that are not, strictly speaking, part of the language, but provide various design, configuration, maintenance and diagnostic services within the development environment. These utilities are actually separate programs that reside as auxiliary files in the PxPlus system sub-directory, Lib. All of the utilities are installed with the PxPlus base system, but some were originally designed for use in a character-based environment, some apply to a graphical (Windows) system only, and some require a thorough understanding of PxPlus internal code and may not be available for general use. The majority of system utilities are intended for the creation, debugging, and management of PxPlus programs, files, and directories. See Development Tools.

The System Utilities window provides access to the graphical utilities. Graphical utilities are available for systems running PxPlus for Windows or via WindX. They have all the capabilities of the classic character-based utilities plus access to a few features that are specific to graphical and Web-based development environments; i.e. *IT - Integrated Toolkit and Ed+ program editor.

To invoke this window, use one of the following methods:

Location

Method

From the PxPlus IDE Main Launcher

Select System Utilities from the PxPlus IDE category.

From the NOMADS Session Manager

Select Utilities > System from the menu bar.

From the PxPlus Command line

Type: gui

The System Utilities window is displayed:

This window consists of the following:

Directory

Initially displays the full pathname of the current working directory.

To display the files for a different directory, select the Directory Browse button (beside the Directory field) or manually enter the full pathname.

(Move Up)

Button used for moving up one directory.

(Directory Browse)

Button used for changing to a different directory.

(Refresh)

Button used for refreshing the list of files displayed in the left pane.

(Left pane)

Lists the available files in the displayed directory, along with the file name, type and time stamp details.

(Right pane)

Displays additional details about the file selected in the left pane. This information is dependent on the type of file: program, data file, link reference or device.

Menu Bar Options

These options are listed in the order that they appear on the menu bar: Files, Utilities and Tools.

Files

Description

List Open Files

Launches a separate window with a list of open files that can be sorted by file number, type, record size, key length, pathname and Keyed/Indexed information.

Exit

Closes the System Utilities window.

 

Utilities

Displays a drop-down menu of system utilities, grouped into categories: Files, Directories, Programs, Configuration and General.

Files

Make

Launches the Make File Utility for creating a new file (Keyed, Indexed, Sort, Serial, Zip). Provides options for specifying applicable parameters such as record size, record type, key size, etc.

Delete

Launches the Delete Utility for deleting a file.

To delete a directory, see Directories menu (Delete option).

Rename

Launches the Rename Utility for entering the new name of an existing file.

Print

Launches the Print File Utility for printing the contents of a data file. Provides options for entering the starting/ending key and for printing multiple fields per line.

View

Launches the File View Utility for viewing (not modifying) the contents of a selected data file, if applicable. Available as a tool bar option.

Update

Launches the File Update Utility for viewing, modifying and updating the contents of a selected data file, if applicable. Available as a tool bar option.

Copy

Launches the Copy File Utility for copying the contents of a file. Provides options for clearing the data in the new file and for copying the data dictionary.

Purge

Launches the Purge Contents of File Utility for clearing the contents of a selected data file while preserving the file definition. Provides an option for erasing the imbedded data dictionary.

Admin

Displays the file administration sub-menu with the following selections:

Maximum Size

Launches the Adjust Maximum Number of Records window for changing the maximum size of a file.

Check

Launches the Check Keyed File window for verifying the integrity of a keyed file.

Re-Construct

Launches the Keyed/Direct/EFF File Key Reconstruction Utility for repairing a damaged keyed file. This utility copies each physical record into a holding file, then recreates and reloads the keyed file.

Directories

Make

Launches the Create Directory Utility for creating a new directory.

Delete

Launches the Delete Utility for deleting a directory. Provides an option for deleting any existing subordinate files/directories in the specified directory.

To delete a file, see Files menu (Delete option).

Rename

Launches the Rename Utility for entering the new name of an existing directory.

Print

Launches the Print Directory Utility for printing the contents of a directory. Provides options for sorting the report by filename and for selecting Detailed or Summary output.

Programs

Make

Launches the Create Program Utility for creating a new program file.

Delete

Launches the Delete Utility for deleting program files from the system. Provides an option for deleting any existing subordinate files/directories if a directory is selected.

Rename

Launches the Rename Utility for entering the new name of an existing program file.

Compare

Launches the Program Compare Utility for comparing two existing programs on a line-by-line basis. Available as a tool bar option.

List

Launches the Program List Utility for printing a listing of a program or a series of programs. Provides options for printing a listing and/or a cross reference, as well as formatted printing.

Bulk-Edit

Launches the Bulk Program Scan/Edit Utility for performing a common string search and/or replacement against selected programs. Available as a tool bar option.

Secure

Replaced with *obj/secure.

Patch

(Not Used)

Configuration

Link Files

Launches the Link File Utility for creating and maintaining device, file and printer link files, as well as specifying the link's path name and device driver.

Keyboard

Launches the Keyboard Definition Utility for Windows for defining the input sequences that will be received from the various terminal keyboard. It allows for the editing or re-assignment of the key sequences by manually pressing the keys on the keyboard.

All keyboard input sequences are maintained by terminal type and optionally by User ID to allow custom implementations for specific users.

Parameters

Launches the PxPlus Startup Settings window for setting system parameters.

General

Display Bitmaps

Launches the Bitmaps library. See Displaying Bitmaps/Icons. Available as a tool bar option.

Display Font and Colours

Launches the Available Fonts and Colors window for specifying Font/Size, Foreground/Background colors, and attributes such as Bold, Italics, and Underscore All Characters. Available as a tool bar option.

Click the Color Query button to access Color Selections. Valid formats for color selections include predefined system colors (e.g. Light Red), Custom (RGB codes), HTML Hex Color Codes, User Defined colors (e.g. Color17) and string Expressions.

(The Color Selections Query button and dialog were added in PxPlus 2020.)

Message Library Maintenance

Launches Message Library Maintenance for adding messages to a message library in NOMADS.

Error Message Update

Launches the Error Message Update window that displays a list of numerically arranged error codes.

For a list of error codes and their meanings, see Error Codes and Messages.

 

Tools

Description

Calendar

Launches a Calendar popup.

Calculator

Launches the Calculator.

Program Editor

Launches the default program editor, which is typically the *IT - Integrated Toolkit. To use Ed+ as the default program editor instead, change the setting for the NOMADS Program_Editor property to Ed+. This can be done by using the NOMADS Environment Maintenance utility.

(The ability to set Ed+ as the default program editor was added in PxPlus 2023.)

Notepad

Launches Notepad.

Tool Bar Options

The following tool bar options provide convenient access to commonly used functions that are also available as Menu Bar Options:

Tool Bar Option

Description

View File

Launches the File View Utility for viewing (not modifying) the contents of a selected data file, if applicable. Can also be accessed from Utilities > Files > View on the menu bar.

File Update

Launches the File Update Utility for viewing, modifying and updating the contents of a selected data file, if applicable. Can also be accessed from Utilities > Files > Update on the menu bar.

Compare

Launches the Program Compare Utility. Can also be accessed from Utilities > Programs > Compare on the menu bar.

Bulk Edit

Launches the Bulk Program Scan/Edit Utility. Can also be accessed from Utilities > Programs > Bulk-Edit on the menu bar.

Bitmap Library

Launches the Bitmaps library. See Displaying Bitmaps/Icons. Can also be accessed from Utilities > General > Display Bitmaps on the menu bar.

Fonts Color

Launches the Available Fonts and Colors window for specifying Font/Size, Foreground/Background colors, and attributes such as Bold, Italics, and Underscore All Characters. Can also be accessed from Utilities > General > Display Font and Colours on the menu bar.

Click the Color Query button to access Color Selections. Valid formats for color selections include predefined system colors (e.g. Light Red), Custom (RGB codes), HTML Hex Color Codes, User Defined colors (e.g. Color17) and string Expressions.

(The Color Selections Query button and dialog were added in PxPlus 2020.)

Primary Dictionary
Alternate Dictionary

(Available when the selected file is a PxPlus data file with a primary/alternate embedded data dictionary)

Launches the View Embedded Dictionary window for viewing the file layout details.

NOMADS

NOMADS (Non-procedural Object Module Application Development System) is an integrated suite of utilities that simplify the development of GUI-based applications using PxPlus.

NOMADS allows you to separate data access, logic and graphical controls into reusable segments, localize changes, design a graphical front-end for character-based components and create event-driven applications. The toolset includes a common data manager for consistent access to a variety of data files, as well as a generic error-handling interface.

For an introduction on GUI development in PxPlus, see Graphical User Interfaces.