Modify Program

After a program is defined, you can change the definition with the Modify Program command. When modifying a program that is used to launch an application, however, consider upward and downward compatibility between software versions.

The following command lets you add or remove defining clauses and change the value of clause arguments:

modify program NAME [MOD_ITEM] {MOD_ITEM};
  • NAME is the name of the program you want to modify.
  • MOD_ITEM is the type of modification you want to make. You only need to specify fields to be modified.
    Modify Program Clause Specifies
    code CODE The current code definition changes to that of the new code entered.
    description VALUE The current description, if any, changes to the value entered.
    external|mql|java|ekl The specification of the program type (external, MQL, ekl, or Java) changes as entered.
    file FILENAME The contents of file are added to the code section of the program.
    icon FILENAME The image is changed to the new image in the field specified.
    add rule NAME The named rule is added.
    remove rule NAME The named rule is removed.
    name NAME The current name of the program changes to the name entered. If you rename a program, you need to update any object that needs to use that program. For example, if you rename a program that is part of a toolset, the program will need to be added to the toolset again.
    [!]needsbusinessobject The status of the need for a business object changes as indicated here: needsbusinessobject is used when a business object is needed. ! (or notneedsbusinessobject) is used when a business object is not needed.
    [!|not]downloadable The status of downloadable changes as indicated here: is specified when the program includes code for operations not supported on the Web product (for example, Tk dialogs or reads/writes to a local file). !downloadable (or notdownloadable) is specified when the program does not include code for operations not supported on the Web product.
    [!|not]pipe The external program uses the "piped" service or not.
    [!|not]pooled The program uses pool interpreters or not.
    [!|not]trusted The program is trusted or not to run as part of the where clause of another command.
    execute immediate The status of program execution changes so the program runs within the current transaction.
    execute deferred The status of program execution changes so the program runs only after the outermost transaction is successfully committed.
    execute user USERNAME Assigns a user to the program object such that when other users execute the program, they get the accesses available to the user specified.
    hidden The hidden option is changed to specify that the object is hidden.
    nothidden The hidden option is changed to specify that the object is not hidden.
    property NAME [to ADMINTYPE NAME] [value STRING] The named property is modified.
    add property NAME [to ADMINTYPE NAME] [value STRING] The named property is added.
    remove property NAME [to ADMINTYPE NAME] [value STRING] The named property is removed.
    history STRING Adds a history record marked "custom" to the program that is being modified. The STRING argument is a free-text string that allows you to enter some information describing the nature of the modification. For more information, see Adding History to Administrative Objects.

Each modification clause is related to the arguments that define the program.