NetCOBOL for SPARC Architecture SAF Subroutines User's Guide

120 Appendix D. CGI To SAF Subroutines Conversion Guide
Modified contents of the SAF application
WORKING-STORAGE SECTION.
COPY COBW3.
* COPY COBW3SAF.
LINKAGE SECTION.
01 SAFCTX POINTER.
PROCEDURE DIVISION USING SAFCTX.
MOVE LOW-VALUE TO COBW3.
* MOVE LOW-VALUE TO COBW3SAF
SET COBW3-CONTEXT TO SAFCTX.
* SET COBW3-SAF-CONTEXT TO SAFCTX.
Note: Delete the comment indicators when using a SAF specific function.
Environment Variable Operations
An environment variable block is assigned to each process. Since CGI applications
run as separate processes, each is responsible for its own environment variables and
it will not interfere with other processes. However, an SAF application runs as
several threads in NES process. Thus, the SAF application may affect NES or other
applications if it modifies environment variables. Thus, it is necessary to make
alterations in order to remove the use of environment variables when converting an
application from CGI to SAF.
It is not safe to assume that the current folder is unchanged when a SAF application
is called. Thus, the user must pay attention to functions that use the current folder
in the background, for example, a file operation specifying a relative path from the
current folder. To avoid trouble, the following methods are recommended:
• Specifying a file in an absolute path
Contents of the CGI application
MOVE "RESPONSE.HTM" TO COBW3-HTML-FILENAME.
CALL "COBW3_PUT_HTML" USING COBW3.
Modified contents of the SAF application
MOVE "C:\COBOL\SAF\RESPONSE.HTM" TO COBW3-HTML-FILENAME.
CALL "COBW3_PUT_HTML" USING COBW3.
• Specifying a file position using the physical path corresponding to the virtual path
Use COBW3_GET_REQUEST_INFO to acquire the physical path corresponding to
the virtual path.
Contents of the CGI application
MOVE "RESPONSE.HTM" TO COBW3-HTML-FILENAME.
CALL "COBW3_PUT_HTML" USING COBW3.