Starter is an utility that is included with Rpv to make easier the task of launching an application or an associated file.
This utility can be very useful to start the reports viewer from some languages running on DOS.
Additionally, Starter can open any other file with its associated application. It is possible to use Starter.exe to open a .DOC file, opening the Word because is the associated application to .DOC files.
How to open and print an Rpv report using Starter.
The following explanation and example is basically intended to those languages that have problems with long names. That is the case of RM/Cobol on DOS versions.
It is possible to start a report directly specifying the name of the file or using the protocol viewrpvreport:.
Examples:
STARTER.EXE c:\Reports\file.rpx
STARTER.EXE viewrpvreport:c:\reports\file.rpx
The difference between both commands, now, appears not to exist. However, the protocol viewrpvreport: specifies that the file should be open using Rpv.
In case that the file to be open is a TXT, this will be the only way to do it, because TXT is usually associated to the notepad.
Additionally, the protocol viewrpvreport: allows to specify parameters to open.
Then, it will be possible to open a report in the following way using Starter and the protocol viewrpvreport:.
starter.exe viewrpvreport:myreport.rpv /tuvbac:3000,2000,7000,3000
To print this report, the printrpvreport: protocol should be used.
starter.exe printrpvreport:myreport.rpv /c
From Cobol
CALL 'SYSTEM' USING 'starter.exe viewrpvreport:myreport.rpv /tuvbac:3000,2000,7000,3000'.
CALL 'SYSTEM' USING 'starter.exe printrpvreport:myreport.rpv /c'.
It is remmarkable that the file start.exe can be copied to the directory that is needed to be. This is not possible with other files such as RpvPrint.exe
or Rpv.exe because they need to communicate with some other files. Start.exe works by itself but has to be installed with Rpv.
See also:
viewrpvreport and printrpvreport protocols
|
