The START-PRODAMP-PROGRAM statement loads and starts PRODAMP program from a PRODAMP library.
Format
START-PRODAMP-PROGRAM | ||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||
Operands
NAME = <name 1..32 with-under> / <structured-name 1..32> / *LIBRARY-ELEMENT(...)
Designates the name of the PRODAMP program.
NAME = <name 1..32 with-under> / <structured-name 1..32>
Loads and starts a PRODAMP program from the currently set PRODAMP user object library. This name is identical to the name of the library element.
NAME = *LIBRARY-ELEMENT(...)
Loads and starts a PRODAMP program from the selected PRODAMP library. The name of the program is identical to the name of the library element.
LIBRARY = *PRODAMP-USER-OBJECT-LIBRARY / *PRODAMP-SYSTEM-LIBRARY / <filename 1..54 without-gen-vers>
Designates the PRODAMP library from which the program is to be loaded.
LIBRARY = *PRODAMP-USER-OBJECT-LIBRARY
Loads the PRODAMP program from the currently set PRODAMP user object library.
LIBRARY = *PRODAMP-SYSTEM-LIBRARY
Loads the PRODAMP program from the PRODAMP system library. For standardinstallations, this is the library $TSOS.SYSDMP.DAMP.
LIBRARY = <filename 1..54 without-gen-vers>
Loads the PRODAMP program from the specified PRODAMP library.
ELEMENT = <name 1..32 with-under> / <structured-name 1..32>
Designates an element from a PRODAMP library. The name of the element is identical to the name of the PRODAMP program that is to be loaded and started.
PARAMETERS = *NONE / list-poss(32): <integer -2147483648..2147483647> / <x-string 1..8> / <c-string 1..80>
This operand can be used to pass a list of up to 32 parameters to the PRODAMP program. The parameters can be defined numerically or as hexadecimal or character strings. For more details on transferring values to the PRODAMP program, see "Pseudo-structures".
Example
START-PRODAMP-PROGRAM NAME=TEST, PARAMETER = (1,2,X'ED','HUGO')
Notes
In contrast to the ASSIGN-PRODAMP-LIBRARIES statement, the *LIBRARY-ELEMENT operand switches the PRODAMP user object library only for the duration of the PRODAMP program; on exiting the program, the earlier state is restored.
On terminating the PRODAMP program started with START-PRODAMP-PROGRAM, all PRODAMP objects loaded for this run are unloaded. Note, however, that further objects may have been dynamically loaded due to subroutine calls. The objects are not unloaded on interrupting the program with the PRODAMP statement INTERRUPT.
However, when a PRODAMP program is executed or compiled without errors in a PROC window (see "Working with procedures (special window: PROC)"), this object and the dynamically loaded objects are not unloaded until the associated PROC window is closed or “New” is entered in the mode field.
If, when loading a PRODAMP object, DAMP determines that an object of the same name is already loaded, the object is not reloaded. This also applies to the implicit dynamic loading of objects on calling a subroutine.