C$EASYOPEN

The C$EASYOPEN library routine opens a file with the associated application, exactly as when the user double click on it in the operating system.

FILE-PREFIX settings are ignored by this routine.

The routine is always asynchronous, it doesn’t wait for the user to close the associated application.

By default C$EASYOPEN takes advantage of features available in Java 6 and later releases, but it can be configured to use different methods by setting iscobol.easyopen.method in the configuration.

Syntax:

CALL "C$EASYOPEN" USING fileName                         [csFlag]                   GIVING returnCode

Parameters:

fileName	PIC X(n)	Specifies the name of the file to be open.
csFlag	PIC 9	This optional parameter is evaluated in thin client environment. Set it to 0 or omit it in order to open the file on the server. Set it to 1 in order to open the file on the client.   In order to open the file on the client the routines copies it in the user temp directory, then it opens it from there.

Return code:

returnCode can be any signed numeric data item and provides additional information:

0	Operation successful.
1	File not found.
2	An error occurred during the copy from server to client in thin client environment.
3	Generic error. The most common causes are: • invalid or missing parameter • there is no program associated to the fileName extension • a Java exception occurred due to missing or incompatible runtime items (only with JDIC method)

Examples:

Example - Open a PDF with the computer's default program for PDF files

*> define retCode as pic 9(n)   call "c$easyopen" using "c:\myapp\pdfs\custreport.pdf"                   giving retCode if retCode not = 0    display message "custreport.pdf could not be open" end-if.