NetCOBOL for SPARC Architecture SAF Subroutines User's Guide

116 Appendix D. CGI To SAF Subroutines Conversion Guide
Conversion from CGI to SAF
In principle, NetCOBOL SAF subroutines (hereafter referred to as SAF applications)
guarantee upward compatibility in source for COBOL CGI applications (hereafter
referred to as CGI applications). Therefore, it is easy to modify Web applications
created using CGI subroutines into Web applications using SAF subroutines.
However, some modifications in the programs, compilations, and the linking methods
are required, since the SAF subroutines have their own unique functions. This
chapter describes the matters that require attention for the conversion from CGI to
SAF.
First, the table below shows the difference between Web applications created using
CGI subroutines and Web applications using SAF subroutines.
No. Item CGI applications SAF applications
1 Application form Main program (EXE) Subprogram (DLL)
2 Unit of execution Process Thread
3 Server interface area Unnecessary Inevitable
4 Environment variable operation Arbitrary Restricted
5 CGI environment variable Enabled using supplied Enabled using supplied
operation
subroutines or
DISPLAY/ACCEPT
statements.
subroutines only.
To implement a conversion from CGI to SAF, the above-noted items must be
modified. Details of these modifications are described in the following chapters.
The subroutines shown below only work in an environment where Web applications
run in the ASCII code system, though they are included in the supplied NetCOBOL
SAF subroutines for the sake of compatibility.
We recommend implementing corrections for the substitute subroutines, when
performing a conversion from CGI to SAF.