The sections below present an example application exchange - using the KDCPROG tool.
Step 1
An FGG for application exchange is created that can contain a maximum of three generations of the application program. The first generation of the application program is then transferred to the FGG. This generation is thus the base of the FGG. The current directory (“.”) is specified for filebase.
In Unix and Linux systems: |
Input: | utmpath/ex/kdcprog CREATE . 3
|
Output: | U181 Program kdcprog V07.0A00 is started on <system + bit mode> (pid:1234, ...)
U376 kdcprog: FGG files for ./PROG created.
|
Input: | utmpath/ex/kdcprog TRANSFER . +1
utmpath/ex/kdcprog SWITCH . 1
|
Output: | U181 Program kdcprog V07.0A00 is started on <system + bit mode> (pid:1234, ...)
U383 kdcprog: TRANSFER : /bin/cp ./utmwork ./PROG/0001
U389 kdcprog: TRANSFER successful
U388 kdcprog: new base for program FGG ./PROG is 1
|
On Windows systems: |
Input: | utmpath\ex\kdcprog CREATE . 3
|
Output: | U181 Program kdcprog V07.0A00 is started on <system + bit mode> (pid:1234, ...)
U376 kdcprog: FGG files for ./PROG created (pid: 348,...)
|
Input: | utmpath\ex\kdcprog TRANSFER .
|
Output: | U181 Program kdcprog V07.0A00 is started on <system + bit mode> (pid:1234,...)
U391 kdcprog: TRANSFER for KDCAPPL PROG=NEW initiated
U383 kdcprog: TRANSFER : UTMCMD COPY ./utmwork.exe ./PROG/0001 1 file(s) copied.
U389 kdcprog: TRANSFER successful
|
Input: | utmpath\ex\kdcprog SWITCH . 1
|
Output: | U181 Program kdcprog V07.0A00 is started on <system + bit mode> (pid:1234,...)
U388 kdcprog: new base for program FGG ./PROG is 1 |
Step 2
A new version of the application program is created during the application run. This version is to be transferred to the FGG as the next generation 0002. The relative generation number of this generation is then (+1). This is the default setting for TRANSFER.
In Unix and Linux systems: |
Input: | utmpath/ex/kdcprog TRANSFER .
|
Output: | U181 Program kdcprog V07.0A00 is started on <system + bit mode> (pid:1234, ...)
U383 kdcprog: TRANSFER : /bin/cp ./utmwork ./PROG/0002
U389 kdcprog: TRANSFER successful
|
On Windows systems: |
Input: | utmpath\ex\kdcprog TRANSFER .
|
Output: | U181 Program kdcprog V07.0A00 is started on <system + bit mode> (pid:1234, ...)
U391 kdcprog: TRANSFER for KDCAPPL PROG=NEW initiated
U383 kdcprog: TRANSFER : UTMCMD COPY ./utmwork.exe ./PROG/0002 1 file(s) copied.
U389 kdcprog: TRANSFER successful
|
The transferred generation is used if KDCAPPL PROG=NEW is specified.
Step 3
Information on the FGG is requested.
In Unix and Linux systems: |
Input: | utmpath/ex/kdcprog INFO .
|
Output: | U181 Program kdcprog V07.0A00 is started on <system + bit mode> (pid:1234, ...)
U378 INFO for FGG ./PROG
FGG maximum number of versions 3
FGG base 0001
FGG first generation 0001
FGG last generation 0002
File PROG/0001 is PROG(+0000) <=
File PROG/0002 is PROG(+0001)
The following program files are available:
-rwx------ 1 example other 2845876 Apr 22 15:35 ./PROG/0001
-rwx------ 1 example other 2845876 Apr 22 15:37 ./PROG/0002
|
On Windows systems: |
Input: | utmpath\ex\kdcprog INFO .
|
Output: | U181 Program kdcprog V07.0A00 is started on <system + bit mode> (pid:1234, ...)
U378 INFO for FGG ./PROG
FGG maximum number of versions 3
FGG base 0001
FGG first generation 0001
FGG last generation 0002
File PROG/0001 is PROG(+0000) <=
File PROG/0002 is PROG(+0001)
The following program files are available:
kdcprog: type "DIR .\PROG\*.EXE" to get full information
|
In the output, note that PROG/000x specifies the name of the respective generation.
PROG(+000x) is the relative FGG name. The arrow “<=” points to the base of the FGG; this is the application program generation currently loaded.
Step 4
The UTM administrator exchanges an application. Generation 0002 (alias PROG(+1)) is to be loaded. The administrator thus signs on to the UTM application and enters:
KDCAPPL PROG=NEW
After the exchange, information is again requested on the FGG.
In Unix and Linux systems: |
Input: | utmpath/ex/kdcprog INFO .
|
Output: | U181 Program kdcprog V07.0A00 is started on <system + bit mode> (pid:1234, ...)
U378 INFO for FGG ./PROG
FGG maximum number of versions 3
FGG base 0002
FGG first generation 0001
FGG last generation 0002
File PROG/0001 is PROG(-0001)
File PROG/0002 is PROG(+0000) <=
The following program files are available:
-rwx------ 1 example other 2845876 Apr 22 15:35 ./PROG/0001
-rwx------ 1 example other 2845876 Apr 22 15:37 ./PROG/0002
|
On Windows systems: |
Input: | utmpath\ex\kdcprog INFO .
|
Output: | U181 Program kdcprog V07.0A00 is started on <system + bit mode> (pid:1234, ...)
U378 INFO for FGG ./PROG
FGG maximum number of versions 3
FGG base 0002
FGG first generation 0001
FGG last generation 0002
File PROG/0001 is PROG(-0001)
File PROG/0002 is PROG(+0000) <=
The following program files are available:
kdcprog: type "DIR .\PROG\*.EXE" to get full information
|
The output indicates that openUTM has changed the base. The base is now the generation with generation number 0002, which was loaded when the application was exchanged. Generation 0001 is used if KDCAPPL PROG=OLD is entered. No program is available for KDCAPPL PROG=NEW.
Step 5
Another version of the application program is transferred to the FGG. This means that a new version of the application program is available for another application exchange with KDCAPPL PROG=NEW.
Information on the FGG is again requested after the transfer.
In Unix and Linux systems: |
Input: | utmpath/ex/kdcprog TRANSFER .
|
Output: | U181 Program kdcprog V07.0A00 is started on <system + bit mode> (pid:1234, ...)
U383 kdcprog: TRANSFER : /bin/cp ./utmwork ./PROG/0003
U389 kdcprog: TRANSFER successful
|
Input | utmpath/ex/kdcprog INFO .
|
Output | U181 Program kdcprog V07.0A00 is started on <system + bit mode> (pid:1234, ...)
U378 INFO for FGG ./PROG
FGG maximum number of versions 3
FGG base 0002
FGG first generation 0001
FGG last generation 0003
File PROG/0001 is PROG(-0001)
File PROG/0002 is PROG(+0000) <=
File PROG/0003 is PROG(+0001)
The following program files are available:
-rwx------ 1 example other 2845876 Apr 22 15:35 ./PROG/0001
-rwx------ 1 example other 2845876 Apr 22 15:37 ./PROG/0002
-rwx------ 1 example other 2845876 Apr 22 15:43 ./PROG/0003
|
On Windows systems: |
Input: | utmpath\ex\kdcprog TRANSFER .
|
Output: | U181 Program kdcprog V07.0A00 is started on <system + bit mode> (pid:1234,...)
U391 kdcprog: TRANSFER for KDCAPPL PROG=NEW initiated
U383 kdcprog: TRANSFER : UTMCMD COPY ./utmwork.exe ./PROG/0003 1 file(s) copied.
U389 kdcprog: TRANSFER successful |
Input | utmpath\ex\kdcprog INFO .
|
Output | U181 Program kdcprog V07.0A00 is started on <system + bit mode> (pid:1234, ...)
U378 INFO for FGG ./PROG
FGG maximum number of versions 3
FGG base 0002
FGG first generation 0001
FGG last generation 0003
File PROG/0001 is PROG(-0001)
File PROG/0002 is PROG(+0000) <=
File PROG/0003 is PROG(+0001)
The following program files are available:
kdcprog: type "DIR .\PROG\*.EXE" to get full information
|
Now, a program is available for exchanging an application with KDCAPPL PROG=OLD and a program is available for exchanging an application with KDCAPPL PROG=NEW.
Step 6
Another version of the application program is transferred to the FGG and KDCPROG INFO is called.
In Unix and Linux systems: |
Input: | utmpath/ex/kdcprog TRANSFER .
|
Output: | U181 Program kdcprog V07.0A00 is started on <system + bit mode> (pid:1234, ...)
U383 kdcprog: TRANSFER : /bin/cp ./utmwork ./PROG/0004
U389 kdcprog: TRANSFER successful
|
Input | utmpath/ex/kdcprog INFO .
|
Output | U181 Program kdcprog V07.0A00 is started on <system + bit mode> (pid:1234, ...)
U378 INFO for FGG ./PROG
FGG maximum number of versions 3
FGG base 0002
FGG first generation 0002
FGG last generation 0004
File PROG/0002 is PROG(+0000) <=
File PROG/0003 is PROG(+0001)
File PROG/0004 is PROG(+0002)
The following program files are available:
-rwx------ 1 example other 2845876 Apr 22 15:37 ./PROG/0002
-rwx------ 1 example other 2845876 Apr 22 15:43 ./PROG/0003
-rwx------ 1 example other 2845876 Apr 22 15:59 ./PROG/0004
|
On Windows systems: |
Input: | utmpath\ex\kdcprog TRANSFER .
|
Output: | U181 Program kdcprog V07.0A00 is started on <system + bit mode> (pid:1234,...)
U391 kdcprog: TRANSFER for KDCAPPL PROG=NEW initiated
U383 kdcprog: TRANSFER : UTMCMD COPY ./utmwork.exe ./PROG/0004 1 file(s) copied.
U389 kdcprog: TRANSFER successful
|
Input | utmpath\ex\kdcprog INFO .
|
Output | U181 Program kdcprog V07.0A00 is started on <system + bit mode> (pid:1234, ...)
U378 INFO for FGG ./PROG
FGG maximum number of versions 3
FGG base 0002
FGG first generation 0002
FGG last generation 0004
File PROG/0002 is PROG(+0000) <=
File PROG/0003 is PROG(+0001)
File PROG/0004 is PROG(+0002)
The following program files are available:
kdcprog: type "DIR .\PROG\*.EXE" to get full information
|
The generation 0001 has been deleted because a maximum of three generations can be contained in the FGG.
