ProData Logo
DBU 7.0

GREEN SCREEN USER GUIDE

Walk Through Demo

This software system consists of computer software and documentation. It contains trade secrets and confidential information which are proprietary to ProData Computer Servces, Inc. ("ProData"). Its use or disclosure in whole or in part without the express written permission of ProData is prohibited.

This software system is also an unpublished work protected under the copyright laws of the United States of America. If this work becomes published the following notice shall apply:
Copyright@ 1993 ProData Computer Services, Inc.
All Rights Reserved


PREFACE

GOAL

The primary goal of this manual is to make you an efficient and productive user of DATA BASE UTILITY. To accomplish this, we have presented the features of DBU to you in two different formats:

1) User’s Guide: Presented in a more personal tone, it leads the user through all the features of DBU. However, experienced DBU users may find some sections of this format helpful in learning the new features of DBU.

2) User’s Reference: Presented in a more formal tone, it concisely explains all the features of DBU. This format assumes that the user is experienced with DBU and does not want to be led through the features by a demonstration.

Regardless of the format you choose to learn DBU, this manual will enhance performance if used correctly. Both text formats try to present the material in the clearest manner possible in order to give the user a clear understanding of the DBU features.

INTERPRETING INSTRUCTIONAL FORMATS

The only text notation, that needs to be explained for this manual, is the brackets [] used in the User’s Guide. The brackets [] are used to identify the exact key or keys to be pressed. For example, if the user were being taught about the F1 key, the user might see something like this: "The F1 key is used to display on-screen help text. Press [F1] now to ..." Note that when F1 is being discussed it does not have the brackets around it, but when the user is actually supposed to press F1, the brackets are around it.

DBU OVERVIEW

DBU is a file access utility which can be used to locate and update records from one to as many as four different files via logical paths or relative record numbers in any physical file. No creation time is involved. From your main screen or command line, type in "GO DBUMNU" or "DBUMNU" and press enter. The DBU menu will appear on your screen. You can also bring up a file from a command line by keying in DBU followed by a file name. DBU also works with logicals over multiple physicals with multiple members and join files (display only on join files). Members and/or formats can be selected from the logicals to be updated or displayed. Records can be updated or displayed in character or hexadecimal mode. Keys can be set to access logical files and it is possible to select only certain fields to be displayed or updated. DBU has a Menu-driven Windows Environment. Almost all command key functions can be performed by utilizing one of the seven main headings on the DBU Action Bar. Up to four files can be displayed in four different windows on one screen. Access to each window is as simple as using a mouse or the keyboard arrow keys to move the cursor to the desired window (file). DBU also has numerous display options available to facilitate better manipulation and utilization of your files while in DBU. Displays can be as simple as one single record in an optional one, two, or three column format or as complicated as four different files simultaneously showing multiple records. DBU windows can be resized and/or moved in order to optimize screen space. Any individual window of the Multiple File Display can be "zoomed into" or "maximized" and then returned to its original size with a single keystroke. Each window’s border characters can be changed for ease of file identification and, if a color monitor is used, the window’s border color can be changed to any one of five colors. An audit log is available to a user-defined output queue. This audit log can be authorized as required by user or group profile or voluntarily activated by any authorized user. A "Print Record" feature is also available for users desiring a printed copy of a record. A SEARCH/REPLACE OPTIONS screen is available by command key or via the DBU Action Bar. The SEARCH/REPLACE OPTIONS screen prompts the user for necessary parameters to perform a Search or a Search & Replace routine. The AND/OR parameter allows the Search or Search & Replace criteria to range from simple to complex because it permits the user to create either a single Search/Search & Replace parameter or an assembly of a more intricate set of Search/Search & Replace conditions. Parameters such as FIELD NAME/*STRPOS, FROM/TO criteria, and logical tests that consist of EQ, NE, LE, GE, LT, GT, and CT allow for intricate conditions to be applied to a Search or Search & Replace routine. Miscellaneous parameters such as: # OCCURRENCES, IGNORE CASE, PRINT RESULTS, and # RECORDS SEARCHED further enhances the sophisticated Search or Search & Replace capabilities of DBU. Another feature of DBU is the DBU Application. Screens can be designed by selecting fields, etc. and perhaps opening multiple files in different windows. This formatting can be given a name, saved as an application and recalled by DBU. All files and screens will appear as the application was designed. The features outlined above are only a few of the many features and capabilities of DBU that will help you save hours of time debugging data base errors during new development or after program errors have occurred. Another important aspect of DBU is the Security it offers. Complete user profile-tailored security allows DBU to be placed on non-technical user menus, making DBU capable of being more than a programmers’ productivity tool. In fact, DBU is currently being used today by many non-technical personnel as a substitute for programmer-written maintenance and display programs. Perhaps the most important features of DATA BASE UTILITY are:

1) PRODATA Computer Service’s strong belief in and willingness to stand by DBU because we feel it is the best File Access Utility today, and

2) The continued support we provide to DBU customers. PRODATA’s commitment to excellence ensures our DBU customers of an ongoing, friendly service should any questions or comments concerning DBU arise.

UNIT 1

User's Learning Guide

INTRODUCTION

Welcome to ProData Computer Service's Data Base Utility documentation. DBU is a file access utility that can be used to locate and update records from a single file or as many as four different files via logical paths or relative record numbers. DBU was designed to be as user friendly as possible while at the same time giving maximum power to even the newest users. In order to help meet these requirements we have decided to present DBU in a window-like environment that could use a mouse if the user so desired and has an Info-Windows terminal. The mouse will also work when using a P.C. with Rhumba.** It is the goal of this documentation to effectively educate the new user in what we feel is the most advanced file access utility available today. The documentation is divided into five units: The first unit explains the command "DBU" which is used to access the files. It also explains each of the command’s options.

**NOTE: If you wish to access the action bar and pull down menus using your mouse, when using RHUMBA, you need only to configure each action bar selection as a hot spot and point and click.

GETTING STARTED

Some basics to check before starting DBU:

Add the DBU70 library to your library list (ADDLIBLE DBU70).
It is not necessary, but you may want to add the library that contains the file you will be accessing through DBU to your library list.

On the command line enter [DBU] and press [F4] to bring up the DBU command prompt.

DBU COMMAND

DBU Command Prompt Screen Figure 1.2 The DBU Command Prompt Screen will appear on your screen. There are thirteen parameters on this command. File/Application Name:... Required. Enter a file name or a previously created DBU application. This parameter defaults to *PRV which allows DBU to bring back the last file/application that was used. If your last use of DBU involved an application, then the 'DBU type' parameter must be *DBUAPP for the previous application to be retrieved. Library Name:... Required. Enter the library name (*LIBL is the default) that contains the file to be accessed or

generic*
*LIBL
*CURLIB
*USRLIBL
*ALLUSR
*ALL
*DBUAPP - This parameter tells the DBU to use the application to determine what library/file combination to access. The library used in the application can be overridden here, by using of one of the above values.

DBU Type:... Required.

*FILE to access a physical, logical, or join file. Join files can only be displayed, no update is allowed.
*JRN to display a journal receiver, no update is allowed.
*DBUAPP to access a previously generated DBU Application.
*DTAARA to access a data area. Fill in the dataarea name and hit enter. DBU will bring up the dataarea in a flat file format. To convert this to the externally described format if the data area has one, press F4 to get to the DBU Field Selection screen. Press F8 to bring up the 'Import Field Descriptions' window. Fill in whether the external specs are defined in a physical file(PF) or a source file(SRC), and press enter. This brings up another screen that prompts for the physical/source file and library. You may choose to replace all the currently selected fields at this time. Press Enter and the field selection screen will appear. Final changes can be made to the data area layout. Press enter again and the data area will appear as an externally described record. You may even save this screen as an application for using over and over.
*USRSPC to access a user space.

The default for the "DBU Type" field is *FILE. At first, most DBU types will be a *FILE type. Once you become familiar with DBU, you may choose to generate a DBU application to present data formatted to your specifications. You would then enter the application name at the "File/Application Name" prompt and enter *DBUAPP at the "DBU Type" prompt. Please keep in mind that the DBU Application feature is accessible to only those with the proper authority level. Member Name:... This parameter allows you to define a specific file member. The default is *FIRST so that, unless otherwise specified, all files accessed by DBU will display the first member in the file. To display a complete list of all members, key in *ALL. Using the generic* choice allows you to key in one or two letters and an asterisk to get a shortened member listing. The next nine fields are options that may be applied when DBU accesses a file. Note that the: Default Format:... Default Mode:.. Print Audit Log:... options have *DBUAUT (DBU Authority) as their default. *DBUAUT is explained in depth in Unit 5. *DBUAUT will set these options according to what is allowed by the individual user profile. Allow Change of File Name:...The possible values are:

*YES While in DBU the user can switch from accessing one file to accessing another.
*NO The file being accessed in DBU can not be changed to another file.

Revoke Add Authority:... Revoke Change Authority:... Revoke Delete Authority:... are options that have *NO as a default which means that the user will have the authority to add, change and delete records in the file. This parameter may be changed to *YES if you do not wish the user to have this authority when the database is accessed. If the user profile in DBUAUT has the authority to add, change or delete, that authority can be revoked here. If the user does not have the authority to add, change or delete in DBUAUT, then this parameter can not override that authority. Number of Columns:... option refers to how many columns on the screen are initially used to display the fields in a record. However, as you will seen in the next section, while you are in the DBU Main Display, you may change the number of columns used to display the fields from one column to as many as three columns, at any time.

PeopleSoft installation….option refers to JDE/Oracle plug-in.

ACCESSING FILES

Accessing Your File The first display you will see when accessing a file with DBU is: **RETRIEVING FILE INFORMATION**. If DBU doesn't find the file, you will see the command prompt screen again with an error message at the bottom. Figure 1.3 There are a number of reasons why you might see this screen:

1. The user profile is not authorized to the file and/or library entered, or
2. The file or member or library does not exist, or
3. the combination is incorrect, or
4. your spelling is incorrect.

Obtain authorization or correct the errors and re-enter. Summary The first step to take when preparing to use DBU is to ensure the "DBU70" library has been added to your library list. The DBU command prompt screen consists of thirteen parameters. Providing that the file that DBU is to access is located in a library on your library list, the only mandatory field is the "File/Application Name" field. After the first three parameters, the remaining ten fields are for setting defaults or initial settings for DBU. If your file is in your library list, just type DBU followed by the file name desired. If the message, "Invalid File, Library or Member name" comes up on the screen, you have something wrong. Prompt DBU and enter in your file name and library name on the "DATA BASE UTILITY" screen. Check to ensure that:

Your spelling is correct
Library and/or file name exists, and
You have proper authority to access the file.

If all of the above is correct, you will have no problem accessing your file with DBU.

UNIT 2

User's Reference

INITIAL DISPLAY

After successfully finding your file, the initial DBU Screen will appear. For documentation purposes, five major sections of the screen below have been identified. Compare these to the screen.

Action Bar
File Information
Control Field
Record Display Area
Command Keys

Figure 1.5

Action Bar

In order to use the pull down menus, the action bar must be activated. You can activate the action bar by pressing F10. Position the cursor at the desired menu heading and press Enter to pull down that menu. Each menu has multiple options. If using a mouse, position the cursor on the menu item desired and click left mouse button. If using keyboard, enter option desired and press enter. You can exit the menu by pressing F12. The Action Bar provides an alternate method to perform the functions of most of the Command Keys. In fact, it also offers some functions not accessible through the command keys. The Action Bar makes DBU a mouse-compatible windows environment. Providing you have the correct type of terminal, you would be able to access the Action Bar, pull down the menu of your choice, and then select the option you need without even touching the keyboard! Another reason for the Action Bar is the multitude of functions that DBU contains. Twenty-four command keys were not enough to harness the power that DBU possesses! All of the functions accessible through the Action Bar are explained in Unit 3. You can activate the Action Bar with F10 and then use the Tab key to move to the menu heading you want. After tabbing to the required menu heading, press "Enter" to pull down that menu. You can back out of the menu by pressing F12.

**NOTE: The "WINDOW" menu can only be pulled down when multiple files are open.

Try looking at all the menus to become familiar with where different commands are located in the menu system. For your convenience, Appendix A: Command Keys To Action Bar Menus, displays a chart indicating the location in the menus of all the functions that are accessible through the command keys.

Record Information

This area of the screen primarily shows information on the file being accessed. This information is visible while in the Single File display only. The "Mode" of display is also shown, it will be Add, Update, Delete or Display. The one input field is the "Control" field. This field allows navigation within the file and has many other options. See "Control Field" below.

Field Definitions

File. . . The DBU "File" automatically displays the name of the active displayed file.

NOTE: This field will not be displayed while multiple files are displayed unless the window containing the active file is maximized by using either F23 (Window Max) or the Action Bar.

Library . The DBU "Library" automatically displays the library name the active displayed file is located in.

NOTE: This field will not be displayed while multiple files are displayed unless the window containing the active file is maximized by using either F23 (Window Max) or the Action Bar.

Page Number . . . The DBU "Page#" automatically displays the page number of the active displayed record. Lengthy records may require more than one screen. Each screen required for any single record is considered a "Page".

EXAMPLE: An indication of PAGE# . . .: 1 of 3 informs the user that the current display is the first of three pages that contain the displayed active record.

There are three things that may be done to attempt to fit the record on one page:

1. If the record is just one or two fields too long to fit on one screen, use F2 (Non-display Keys) to remove the command keys displayed at the bottom of the main DBU screen. Removing the command keys allows two more lines to display fields.

2. The user may also use F13 (Columns) to increase the number of columns displayed (up to a maximum number of three) on one screen.

3. F4=List Fields may be used. The list Fields screen will allow the user to select only those fields needed for viewing to appear on the main DBU screen. Consequently, the amount of room needed to display the record may have been reduced enough to allow the record to fit in one column on one screen.

NOTE: This field will not be displayed while multiple files are displayed unless the window containing the active file is maximized by using either F23 (Window Max) or the Action Bar.

Member. . . The DBU "Member" automatically displays the member name of the active displayed file.

NOTE: This field will not be displayed while multiple files are displayed unless the window containing the active file is maximized by using either F23 (Window Max) or the Action Bar.

Format. . . The DBU "Format" automatically displays the Record Format of the active displayed file.

NOTE: This field will not be displayed while multiple files are displayed unless the window containing the active file is maximized by using either F23 (Window Max) or the Action Bar.

Mode . . . The DBU "Mode" automatically displays the Display Mode (Add, Change, Display, or Delete) of the active displayed file.

NOTE: This field will not be displayed while multiple files are displayed unless the window containing the active file is maximized by using either F23 (Window Max) or the Action Bar.

Record Length. . . The DBU "Record Length" automatically displays the record length of the active displayed file. DBU can handle record lengths up to 32,766 as of Version 7.0

NOTE: This field will not be displayed while multiple files are displayed unless the window containing the active file is maximized by using either F23 (Window Max) or the Action Bar.

File Access. . . The DBU "File Access" automatically displays the file access of the active displayed file. This field will display one of two file access methods:

1. KEYED: Indicates that the active displayed file is a logical file or a keyed physical file.
2. ARRIVAL: Indicates that the active displayed file is a non-keyed physical file or keyed file put into relative record number sequence.

NOTE: This field will not be displayed while multiple files are displayed unless the window containing the active file is maximized by using either F23 (Window Max) or the Action Bar.

Record Number. . . The DBU "Record Number" automatically displays the relative record number of the active displayed file. There are three ways a user may use this field:

1. If the active displayed file is in arrival sequence, the user may refer to this number to verify which record is being displayed. The user will then know how many records to move forward/backward to get the desired record to be displayed.
2. If the active displayed file is in a keyed sequence, the "Record Number" will show the record number from the primary file used on the join.
3. If a join file, the "Record Number" will show the record number from the primary file used on a join.

NOTE: This field will not be displayed while multiple files are displayed unless the window containing the active file maximized by using either F23 (Window Max) or the Action Bar.

Control Field

The DBU Control Field accepts input. It is used to access records within a file in a variety of ways. Learning and using the following commands of the Control Field will help the user to manipulate DBU and the user's files at a greater level of efficiency and speed:

Using the Control Field to go directly to the top or the bottom of the file, or to go directly to a specific record.
o T Enter "T" to move to the first record in the active displayed file.
o B Enter "B" to move to the last record in the active displayed file.
EXAMPLE: User is currently displaying relative record number 57. If the user wanted to see relative record number 100, he would enter on the Control Field: "+43". Relative record number 100 would then be displayed.
Using the Control Field to advance or move backwards a number of records. Use a (+) or a (-) sign along with a number to move backwards or forwards through a file. e.g. To move three records forward you enter [+3] in the Control Field and press [ENTER], and so on. Note: In a logical file, the relative record number is shown but generally will not appear to be consecutive.
o 1 through the number 999999999 Enter a whole number from 1 to 999999999. The record containing the same relative record number will be displayed.
o + "n" Enter the plus sign (+) followed by the number of records to move forward in the file from the active displayed record.
o - "n" Enter the minus sign (-) followed by the number of records to move backward in the file from the active displayed record.
EXAMPLE: User is currently displaying relative record number 157. If user wanted to see relative record number 100, he would enter on the Control Field: "-57". Relative record number 100 would then be displayed.
Using the Control Field to display a "page" of a record. Long records that will not fit on one screen will flow over to a second "page". Use P"n" - If you have a record that is display on multiple "pages" and are positioned on the record that is wanted, key P"n" (n being the page number) in the Control Field. You may also backup or go forward a certain number of pages by keying P-"n" or P+"n".
o P"n" Where P = Page and "n" = page number of current record.
o P-"n" Enter P and the minus sign (-) and the pages you wish to go back in a record.
o P+"n Enter P and the plus sign (+) and the pages you wish to move forward in a record.
EXAMPLE: User is currently displaying page 6 of a record and wishes to go back a couple of pages. User keys in P-2 and this action will take it back 2 pages so he is now on page 4. The same thing works to move forward. User is on page 4 and wishes to advance 3 pages. He keys in P+3 and presses enter and ends up on page 7 of the same record.
WINDOW COMMANDS: There are three different commands to manipulate screens or windows to the left or right that can be entered into the Control Field. All of which are applicable in Multiple Record Display Only:

W"n": Where "W" = Window, and "n" = Number column (Field) to be the leftmost or first column (Field) on the display screen or window.

EXAMPLE: User is currently displaying a Multiple Record Display that shows columns (Fields) one through six. User needs to have column four in the first displayed column, so he enters "W4" at the Control Field. He now has column four in the first column.

1. W +"n": Another way to perform the same function the above example illustrates is to enter "W+'n'" on the Control Field. This command performs the same function as the above command, but in a slightly different manner. The above example used the "n" to indicate the first or leftmost column to be displayed. This command adds the "n" (number) to the first column currently on the screen or window. If user wanted column four to be the leftmost column and column one was currently the leftmost, he would have to enter "W+3" on the Control Field.
2. W-"n": The last command to manipulate the windows moves the screen or window to the left. It is the opposite of the above Control Field command. To move the screen or window to the left enter "W-n" on the Control Field command. Where '-n' = the number to subtract from the first displayed column number.

EXAMPLE: User is currently in Multiple Record Display mode (F21) and is looking at columns (Fields) twelve through eighteen. He then has to go back to the first column to see that field. To get to the first column user enters "W-11" on the Control Field.

RRN or ARRIVAL: This command will cause the active displayed file's records to be listed in arrival or relative record number (RRN) sequence. Use on keyed or non-keyed files.
KEY or INDEX: Applicable To Keyed Files Only!! This command will cause a keyed file whose records have been forced into relative record number or arrival sequence by either the RRN or arrival control field commands to be returned to its original keyed sequence.
SCF: Applicable While In Change Mode Only!! SCF (SET CURSOR at Field) will automatically place the cursor at the first input field whenever DBU is accessed.
SCC: Applicable While In Change Mode Only!! SCC (SET CURSOR at CONTROL) will automatically place the cursor at the control field whenever DBU is accessed.

Fast Path Commands can be entered in the control field. These commands give the same function as command keys or as options on the pull down menu. They are as follows:

ADD - Go to Add mode.

APP - Access DBU applications.

CHG - Go to Change mode.

CLO - Close a file. Only when in windows environment.

CMD - Bring up command line.

DBR - Display Data Base Relations.

DLT - Go to Delete mode.

DSP - Go to Display mode.

DUP - Go to ADD mode and duplicates one record from the data currently shown.

FMT - Put data in multiple mode with formatted fields.

FTS - Display a format list for selection.

HLP - Activates the Menu bar & brings up the HELP Menu.

LOG - Access Audit Log Menu.

MBR - Display a member list for selection.

OPN - Open another file in DBU windows environment.

OPT - Display window options for update.

PRT - Print entire current record.

RDR - Go to Reactivate Deleted Record mode.

SGL - Put data in single record mode with formatted fields.

SSP - Suspend a file. Only when in windows environment.

SIZ - Size windows. Only when in windows environment.

UNF - Put data in multiple mode with no field formatting.

Record Display Area

Note that the record is displayed in three columns. This is the default display for a single record display and is determined at the DBU Command Prompt Screen. By pressing F13, you can change your display to a one or two column format. DBU will come up in a three column format unless otherwise changed on the DBU Prompt Screen.

Command Keys

This is a list of the valid command keys. Some command keys are accessed only under certain conditions or in a particular sequence of events. Refer to the individual explanations below this list for further information.

F1

Help

F2

Display/Nondisplay Keys

F3

Exit

F4

List Fields

F5

Refresh

F6

Set Key

F7

Backward

F8

Forward

F9

Character/Hex

F10

Action Bar

F11

Mode

F12

Cancel

F13

Columns

F14

Data Base Relations

F15

Define Search/Define Search & Replace

F16

Search

F17

Replace

F18

New File

F19

Shift Left

F20

Shift Right

F21

Single

F22

Next File

F23

Window Max/Window Min

F24

More Keys

INITIAL SCREEN COMMAND KEYS

F1= HELP The Command Key "F1" will access DBU help. You can gain more in-depth information on any of the Initial Display Screen items by moving the cursor to the item that you require more information on, then pressing [F1]. Move your cursor towards the upper left corner to place it anywhere on "File . . .:(your filename)". To get a help window that will explain the "File" display field, press [F1]. To exit the help window, press [F12] or [Enter]. F2=NONDISPLAY KEYS Toggles command key descriptions on/off at bottom of screen display. Removing command keys from screen provides two more display lines for display of record. F3 = EXIT Terminates DBU session and returns user to system or program screen DBU was called from. F4 = LIST FIELDS Lists all fields for current active file in DBU. When selected, this command allows for the following options to be applied to each individual field of the active file while in DBU only.

NOTE: Options will remain in effect until user changes them or until the applicable file is closed - See page 30 for detailed information.

OPTION

PURPOSE/FUNCTION

SEQ#

Indicates which sequential position each field will be displayed relative to the other fields of the record.

SELECT

Indicates which fields DBU will display. The default setting with no fields selected will display all fields. Selecting, with an "S" or "X", any one field will override the default setting and will display only the fields selected. Keying an "L" into the select field will Lock that field on the screen. Keying an "O" will Omit that field from the screen.

DISPLAY ONLY

Applicable in Update Mode only; write protects selected fields. Cursor will position at first field not selected.

NEW LINE

Applicable to two or three column record display only; causes selected field to break to new line.

NEW PAGE

Applicable to one, two, and three column record display modes; indicates field to start new page after page break.

AUTO DUP

Applicable to Add Mode only; data in selected fields will automatically be duplicated in subsequently added records.

UPPER CASE

Applicable to Add and Change Modes; selected field's data will be input as upper case. Default is lower case.

F5=REFRESH Applicable to the Change (update) Mode; while changing a record in DBU, the user may recall the originally accessed record in its entirety.

NOTE: This feature is disabled after changes have been made to a record and enter has been pressed.

F6=SET KEY Allows user to enter a starting key selection on logical or keyed physical files. If the file has a single record format, the current key is displayed. Partial keys may be used. Not valid for the non-keyed physical files. The result will be:

- The first matching record if a match is found.

- The first record following the requested record key if there is no match and the requested key is less than the last record of the file.

- The last record of the file if there is no match and the requested key is greater than the last record of the file.

F7=BACKWARD Accesses and displays the previous relative record to the record currently on active display. F8=FORWARD Advances to and displays the next relative record to the record currently on active display. F9=CHARACTER/HEX Allows user to choose character or hex display format. F10=ACTION Moves user from active screen to the DBU Action Bar at the top of the display screen. All DBU options and features are then accessible from the six main selections on the Action Bar. The user may then toggle back to the active display screen by pressing F10 again (F12=CANCEL will also exit the Action Bar and return user to the active display screen). F11=MODE The update mode (Display, Add, Change, Delete) is changed by using the F11=Mode Command Key. Pressing [F11] will display the mode menu. Enter the number that applies to the mode you desire and press {ENTER}or by position the cursor on the desired mode and double click. The "Mode" Display Field will always reflect the current mode of operation. If the file is a logical over multiple physical files, you may want to select the format to process.

FUNCTION

ADD

Adds records to end of the file.

CHANGE

Update or edit an existing record.

DISPLAY

Displays records. No editing or adding permitted.

DELETE

Deletes selected record.

REFRESH

Applicable to the Change Mode; While changing a record in DBU, the user may recall the originally accessed record in its entirety. NOTE: This feature is disabled after changes have been made to a record and enter has been pressed.

F12=CANCEL Returns cursor to Main DBU Screen; exits from Action Bar, all windows, and help or secondary screens. F13=COLUMNS Display from one column up to three columns on one display screen. Works in all modes (DISPLAY, ADD, DELETE, and CHANGE). It is possible to change the number of columns by using the F13=Columns command Key. Press [F13] to toggle from 1 to 3 columns of data on the screen. The F13=Columns is applicable to the single record display only, but it can be used whether in the display, delete, add, or change mode. F14=DATA BASE RELATIONS Accesses the "Data Base Relations" screen. The "Data Base Relations" screen displays the Physical and all Logical files related to the current displayed active file. The screen also displays the respective keys and select/omits contained by the physical and each logical file listed. The user may select the listed physical file or any one of the logical files. The user may also access a completely different library and/or file using the file, library, and/or member entry points located at the top of the "Data Base Relations" screen.

NOTE: Any file opened from this screen will replace the currently active file.

F15=DEFINE SEARCH Accesses Search/Replace screen. Allows user to find a record within the currently active file. If a specific format has been selected on a previous screen, then only that format will be searched. The user has the option of either finding the desired record or finding and changing the desired record. The Search/Replace screen is divided by function into two halves., The two major parts of the Search/Replace screen are the Search Function and the Replace Function :

SEARCH FUNCTION

The top section of the Search/Replace Options screen prompts the user to define the parameters for a search function. Fill out the parameters and press F16 or the enter key.

The enter key will return to the Search/Replace screen, from which F16 can be pressed to continue the search.
F16 will proceed to search the file for the criteria defined.

The search will begin using the current record displayed on the screen. If the current record is one that has already been found using the search criteria, the search begins with the next record in the file. The search can be executed to find either the 'next' or 'previous' or 'all' records in the file depending on the field Occurrences to Process . The case (upper/lower) can be ignored for the search using the Kind of Match field. The results of the replace can be printed using the Print Results . The search will read through only the number of records in the Records to Search field. If a search is satisfied before this number is reached, the record will be presented on the screen, and F16 at that point will continue to search until the total number of records read matches this number. If the search is not satisfied, this number of records will be read and a message "Maximum records read, scan condition not found" will be returned to the screen. The last record read will be presented and F16 at this point will start the search using the next record in the file and the same number of records will be searched. Search in batch. DBU allows you to define the search criteria, then key an F21 to submit the search to batch. If, in the DBU authority file, the user is permitted to Prompt the submit to batch, the prompt screen will appear at this point to request a JOBQ, OUTQ, and libraries. The JOBQ and OUTQ used will be the ones defined in the DBU authority file, unless overridden at submit time. If no JOBQ and OUTQ are defined in the authority file, they are defaulted to the system values. If you are performing a straight search in batch with no replace, with Print Results 'Y', the report you receive will show the record numbers that equaled the parameters you set up. If you do a search/replace in batch and specify 'Y' and Print Results, the search/replace will happen and you will have a report of all changes made. If you do a search/replace with Print Results 'N', you will still get a short report showing which records were changed but not a full audit log. The fields used for the search are defined below:

A/O: The user may have a multiple argument search using A=AND or O=OR to group or string the search criteria together.

AND: Use to string search criteria together so that all criteria must be true in order for the search to be satisfied.

OR: Use if only one of the defined equations are necessary for search parameters to be met or to start a new group of search criteria.

FIELD NAME, *RCD, RRN: User has option of using field names, records or relative record numbers or combinations of the three as defined areas of data to be searched.

FIELD NAME: Enter field name to be searched. If the field names are not known, position the cursor in the field and press F4. A list of names in the file will be displayed and may be selected back to the search screen. Depending on the placement of the cursor, the fields will be retrieved back to the search or the replace fields. The system will enter *STRPOS if character string is to be searched. The FROM and TO fields are to be used only if a character string is to be searched.

*RCD: Enter *RCD if you wish to search for decimal data errors. *RCD needs to be used in conjunction with *DECERR in the value field.

*RRN: Enter *RRN if you wish to search for a particular relative record number or a group of relative record numbers.

FROM: Enter numerical starting position of desired character string.

TO: Enter numerical ending position of desired character string.

OP (OPERATION): User has option of logical expressions to apply to search parameters:

GT: GREATER THAN - Find record(s) greater than search parameters.

LT: LESS THAN - Find record(s) less than search parameter.

EQ: EQUAL - Find record(s) equal to search parameters.

GE: GREATER THAN, EQUAL - Find record(s) greater than or equal to search parameters.

LE: LESS THAN, EQUAL - Find record(s) less than or equal to search parameters.

NE: NOT EQUAL - Find record(s) not equal to search parameters.

NG: NOT GREATER - Find record(s) not greater than search parameters.

NL: NOT LESS - Find record(s) not less than search parameters.

CT: CONTAINING - Find record(s) that contain user-defined character string anywhere inside user-defined "FROM" and "TO" positions.