PURPOSE: The MODIFY command allows editing of items that were created with the DEFINE command: Code Segments, Command Modules, Control Files, Data Index definitions, Global Storage definitions, Index Definitions, Process Modules, System Files, System Information's and Schema Definitions (if not associated with a DS or limited changes if associated with a DS). Modify transfers control to the ACCENT R editor or the user specified editor assigned to @EDITOR.
FORM 1:
MODIFY object_type object_name [IN DBL name]
|
object_type |
object types allowed are: CF, CM, CS, DI, GS, ID, PM, SD, SF, SI. |
|
object_name |
name of existing object specifed. |
|
IN DBL name |
modify an existing object in a DBL other than the current one. |
* MODIFY PM SHOW_DATA
Use this form to modify CFs, CMs, CSs, GSs, IDs, PMs, SFs, and SIs. SDs that are not associated with a DS may also be modified this way. For SDs already associated with a DS, see Form 2 below.
The MODIFY command can be used at any time to change domains already in a Data Index (DI), to add new domains, or to remove existing domains. Any modifications to a DI that necessitates reforming a given domain are noted by ACCENT R and the domain is reformed the next time the DI is used. Changes that do not affect domains do not cause them to be reformed. A FORM CHECK command can be used to form only new domains added without affecting others.
FORM 2:
MODIFY SD sd_name ENTRY ONLY
|
SD sd_name |
name of existing SD that is associated with a DS. See |
|
ENTRY ONLY |
notes below for Form 2. |
*MODIFY SD BOOKS_DBM2 ENTRY ONLY
Changes such as adding comments, adding field validation clauses, print pictures, use value clauses, and any other changes that do not alter the format of the DS can be made. Any other changes that would alter the SD checksum, such as adding subfields or computed fields, will cause the message:
The SD checksum has changed. Your changes may affect the format of the DATA SET. Do you wish to continue the SAVE? Caution should be used if responding with "Y". Data may become unreadable. Any other response will abort the SAVE and return to the ACCENT R editor. After responding with "Y", you will need to execute the following command:
* COMPILE ALL ENTRIES USING SD sd_name
This will recompile all associated DI's, ID's, CF's and PM's in the current DBL. If you have other DBL's that reference DS's or DI's associated with the SD, then they must also be recompiled.