Child pages
  • A Guide To State Software Program Screen Formats

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin
Panel
Table of Contents

Full-Screen Format

Full-Screen Maintenance Programs

The following functions are available in many of the full-screen maintenance programs.

Help Key

In most screen formatted programs you can get on-line information about a specific field shown on the screen by moving the cursor to that field and pressing the [Help] key.

Find Key

To locate a particular record in a file, move the cursor to the "Find" field at the top left of the screen, type in a key value and press the
[Find] key.

Top and Next Keys

When there are a number of records in a file you can quickly go to the first record on the file by pressing the [Top] key. In order to step through the file one record at a time press the
[Next] key to advance to the next record.

Next and Previous Screen Keys

Some of the programs use more than one screen of information for a single record. In order to move from one screen to another for the same record press the [Next screen] or the [Previous screen] key.

Add Key

Pressing the [Add] key will bring up an empty formatted screen into which you can enter data. Use the [Tab] key to move the cursor from field to field. When finished entering data, press the [Accept] key to actually add the record to the file. There is also an option to not add the record if you change your mind.

Modify Key

Pressing the [Modify] key while displaying a particular record will allow you to change the data in any of the modifiable fields on this record. (If there is more than one record on the screen, move the cursor to the desired record before pressing the [Modify] key.) The modifiable fields will be highlighted on the screen. Use the [Tab] key to move from field to field
and either enter new data or tab to the next field. See the sections on Lockmode and Toggle Tab to aid in making modifications.

Lockmode Key

If you wish to repeat the same operation on a set of records, it is useful to "lock into" the operation by use of the [Lockmode] key. Press the [Lockmode] key and then a function key such as [Modify]. (Notice that the [Lockmode] key changes name to the [Exit lockmode] key.) After you modify a particular record, you are given the options of accepting the modification, not accepting the modification, or exiting the modify mode. If you press the [Modify] or [Do not modify] key, the program will automatically step to the next record in the file remaining in the "modify" mode. This will continue until you press the [Exit modify] key. At this point you can press the [Exit lockmode] key to unlock lockmode. Lockmode will also work for the "Add" and the "Delete" modes.

Toggle Tab Key

When adding or modifying a group of records you may wish to skip over or ignore some of the fields and only enter data in certain fields. The
[Toggle tab] key will allow you to do this. When adding or modifying records use the [Tab] or arrow keys to set the cursor on a particular field. Then press the [Toggle tab] key. Repeat this for those fields which are to be ignored. Notice that these fields are no longer highlighted on the screen. When the [Tab] key is pressed the cursor will skip over the "tabbed out" fields. These fields can be "tabbed back in" by using the arrow keys to set the cursor on the desired field and pressing the [Toggle tab] key again. When used in conjunction with lockmode, you can quickly enter data into a selected set of fields on a large set of records.

Set Temporary Defaults Key

Temporary defaults may be established by pressing the [Set ] defaults key. At this point an empty formatted screen will appear. You then enter preset values for various fields so that when a new record is created these values will automatically be filled in. When the program is exited these defaults are removed.

Delete Key

Find the particular record to be deleted. (If there is more than one record on the screen, move the cursor to the desired record.) Then press the [Delete] key. You will then have the opportunity to either complete the deletion by pressing the [Delete] key again, or to abort the deletion by pressing the [Do not delete] key.

Full-Screen Report Programs

The following functions are available in many of the full-screen report programs.

Help Key

In most screen formatted programs you can get on-line information about a specific field shown on the screen by moving the cursor to that field and pressing the [Help] key.

Execute Key

When the [Execute] key is pressed, a menu appears asking how and when you want to execute the program. The following options are available:

Ordered List (ol)
List Item (li)
Execute Now Interactively.
Selecting this option causes the program to run interactively with results available once it is complete. You cannot continue work on your terminal until the processing is complete.
List Item (li)
Execute Now in Background.
Selecting this option submits the job to batch for execution as soon as system resources become available.
List Item (li)
Execute Later in Background.
Selecting this option submits the job for processing at a later time. By default, the job will start after 6:00 pm on the day you submit it. This default can be changed by your System Manager. Contact your A-site if your needs are different from the default.

If either of the background options are selected, a confirmation message is displayed on the terminal indicating that the job was submitted and its current status (whether it is starting to execute or holding until a certain time). Your terminal is then freed for you to continue work. At the conclusion of the job, a message will appear on your terminal (assumming you are still logged in) that the job has finished.

For more information on running programs in background, see the section entitled Using the Background (Batch) Execution Feature below.

Reset Key

The [Reset] key resets the fields to the default values you started the program with. Use this key to start field input over again.

Save/Recall Key

The [Save/Recall] key allows you to save all the screen answers that you entered during the current session. Several pop-up windows appear throughout this process. Choose the Save Current Answer option. Then select Save Answers Using a New Name and enter a name or description for your answer set. You then need to select either OK or Cancel. Each time you use the Save/Recall command, a list of the answer sets previously saved will appear. You have the option to bring-up, delete, or rename any of these.

Using the Keyboard for Full-screen Programs

Programs with a full-screen interface use many of the function keys on the keyboard. This section will give you an introduction to the use of special function keys.

Locating the Function Keys

In order to begin using these programs, you will need to become familiar with some new keys on the keyboard. These are the twenty gray keys along the top row of the keyboard. These keys will be labeled in the program as "F6" through "F20" (the first five keys are not used). These may or may not be labeled this way on your keyboard - if they are not, the number of the function key can be determined by counting from the left from 1 to 20.

In certain portions of the programs, there will be options labeled "S6" through "S9". This means to press the [Shift] key and then the function key. For example, to perform a function labeled "S6", press (shift) + "F6".

PC users may see labels such as "(06)" or "(07)" rather than specific keys such as "F6" or "F7", or "S6" or "S7". To perform these functions you will need to press the [Select] key or hold down the [Ctrl] key while pressing the [F] key, then type in the number in parentheses using the numeric keys on the keyboard.

Moving Around the Screen

When beginning to use the programs, you will discover that you need to move the cursor within the screens. The [Tab] key will move you to the next modifiable field on the current screen. The arrow keys may also be used to move around the screen in the direction of the arrow.

Clearing the Rest of a Field [Ctrl-U]

When entering information onto the screens, be sure that the information looks as desired. In many cases, this means spacing out the remainder of a field when making changes. While the space bar may be used to do this, it may be easier to hold down the [Ctrl] key while pressing the [U] key to clear the rest of the field.

Re-displaying the Screen [Ctrl-W]

There will be times when it is necessary to re-display the screen in order to "clean it up". For instance, if the user receives a mail message while in a full-screen program, it will probably make the screen somewhat unreadable. When this happens, hold the [Ctrl] key down while pressing the [W] key, and the screen will be refreshed.

Other Functions and Keys

There are other special editing keys that may be used to change data and move around the screen. This document will not go into detail about these keys. However, as you become more familiar with the programs you may wish to experiment with some of these features. To get a complete list of the keys that can be used, press the large [Do] key on the top row.

A menu will be presented of special functions. Use the arrow keys to highlight the option wanted and press [Return]. The "Show Editing Keys" option will display a list of all the special editing keys that are available.

Using the Keyboard Macro Feature

The Keyboard Macro Feature provides a method of saving keystrokes and replaying them anytime you need them. This feature is useful for repetitive keying tasks. For example, if you frequently set the same default or toggle tab settings, you can use the Keyboard Macro Feature to save the keystrokes and play them back the next time you use the same program.

Features and Restrictions

Unordered List (ul)
List Item (li)
Up to 64 macros can be recorded for each screen.
List Item (li)
Macros are stored by the name of the screen where they are recorded. A macro recorded for a given screen is only available to be played from that particular screen.
List Item (li)
Once a recording is started, all keystrokes will be recorded until recording is stopped with the <DO> key or you leave the program completely.
List Item (li)
Macros are recorded and played from the current cursor position. It is important that the cursor be in the correct position when the macro is played.
List Item (li)
Macros are sensitive to the screen layout. If the screen is changed by SSDT, then the macros for that screen may no longer function. In this case, you must delete the macro and record it again.

Accessing the Keyboard Macro Feature

To access the Keyboard Macro Feature, press the <DO> key at the top of the keyboard. Then select the "Keyboard Macros" option.

Record Macro

Use this option to record keystrokes. When you choose this option, you will be asked to enter a name for the macro. You will then be returned to the program where you will press the keys you want saved in the macro. Everything that is typed will be saved. While you are typing, the word "Recording" will appear periodically at the bottom of your screen.

When you are finished recording a series of key strokes, press the <DO> key again and recording stops.

Your keystrokes are now saved and are ready to be played when necessary.

Play Macro

After you have recorded one or more macros, use this option to play them. You will be presented with a list of macros to choose from. The keystrokes will be replayed just as you originally typed them using the record option.

Delete Macro

Use this option if you make a mistake while recording a macro or do not need it any longer. Simply select the macro you wish to delete.

Rename Macro

Attempt to give the macros meaningful names so they are easily recognized. Use this option if you wish to give an existing macro a new name. Select the macro and supply a new name.

Hints and Tips

Unordered List (ul)
List Item (li)
Give your macros meaningful names. You have up to 32 characters for the name. An example might be SET_JOBSCN_DEFAULTS.
List Item (li)
Be careful when recording macros that may cause harm to your data. Avoid creating macros that delete data or use the Lockmode feature.
List Item (li)
The Record feature stores everything you type, including errors or invalid keys. Plan your macro before you start. Be sure you know what you want the macro to accomplish, where it will start, and where it will end.
List Item (li)
Macros are recorded and played from the current cursor position. Play the macro from the same place it was recorded. If you play the macro from the wrong starting point, it is very possible that the keystrokes will not make sense from that point. For this reason you may want to establish a standard starting point for all macros. For instance, start recording and playing your macros from the first "Find:" field on the screen or from the "Option>" field of the initial main menu. This way you will always know the correct starting point for every Macro.

Using the Background (Batch) Execution Feature

Programs that use the screen formatted interface (e.g. INICAL, CALCPAY, etc.) allow you to submit the reports for background (batch) execution as opposed to interactive execution, if desired.

Submitting a job to background has several advantages:

Unordered List (ul)
List Item (li)
Your terminal is immediately available to continue with other tasks while the job is running in background.
List Item (li)
You can submit several jobs at one time to be run as computer resources become available.
List Item (li)
Allows for better scheduling/balancing of the computer's workload by the A-site. This may result in more efficient use of resources.
List Item (li)
Allows you to submit jobs for processing at a later time during non-peak hours. For example, if a report is not needed immediately, the job can be submitted to run at a later time. The computer will then run the job when there are fewer users on the system. This will improve system performanace during peak times.

Managing Queued Jobs

To view or manage jobs that have been submitted, press the [Do] key, place the cursor on the Queued Jobs line and press the [Return] key or type QUEBATCH at the MENU> prompt. More information about the job is given on the screen as well as the following choices:

HTML Table
border3
width75%
Table Row (tr)
Table Cell (td)

Delete

Table Cell (td)

Delete the job from the batch queue. This will cancel the job and it will not be executed.

Table Row (tr)
Table Cell (td)

Hold

Table Cell (td)

Place the job "on hold". This will hold the job until you "release" it. This is useful if you decide that you don't really want the job to run right now.

Table Row (tr)
Table Cell (td)

Release

Table Cell (td)

If you placed the job on hold earlier, you can release it with this option. If the job was submitted to run at a later time, choosing this option will release it for immediate execution.

You only have access to jobs under your own username. Jobs that are executing cannot be deleted, thus preventing data loss or corruption.

The status of the jobs may change while you are in the utility. To refresh the information, place the cursor on the Refresh Display line and press Return.

Press the applicable Function key shown on your screen to exit the program.

Viewing Batch Logs

Since batch jobs do not visably run on the terminal, you will not see infomation that the program displays when run interactively such as error messages or warnings. A log file is created when programs are run in background which can be viewed when the job finishes.

To view a log file, press the [Do] key while inside a program or type VIEWLOG at the MENU> prompt. A list of log files appears. Using the up or down arrow key, place the cursor on the desired file and press the [Select] key. This will allow you to view messages that occurred during the run of the batch job. Press the [Q] key to quit.

Viewing Text Files

To view text files on screen, press the [Do] key, place the cursor on the View Text Files line, and press the [Return] key. The screen will display all files with a .TXT extension presently found in your directory. Place the cursor on the desired file and press the [Select] key. The report will be automatically sized for easy screen viewing. Press the [Q] key to quit.

Split Screen Format

This type of program uses a split screen with a reverse image line dividing the upper and lower windows (top and bottom of screen). (If the terminal does not display windows, contact your `A' Site for instructions on how to set up your terminal characteristics.) The upper window displays the menus, on-line `system' or `application' level help, or data that is pertinent to the application being processed. The lower window displays the selections, descriptive `field level' help, user prompts and error messages.

Help can be obtained at all user prompts by pressing the "?" key. All available options are displayed at this point.

Standard Maintenance Options

The following list outlines the capabilities of the 'Standard Maintenance Options'. Any program that allows the user the ability to add, change and delete records will contain these options. Depending on the program, there may be additional options. Any additional options will be documented in the module where they actually appear.

Maintenance options:

Unordered List (ul)
List Item (li)
All fields default to their current values.
List Item (li)
Field level help is provided at all prompts by entering [PF2] or by entering a question mark (question) or /HELP.
List Item (li)
The user may enter [PF4] or /EXIT at any prompt to return to the next highest level (normally the add, change, delete menu). The user may enter GOLD [PF4] or /QUIT to abort the program entirely.
List Item (li)
99 An option to redisplay the screen. This option is most useful for users using hard-copy terminals.
List Item (li)
A - Add a new record.
List Item (li)
C - Change the current record on screen.
List Item (li)
D - Deletes the current record - with verification.
List Item (li)
T - Goes to the first record in the file.
List Item (li)
N - Goes to the next record on the file.
List Item (li)
F - Finds a record based on the data entered by the user.
List Item (li)
Sn - Switches to a new screen. For Hardcopy users, the Sn option
will print the data that would have been displayed on a normal screen.
List Item (li)
S - Program will display the current screen or in the case of a program that has multiple screens, will display the next screen in the sequence.
List Item (li)
E - Returns to the master menu.
List Item (li)
All fields are maintainable by the user.

Add Mode:

Unordered List (ul)
List Item (li)
The system will prompt the user to enter the data for each record.

Change Mode:

Unordered List (ul)
List Item (li)
The user may optionally access records sequentially by using the Next option and entering the data of the record to be changed.
List Item (li)
Another record access option would be to use the Find option. See the explanation of the Find option below.
List Item (li)
After the user enters the number of the field to be changed, the system will prompt the user to enter the new information for the specific field chosen.

Delete Mode:

Unordered List (ul)
List Item (li)
The system displays a verification of the deletion and the user must confirm that this is the record to be deleted.

Find Mode:

Unordered List (ul)
List Item (li)
Finds a record based on data entered by the user. The user may need to find a certain record before it can be changed.
List Item (li)
The user may find by ID or Name.

Switch Screen Mode:

Unordered List (ul)
List Item (li)
The user may switch between screens by entering Sn at the main menu or at the prompt in change mode. Where n is the screen number to be used. If the user enters "S" with no number, then the program will go to the next screen in order.
List Item (li)
When the user switches key fields (with the Find, Next or Top options) the current screen does not change. For example, if the user is looking at S1 and enters the Next option then they will see the next records' S1 data. This will allow the user to easily scan thru the file without switching screens repeatedly.

Scrolling Format

This type of program presents the user with prompts to which a response is requested. As the user responds the program scrolls to the next prompt until all options have been selected.

Help is available by pressing the "?" key at the prompt. All available options are displayed at this point.

Defaults to the prompts appear in brackets. Pressing the <CR> accepts the default value.

Special Functions

Both the Split Screen and Scrolling formats utilize various special functions. These functions are described in the table below.

HTML Table
border3
width75%
Table Row (tr)
Table Head (th)
Function
Table Head (th)
Use
Table Row (tr)
Table Cell (td)

/EXIT

Table Cell (td)

Causes the current operation to be aborted and the user is returned to the previous menu.

Table Row (tr)
Table Cell (td)

/QUIT

Table Cell (td)

Causes the program to exit immediately.

Table Row (tr)
Table Cell (td)

/HELP or ?

Table Cell (td)

Causes field level help to be displayed.

Table Row (tr)
Table Cell (td)

/DUMP

Table Cell (td)

For SMG supported terminals on the VAX this will cause the contents of the upper window to be dumped to a user-specified disk (text) file.

Table Row (tr)
Table Cell (td)

/SPAWN {cmd}

Table Cell (td)

Spawns a subprocess to execute the specified command. If the user is
"privileged", a command need not be specified. This allows user to go
into another program and then return to original program.

Table Row (tr)
Table Cell (td)

/PRINT {par,,}

Table Cell (td)

Causes a subprocess to be created and a system manager defined command
procedure to be executed to print a report file without exiting the
current program.

Table Row (tr)
Table Cell (td)

/VERSION

Table Cell (td)

Displays a status line containing the package name and version, the program and/or subprogram currently being executed and its revision levels and the revision levels of the screen handling routines.

Table Row (tr)
Table Cell (td)

PF1

Table Cell (td)

Sets value of

Table Row (tr)
Table Cell (td)

Help or PF2

Table Cell (td)

Same as "?" or "/HELP"

Table Row (tr)
Table Cell (td)

PF4

Table Cell (td)

Same as "/EXIT"

Table Row (tr)
Table Cell (td)

Gold PF3

Table Cell (td)

Same as "/DUMP"

Table Row (tr)
Table Cell (td)

Gold PF4

Table Cell (td)

Same as "/QUIT"

Table Row (tr)
Table Cell (td)

CTRL C

Table Cell (td)

Same as "/QUIT"

Table Row (tr)
Table Cell (td)

CTRL W

Table Cell (td)

Redraws the current screen

Table Row (tr)
Table Cell (td)

CTRL Y

Table Cell (td)

Programmer controlled. In non-critical areas the user may be allowed to use this function to cause an immediate interrupt and subsequent process abort.

Table Row (tr)
Table Cell (td)

CTRL Z

Table Cell (td)

Same as "/EXIT"