NetCOBOL for SPARC Architecture SAF Subroutines User's Guide

122 Appendix D. CGI To SAF Subroutines Conversion Guide
Operations of CGI Environment Variables
A CGI application can reference the "CGI environment variables" using the
environment variable operation function of COBOL. On the contrary, an SAF
application cannot reference them. Thus, it uses three subroutines shown below:
• COBW3_RECEIVE _HEADER
This subroutine acquires an HTTP header.
• COBW3_GET_REQUEST_INFO
This subroutine acquires various types of information related to a request.
• COBW3_GET_AUTHORIZE
This subroutine acquires authorization information.
In addition, a CGI application can set or reference Cookie data using the
environment variable operation function of COBOL. An SAF application cannot
handle Cookie data using the environment variable operation function of COBOL.
Use the subroutines for handling Cookie data shown below.
• COBW3_SET_COOKIE, etc.
This subroutine registers Cookie data.
• COBW3_DEL_COOKIE, etc.
This subroutine deletes registered Cookie data.
• COBW3_INIT_COOKIE
This subroutine initializes Cookie data to be sent to the client.
• COBW3_GET_COOKIE, etc.
This subroutine acquires Cookie data contained in a request.
For example, modify processing for acquiring information from the HTTP header as
shown below.
Contents of the CGI application
DISPLAY "HTTP_USER_AGENT” UPON Environment-variable-name.
ACCEPT Browser-information FROM Value-of-the-environment-variable
ON EXCEPTION
MOVE "Error" TO Browser-information
END-ACCEPT.
Modified contents of the SAF application
MOVE "User-agent" TO COBW3-HEADER-NAME.
CALL "COBW3_RECEIVE_HEADER" USING COBW3.
IF COBW3-STATUS = ZERO THEN
MOVE COBW3-HEADER-VALUE TO Browser-information
ELSE
MOVE "Error" TO Browser-information
END-IF.