NetCOBOL V11.0 ISAPI Subroutines User's Guide

3.1.1 Basic Functions

The basic functions enable you to create Web applications that perform business in response to requests from WWW Browsers.

Table 3.1 ISAPI Subroutines (COBW3_xxxxx)

Function	Subroutine name	Usage
Work environment settings and Web parameter acquisition	COBW3_INIT	Work environment settings of ISAPI Subroutines and acquisition of Web parameters
Operation of Web parameters	COBW3_GET_VALUE COBW3_GET_VALUE_XX COBW3_GET_VALUE_NX COBW3_GET_VALUE_XN COBW3_GET_VALUE_NN	Search of NAME in the Web parameters and acquisition of associated VALUE
	COBW3_CHECK_VALUE COBW3_CHECK_VALUE_X COBW3_CHECK_VALUE_N	Search of VALUE in the Web parameters
Output of processing results	COBW3_PUT_HEAD	HTTP Header output
	COBW3_PUT_HTML	Output of the Web page for processing result (HTTP Contents)
	COBW3_SET_CNV COBW3_SET_CNV_XX COBW3_SET_CNV_NX COBW3_SET_CNV_XN COBW3_SET_CNV_NN	Registration of converted data in the Web page for processing result
	COBW3_DEL_CNV COBW3_DEL_CNV_X COBW3_DEL_CNV_N	Deletion of converted data in the Web page for processing result
	COBW3_INIT_CNV	Initialization of converted data in the Web page for processing result
Output of processing results	COBW3_SET_REPEAT COBW3_SET_REPEAT_XX COBW3_SET_REPEAT_NX COBW3_SET_REPEAT_XN COBW3_SET_REPEAT_NN	Registration of repeatedly converted data in the Web page for processing result
	COBW3_DEL_REPEAT COBW3_DEL_REPEAT_X COBW3_DEL_REPEAT_N	Deletion of repeatedly converted data in the Web page for processing result
	COBW3_INIT_REPEAT	Initialization of repeatedly converted data in the Web page for processing result
	COBW3_PUT_TEXT	Data output (addition of the line feed code)
System command execution	COBW3_SYSTEM	Execution of the specified system command
Release of ISAPI execution environment resources	COBW3_FREE	Release of resources acquired by the ISAPI Subroutines
Request information acquisition	COBW3_RECEIVE_HEADER	Acquisition of the HTTP header
	COBW3_GET_REQUEST _INFO	Acquisition of information about the requests
	COBW3_GET_AUTHORIZE	Acquisition of authentication information
Cookie data operation	COBW3_SET_COOKIE COBW3_SET_COOKIE_XX COBW3_SET_COOKIE_NX COBW3_SET_COOKIE_XN COBW3_SET_COOKIE_NN	Registration of Cookie data
	COBW3_DEL_COOKIE COBW3_DEL_COOKIE_X COBW3_DEL_COOKIE_N	Deletion of registered Cookie data
	COBW3_INIT_COOKIE	Initialization of registered Cookie data
	COBW3_GET_COOKIE COBW3_GET_COOKIE_XX COBW3_GET_COOKIE_NX COBW3_GET_COOKIE_XN COBW3_GET_COOKIE_NN	Acquisition of Cookie data from Web parameters

• It is necessary to use the following subroutines in the ASCII environment.

  • COBW3_GET_VALUE

  • COBW3_CHECK_VALUE

  • COBW3_SET_CNV

  • COBW3_DEL_CNV

  • COBW3_SET_REPEAT

  • COBW3_DEL_REPEAT

  • COBW3_SET_COOKIE

  • COBW3_DEL_COOKIE

  • COBW3_GET_COOKIE

• It is necessary to use subroutines such as COBW3_xxxxx_XX and COBW3_xxxxx_N in the Unicode environment. Moreover, the meaning is as follows.

  Subroutine name	Description
  COBW3_xxxxx_XX	Both the NAME/VALUE parameters are assumed to be alphanumeric items.
  COBW3_xxxxx_NX	The NAME parameter is assumed to be a national data item and the VALUE parameter is assumed to be an alphanumeric data item.
  COBW3_xxxxx_XN	The NAME parameter is assumed to be an alphanumeric data item and the VALUE parameter is assumed to be a national data item.
  COBW3_xxxxx_NN	Both the NAME/VALUE parameters are assumed to be national data items.
  COBW3_xxxxx_X	Input parameters are assumed to be alphanumeric data items.
  COBW3_xxxxx_N	Input parameters are assumed to be national data items.

• Any code system can use the subroutines not listed above.

• The operation of the following subroutines provided up to this time is guaranteed only in environments where Web applications run using the ASCII code system. For development of applications that run under any other code system than ASCII, use the alternative subroutines in the following table.

  Subroutine name	Alternative subroutine
  COBW3_NAME	COBW3_GET_VALUE_XX COBW3_GET_VALUE_NX COBW3_GET_VALUE_XN COBW3_GET_VALUE_NN
  COBW3_VALUE	COBW3_CHECK_VALUE_X COBW3_CHECK_VALUE_N
  COBW3_CNV_SET	COBW3_SET_CNV_XX COBW3_SET_CNV_NX COBW3_SET_CNV_XN COBW3_SET_CNV_NN
  COBW3_CNV_DEL	COBW3_DEL_CNV_X COBW3_DEL_CNV_N
  COBW3_CNV_INIT	COBW3_INIT_ CNV