University of ConnecticutModification Tracking System
Table of Contents
- Data Entry Option Screen (2480OPTION)
- Add Entry Screen (2480ADD1)
- Enter Module Screen (2480UPD2)
- Enter Module Information
- Update Screen (2480UPD1)
- Delete Options (2480DEL1)
- Enter Module To Delete (2480DEL3)
- Delete Module (2480DEL4)
- Delete Entire Record (2480DEL2)
Introduction
In order to keep track of program modifications and updates a data entry system has been devised using FOCUS. The system will be utilized for reporting the status and progress of program modifications that are sent to us by our vendors. To maintain accuracy in reporting, the information must be up to date in the database. Therefore, it is important to enter the information as soon as possible when any changes are made.
The following instructions will guide you through the data entry and reporting procedures. At any time, if you are not sure what to put in a specific field, place the cursor in that field and press PF01 for HELP.
This program was designed for use on a color monitor, but it will work just as well on a standard monochrome. It was designed this way for easy identification of specific fields in the DATA ENTRY screens. The colors used are:
- White - Add or update areas
- Aqua - Display only (can not update)
- Pink - Information or instruction
- Yellow - Messages
Getting Started
To start the Modification Tracking System you must follow these steps:
- You must be logged on to a mainframe CMS account.
- Access FOCUS by typing 'USE FOCUS' then press ENTER.
- To enter the FOCUS environment type 'INFOCUS' and press ENTER Note: We must use INFOCUS due to the fact that we will be reading and updating an admin file.
- To start the Modification Tracking System type 'F2480S00' press ENTER
The Main Menu
The following figure shows the Main Menu entry screen.
|
You will notice a flashing cursor near the top of the screen. Tab the cursor to the option that you want to use and press ENTER.
- The first option is for adding, updating, deleting or just doing an inquiry on a specific record.
- The second group of options are for printing reports to hardcopy or back to your screen.
- Complete System - Reports on entire specific system (FRS,SARS etc.)
- Specific Bulletin Board - One bulletin board within a specific system
- Specific Module - One Module within a specific system
- Specific Sequence Number - A sequence number within a specific system
- The last group of options are for the desired method of exit.
Data Entry Screens
The following steps will show you how to add records, update/display records or delete records.
Data Entry Option Screen (2480OPTION)
To get into the Data Entry Option screen, select ADD/UPDATE/INQUIRE/DELETE from the Main Menu. The following screen appears.
|
As you can see in the example above data is entered in the appropriate fields. These are KEY fields and none of them should be left blank.
- System = System the program is identified with (FRS,SARS,GENESYS etc.)
- Bulletin Board = Area where modification is stored by vendor, or a name you may give it to identify a specific group of modifications or data.
- Sequence Number = Sequence number of the modification
When you have entered all the information press the appropriate PF key.
- PF01 - HELP - place the cursor on any field and press PF01 for help with that specific field .
- PF03 - Quit this procedure and return to Main Menu. (No update)
- PF04 - Add or update/display a record. If the record already exists you will go to the UPDATE screen (2480UPD1). If it is a new record you will go to the ADD screen (2480ADD1).
- PF12 - Delete a record or a module.
Add Entry Screen (2480ADD1)
After pressing PF04 the system checks to see if the record exists. If the record is not already in the database the program is routed to the 'ADD' procedure and the screen in Figure 3 will be displayed.
|
If the record entered on the first screen does not exist you will see screen (2480ADD1)will appear. Fill in all the data before pressing any key.
- BBoard Number - Location number in specific Bulletin Board
- Application - Specific Functional Area involved (Accounts Payable(AP), Financial Accounting(FA), Payroll etc.)
- Type of Modification - TOS/Time-Of-Solution ENH/Enhancement GEN/General
- Subject - Subject of Modification applied (40 characters)
- Issue Date - The date issued by vendor
In this area not all spaces need to be filled in. If necessary some of the fields may be updated later. Just fill in all the spaces that apply and press the appropriate key.
- ENTER - This will update the database with the displayed record and return you to the selection screen.
- PF01 - HELP - place the cursor on any field and press PF01 for help with that specific field.
- PF02 - Cancel transaction and go back to Option screen. (No update)
- PF03 - Quit this procedure and return to Main Menu. (No update)
- PF05 - Add a new module in addition to the displayed record.
Enter Module Screen (2480UPD2)
If you select PF05 to add a module, the following screen will be displayed.
|
Notice at the bottom of the screen there is a message informing you that your entry has been added to the database. The current entry remains displayed and a new field appears in the center of the screen (MODULE TO ADD/UPDATE). Here you will enter the name of the module and press ENTER.
Enter Module Information
After you press ENTER you will be brought into the ADD MODULE screen as shown in Figure 5. The module name will be redisplayed and there will be empty boxes to enter the new data. If the module was already in the database you would have been routed to the UPDATE MODULE screen (2480UPD3).
|
These fields can be entered now or you may enter them later using the UPDATE screen.
- Comment - Any comment concerning the module modification (40 characters).
- Date in BASE/TEST/PROD - Date the modification was entered into these systems and user approval date.
- Initials - Programmer's initials (Software) User initials (Approval)
If you pressed ENTER to add this module you would be sent back to the ENTER MODULE screen (2480UPD2) shown in Figure 4 and the message at the bottom of the screen would read: THE MODULE FBM090 HAS BEEN ADDED TO THE DATABASE You may now add another module or go on to something else.
Update Screen (2480UPD1)
If the record already exists in the database we would be sent to the UPDATE screen as shown in Figure 6.
|
You will notice that the cursor is at a field in the middle of the screen. If you are using a color monitor this field will be white and the fields above are aqua. As stated in the beginning of this document, the white fields can be updated and the aqua fields are for display only. Whether you use a monochrome or color monitor, the cursor will come up at the beginning of the first update field. From this screen you can update these fields and press ENTER or update modules associated with this modification.
Delete Options (2480DEL1)
There are 2 delete options available. You can delete just a single module record or delete the entire record, including all associated modules.
|
The Delete Options screen will not delete anything. It will just route your option to the proper delete screen. As shown in Figure 7, to delete a module press PF11 or press PF06 to delete an entire record. PF02 or PF03 will take you back without deleting any records.
Enter Module To Delete (2480DEL3)
Just type in the module name on the Module enter screen and press ENTER.
|
Delete Module (2480DEL4)
The Delete Module screen has display fields only as shown in Figure 9.
UITS MODIFICATION TRACKING SYSTEM 2480DEL4
**Delete Specific Module**
System: FRS Bulletin Board: FR871 Sequence Number: FR871999
Module ===========> FBM090
Comment =========> THIS IS JUST FOR TESTING PURPOSES
Software Changes User Approval
Date in BASE==> 08181994 Init==> JAR Date==> 08301994 Init==> JAN
Date in TEST==> 09131994 Init==> RJW Date==> Init==>
Date in PROD==> Init==> Date==> Init==>
PRESS ENTER TO DELETE THE ABOVE ITEM.
PF02=BACK TO PREVIOUS SCREEN (NO DELETION)
PF03=BACK TO MAIN MENU (NO DELETION)
Figure 9. Delete Module
|
The options here are very clear. The information box on the screen shows exactly what these options are. Nothing will be deleted until you press ENTER. If the deletion was successful you will receive a message like the following. The module FBM090 has been deleted from the file
Delete Entire Record (2480DEL2)
This option will delete an entire record including all associated modules. Care should be taken to check the list of modules displayed in the 2480DEL2 screen before pressing ENTER. If you changes your mind press PF02 to go back to the Option Menu or PF03 to go back to the Main Menu. Once you press ENTER they are gone!
|
Print Options
For this section we must refer back to the Main Menu in Figure 1. Tab the cursor to the "Reports" section of the Main Menu screen and select the desired report and press ENTER.
- Complete System - Reports on entire specific system (FRS,SARS etc.)
- Specific Bulletin Board - One bulletin board within a specific system
- Specific Module - One Module within a specific system
- Specific Sequence Number - A sequence number within a specific system
|
Type your responses at the bottom of the screen as requested and press ENTER. Once you have answered all the prompts the PRINTRT2 exec is evoked. This exec allows you to select and route your report to specific destinations. The first screen will look like that displayed in Fixure 12. Please note: With the current reports in the system you can not use the options P, R or F because the reports are too wide. These options will, however, be explained briefly.
*** ENTER THE SYSTEM YOU WISH TO REPORT ON ***
*** AND THE SPECIFIC SEQUENCE NUMBER ***
PLEASE SUPPLY VALUES REQUESTED
SYSTEM=
frs
SEQNUM=
fr871999
************************************************************************
*** FOR BEST RESULTS SELECT WIDE LASER OUTPUT ***
************************************************************************
>
>
>
>
Where would you like the report: Terminal, Printer, Reader, File or Wide?
Please enter T, P, R, F or W
Figure 12. Print Screen 2
|
Terminal - (T)
Selecting the Terminal option will bring the report back to your screen. The first response you will get is that in figure 13.
>
>
>
>
NUMBER OF RECORDS IN TABLE= 3 LINES= 3
PAUSE.. PLEASE ISSUE CARRIAGE RETURN WHEN READY
Figure 13. Terminal Response
|
At this prompt just press ENTER and the report will be displayed on the screen as shown in Figure 14.
PAGE 1
MODIFICATION TRACKING REPORT FOR FRS S
09/21/9
BULLETIN BOARD BBOARD ID APPLICATION ISSUE DATE TYPE
------------------------------------------------------------------------------------------------------------------------------------
FR871 B524 FA 05/06/1994 ENH
MODULE BASE DATE INITIALS TEST DATE INITIALS
---------------------------------------------------------------------------------------------------------------------------
FBM090 07/12/1994 JAR
FBM092 TED
FBM092UC 09/12/1994 CAT
Figure 14. Terminal Report
|
You will notice that the screen is not wide enough to display the entire width of the report. To see the rest press PF10 to move to the right.
Printer - (P)
Using the Printer option brings several prompts to the screen:
WHAT PRINTER? ENTER (L) FOR 3800 LASER OR (R) FOR REMOTE
|
next prompt
PLEASE ENTER THE NUMBER OF COPIES YOU WISH PRINTED
|
If you choose Laser the file will be sent to the printer and you will sent back to the Main Menu. If you choose Remote you will be prompted for more input.
|
At this prompt enter the actual printer name such as UITSHP1. After this is entered you will see the following on the screen.
****************************************************************
* PRINT CLASSES FOR RSCS PRINTERS: *
* *
* A = PORTRAIT REGULAR *
* C = PORTRAIT COMPRESSED *
* *
* ADDITIONAL PRINT CLASSES FOR LASERJETS *
* *
* R = LANDSCAPE REGULAR *
* K = LANDSCAPE COMPRESSED *
* *
****************************************************************
Please enter Print Class letter
Figure 15. Print Class Option
|
After making your selection you will be sent back to the Main Menu and you report will be sent to the printer.
Reader - (R)
If you select the Reader option you will receive a message like the following and your report will be sent to your reader.
NUMBER OF RECORDS IN TABLE= 3 LINES= 3
RDR FILE 0686 SENT FROM JROMAN PRT WAS 0686 RECS 0010 CPY 001 A NOHOLD
OFFLINE...
>
Figure 16. Reader Message
|
File - (F)
Selecting the File option will allow you to create a LISTING file of your report on your 'D' disk. You can then use this to BROWSE or print at a later time. The prompts will be as follows:
|
Enter 'n' to the prompt above
What file name
fr871999
|
Enter any file name (up to 8 characters) to the above prompt. You will receive the message below and be sent back to the Main Menu.
The file FR871999 LISTING D is being created.
>
>
>
NUMBER OF RECORDS IN TABLE= 3 LINES= 3
OFFLINE...
Figure 17. File Prompts
|
Wide - (W)
This is the option that will most often be used for our reporting needs. Simply enter 'W' and then follow the directions for Printer (P).
Regardless of which report you choose, when the reporting process is complete you will be returned to the Main Menu.
Exit Options
The last options on the Main Menu screen (Figure 1.) are the options for the method of exiting the Modification Tracking System. The selection procedure is still the same. Simply tab the cursor to the appropriate choice and press ENTER. The following are the only two choices:
- CMS If you select CMS, all MSG, WNG etc. will be set back to on, your FOCUS session will end and you will sent back to the CMS environment.
- FOCUS If you choose to go back to FOCUS that is exactly what you will do. When you want to exit from the FOCUS environment type 'FIN' and press ENTER. This will route you back to the CMS environment.
Technical Specifications for Modification Tracking
The following section describes the various components that combine to make Modification Tracking Program a functioning system.
Master files
The MASTER file for the Modification tracking system is D2480F01. This master file is built to include field descriptions that are used as HELP fields in the Modify portion of the program. It is composed of 3 segments:
- The KEYSEG segment which holds key data
- The KEYDATA segment which hold data related to the key and is unique to that key.
- The MODULE segment which is a child of the key segment and can hold many instances to that key.
Program Support Focexecs
There are 2 main
FOCEXECs that are used in the support of the Modification Tracking System.
-
F2480S00
This is the main driver of the Modification Tracking System program. It initiates the program and pulls in all other Focexecs as called for when executed. It is basically the Main Menu where all other functions are initiated.
This Focexec consists of CRTFORMS that accept or display data to be used in adding, updating or deleting records in the FOCUS database. It is executed through F2480S00.
Report Producing Focexecs
These are focexecs
that also reside in Production FOCUSADM. They are executed from F2480S00
when they are selected from the it's generated Main Menu.
-
F2480R01
This will produce a Modification Tracking report for an entire specific system such as FRS,SARS,GENESYS etc. It list records by Bulletin Board with all associated Sequence Numbers and Modules. The report is quite wide, so the Wide(W) option should be selected when printing.
This produces a report on a complete Bulletin Board within a specific system. It is listed by Sequence Number contains all associated Modules.
This produces a report on specific Sequence Number within a specific Bulletin Board. It also lists all associated Modules.
This focexec reports on a specific module within a specific system. There may be several instances of a particular module so they are listed by Bulletin Board and Sequence Number.
Program Listings
D2480F01 (DED)
Segment = KEYSEG (contains key data)
- 1 SYSTEM Specific system such as FRS,SARS,GENESYS ect.
- 2 BBOARD Bulletin Board where vendor stores data.
- 3 SEQNUM Sequence Number of Bulletin Board entry. Segment = KEYDATA (child of KEYSEG contains unique data for this key)
- 4 BBID Identification number of Bulletin Board item.
- 5 APPL Type of application (Purchasing,Payroll,Acctng etc.)
- 6 ISSUE_DATE Date issued by vendor in format MMDDYYY
- 7 TYPE Type of modification (ENH, TOS, GEN(general))
- 8 SUBJECT What modification will do. Segment = MODULES (child of KEYSEG can contain many instances for key)
- 9 MODULE_NAME Name of program, exec, JCL source etc. to modify
- 10 COMMENT Comment about change made to module.
- 11 BASE_DATE Date entered into BASE system
- 12 BASE_INIT Initials of person entering change in BASE
- 13 TEST_DATE Date entered into TEST system
- 14 TEST_INIT Initials of person entering change in TEST
- 15 PROD_DATE Date entered into PROD system
- 16 PROD_INIT Initials of person entering change in PROD
- 17 UBASE_DTE Date that user approved change in BASE system
- 18 UBASE_INI Initials of person approving BASE change
- 17 UTEST_DTE Date that user approved change in TEST system
- 18 UTEST_INI Initials of person approving TEST change
- 17 UPROD_DTE Date that user approved change in PROD system
- 18 UPROD_INI Initials of person approving PROD change