ECN-4686 New RESTful Web services support in RMNet

Product: ACUCOBOL-GT

Module: rmnet.dll

Machines Affected: All

DESCRIPTION:

The Http-Get and HttpPut function calls have been added to support RESTful Web services.

Http-Get

This function initiates an HTTP GET request and waits for a response. The HTTP GET method is used to request a representation of the specified resource.

Usage

CALL "HttpGet" USING
         destination-url
         response-pointer
         response-length
         [extra-headers]
         GIVING
         status-code.

Parameters

destination-url	An alphanumeric item specifying the target URL for the GET.
response-pointer	A pointer to an alphanumeric item specifying the value of the HTTP response. After use, use NetFree to return memory used to store response.
response-length	A numeric item returning the length of the HTTP response to which reponse-pointer points.
extra-headers	An optional alphanumeric item specifying extra headers to be added to the HTTP header. This argument consists of name/value pairs separated by hex x"00", and ended with two x"00"'s.
status-code	A numeric item that, if nonzero, indicates the request encountered an error. In this case, the string representation of the error may be obtained by calling NetGetError.

HttpPut

This function initiates an HTTP GET request and waits for a response. The HTTP GET method is used to request a representation of the specified resource.

Usage

CALL "HttpGet" USING
         destination-url
         response-pointer
         response-length
         [extra-headers]
         GIVING
         status-code.

Parameters

destination-url	An alphanumeric item specifying the target URL for the GET.
response-pointer	A pointer to an alphanumeric item specifying the value of the HTTP response. After use, use NetFree to return memory used to store response.
response-length	A numeric item returning the length of the HTTP response to which reponse-pointer points.
extra-headers	An optional alphanumeric item specifying extra headers to be added to the HTTP header. This argument consists of name/value pairs separated by hex x"00", and ended with two x"00"'s.
status-code	A numeric item that, if nonzero, indicates the request encountered an error. In this case, the string representation of the error may be obtained by calling NetGetError.