PURPOSE: The PMMOD utility program streamlines the process of altering Global Storage (GS) or Data Index (DI) definitions. When a GS or DI is modified, all Process Modules (PM) must be resaved that have it related. PMMOD will find all of the affected PM's and reSAVE them.
There are two ways to effectively use PMMOD. The first and recommended way is to run the utility to create an impact report and not modify the GS/DI until sure of the end results. The impact report will list all of the PM that will need to be resaved after the entry is modified. This method will also create a system file that can be used to resave the PM's after manually modify the GS/DI.
The second method is to modify the DI/GS during the session and then resave all of the affected PM's. Use this method if confident of the end results.
PMMOD will prompt for the type of object to be modified (GS or DI). Only one modification can be done at a time.
* PMMOD
PMMOD Version 12
Enter the DBL name, HELP or QUIT.
Enter <CR> to use DBL 'dbl.name':
If currently using a DBL, its name will appear as 'dbl.name'. If answered "HELP", a brief message on PMMOD will appear. "QUIT" will exit.
Would you like detailed instructions on using PMMOD? (Y or N):
If answered "Y", this detailed HELP will appear.
Enter the item type to modify (GS or DI or QUIT):
If answered "?", the response will be: 'If you want to modify an index, enter 'DI'. If you want to modify a Global Storage definition, enter 'GS'.
Enter the name of the GS/DI to modify or QUIT (? for list):
If answered "?", a listing of GS/DI's in the DBL will be displayed.
Do you want to modify the item now? (Y or N or QUIT or ?):
If answered 'Y', PMMOD will allow modification of the item during this session. After making modifications and saving the item, PMMOD will modify the PM's that RELATE it. If answered 'N', PMMOD will create an IMPACT report containing a list of the PM's that RELATE the item. It will also create a System File, named ACCPMM.CMD, that will modify the Process Modules that RELATE the item. The SF ACCPMM.CMD can be used after modifying the item manually.
Please wait while PMMOD looks over the PM's...
PMMOD will look at each PM in the DBL to find if the item is being related. Depending on the number of PM's in the DBL, this could take awhile. The SF ACCPMM.CMD is created at this time. If only creating the impact report, PMMOD is finished and the following message will appear and the utility will exit.
The impact report, IMPACT.RPT, is ready.
If continuing the utility copies the GS/DI to ACCPMM.BACKUP for backup purposes and place the user in the edit environment allowing changes to be made to the GS/DI specified above using any editing commands. End the editing session by typing the SAVE command at the double dash prompt (--).
Do you want to continue and resave the affected PM's? (Y or N or ?):
If answered "Y", PMMOD will resave the PM's and finish. If answered "N", the process can be stopped and the PM's can be modified later by using the system file ACCPMM.CMD. Also, if answered "N", the utility will prompt:
Do you want to put everything back as it was before? (Y or N or ?):
The utility can be stopped now and have everything put back in its original condition. PMMOD will remove the edited item and rename the backup copy to its original name. Everything will be left as it was before the utility was executed.
In this example, PMMOD produces an impact report for DI BOOKS_DBM2 in DBL BOOKS. After looking at the report, the user starts PMMOD again, modifies the DI, and has PMMOD save the PM's that reference the DI. Responses are in bold print.
*USE DBL BOOKS
*PMMOD
PMMOD Version 12
Enter the DBL name, HELP or QUIT.
Enter <CR> to use DBL BOOKS: <CR>
Enter ? at any prompt for HELP
Enter the item type to modify (GS or DI or QUIT): DI
Enter the name of the DI to modify or QUIT (? for list): ?
Directory of Data Index Definitions
DI - BOOKS_DBM2
DI - PUBLISHERS_DBM2
DI - AUTHORS_DBM2
DI - BOOKAUTHOR_DBM2
DI - SALES_DBM2
DI - ROYALTIES_DBM2
DI - BOOKAUTHOR_RMS.DAT
DI - AUTHORS_RMS.DAT
DI - PUBLISHERS_RMS.DAT
DI - ROYALTIES_RMS.DAT
DI - SALES_RMS.DAT
DI - DISCOUNTS_RMS.DAT
DI - STORES_RMS.DAT
DI - STORES_DBM2
DI - DISCOUNTS_DBM2
DI - BOOKS_RMS.DAT
Enter the name of the DI to modify or QUIT (? for list): BOOKS_DBM2
Do you want to modify the item now? (Y or N or QUIT or ?): N
Please wait while PMMOD looks over the PM's...
The impact report, IMPACT.RPT, is ready. PMMOD is done.
*LIST SF IMPACT.RPT
IMPACT REPORT
11/14/2000
DI: BOOKS_DBM2
DBL: BOOKS
The following PM's relate the DI.
UPDATE_SALES_DBM2
QUICK_REP
YTD_SALES_DBM2
The SF, ACCPMM.CMD, used from the DBL BOOKS, contains the
ACCENT R commands to modify and save all of the above
mentioned PM's. USE the SF ACCPMM.CMD, after you have
successfully completed the DI modification.
Be sure the modified DI is named BOOKS_DBM2.
Execute the SF by typing, in the DBL BOOKS, the following:
*USE SF ACCPMM.CMD
When the SF is completed it will REMOVE itself.
*PMMOD
PMMOD VERSION 12
Enter the DBL name, HELP or QUIT.
Enter <CR> to use DBL BOOKS: <CR>
Enter ? at any prompt for HELP
Enter the item type to modify (GS or DI or QUIT): DI
Enter the name of the DI to modify or QUIT (? for list): BOOKS_DBM2
Do you want to modify the item now? (Y or N or QUIT or ?): Y
Please wait while PMMOD looks over the PM's...
This utility copies the DI to ACCPMM.BACKUP for backup purposes. End editing by typing the SAVE command at the double dash prompt (--).
--P
00100
00110 !
00120 ! DI BOOKS_DBM2
00130 !
00140
00150 INDEX TYPE IS RAM
00160 INDEX TO BOOKS_DBM2
00170 DOMAIN TITLE_CODE ON TITLE_CODE, TITLE_TEXT
00180 KEY CHANGE NOT ALLOWED
00190 DUPLICATES NOT ALLOWED
00200 DOMAIN PUB_CODE ON PUB_CODE
00210 DOMAIN TYPE_CODE ON TYPE_CODE
--a140
00140 ! Entering comment to change DI under pmmod
--SAVE
Do you want to continue and resave the affected PM's? (Y or N or ?): Y
Please wait while PMMOD resaves the PM's...
PMMOD is done.