RUN Command

Execution of a program occurs when you enter a complete RUN command or when a prompter equivalent to that command is transmitted. The RUN command specified with no operands displays the RUN prompter. RUN * executes the current program.

The UPDATE parameter determines whether or not updates will be executed or suppressed for all dataviews and tables (for example, Datacom/CBS, Datacom/SQL, DB2, Sequential, and VSAM). This parameter refers to data accessed via the FOR construct, by embedded SQL, or both. The parameter can be useful for debugging or testing a program without actually updating the data.

The UPDATE parameter is not intended to provide security, nor is it intended as an easy way to disable the update feature of a program. Programs will function as if the update was successful. There will be no indication that the record or records were not successfully updated. If the program supplies messages which indicate that an add or update was successful, these messages will still be produced. However, the adds and updates will not have really taken place.

The record will only reflect the requested change until another record is accessed within the scope of the FOR construct or SQL statement. The parameter only suppresses the internal I/O commands that perform the addition, update, or deletion of the given record. All other processes are carried out. For example, a sequential file will still be allocated and the DISP parameter in the JCL stream will still determine whether or not the file is retained when the execution completes.

Suggested uses for the UPDATE parameter:

Distinguish update programs from inquiry only programs.
Adjust the code to be sensitive to update requests based on PF key selection or input parameters.
Create updateable versus non-updateable panels that can be used alternatively under various conditions.

This command has the following format:

    { *                         }
RUN {pgm‑name [VERSION version] }

    [            [Y]]
    [ UPDATE [DB][N]]

    [{PARAMETER}] 'string'
	
    [{MCPARM   }]

    [            {MAIL 'email‑id'        }]
    [            {LIB                    }]
    [DESTINATION {{SYS dest‑id}          }]
    [            {{NET dest‑id} COPIES nn}]

    [            {KEEP   }]
    [DISPOSITION {RELEASE}]
    [            {HOLD   }]

	[LOOPLIMIT nnnnnn]
   
	[MAXLINES n]

    [DESCRIPTION 'string']