Warehouse Release 6.04.0360

06/12/2017

The improvements in the 6.04.0360 release are:

• Miscellaneous fixes with XML using SOAP/WSDL.
  
  
• A new SET option called LOGRESPONSE has been added to help debug XML using SOAP/WSDL. LOGRESPONSE causes data received from each SOAP call to be logged to the specified text file. This is similar in function to SET xml DEBUG RESPONSE except that the data is logged before being interpreted as XML and is unformatted. In addition, LOGRESPONSE marks each response with a timestamp to the millisecond and shows the response length in bytes. The syntax for an XML file is:
  
      SET xml-file LOGRESPONSE text-file
  
      xml-file    is the tag of an XML file opened with the OPEN statement using the WSDL option for SOAP access.
  
      text-file   is the name of the text file on the local file-system to which the data ids to be logged.
  
  Example:
  

             OPEN myCloud XML * MODE=r WSDL="soapAcc.wsdl"
             SET myCloud LOGRESPONSE "SoapResponse.txt"
  

  After running, the beginning of SoapResponse.txt looks something like this:

              2017-06-12 09:28:34.965 length=1066 <?xml version="1.0" encoding="utf-8"?><soap
                  env:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmln
                  s:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/
                  XMLSchema-instance"><soapenv:Header><platformMsgs:documentInfo xmlns: ...
  

• Four new built-in functions have been added: FILEREAD, FILEWRITE, XLATEFROM, and XLATETO.
  
  
• The FILEREAD function reads the entire contents of a file into a STRING. The syntax is:
  
      target-string = FILEREAD ( file-name, file-mode )
  
      target-string    is the destination of the entire file contents. This may be a STRING variable or part of an expression.
  
      file-name    is the name of file on the local file-system to be read.
  
      file-mode    is the mode to use when opening the file. This could be something like "READ", or "READ BINARY". See the OPEN statement for a full list of file modes.
  
      Example:
  

             PRINT FILEREAD("/etc/HOSTNAME", "READ")
  

           Prints the entire contents of the file /etc/HOSTNAME.
  
  
• The FILEWRITE function writes the entire contents of a file from a STRING. FILEWRITE must be accessed using the CALL statement. The syntax is
  
      CALL FILEWRITE ( file-name, file-mode, source-string )
  
      file-name    is the name of file on the local file-system to which the source-string is to be written.
  
      file-mode    is the mode to use when opening the file. This could be something like "APPEND", or "WRITE ERASE". See the OPEN statement for a full list of file modes.
  
      source-string    is the source of the entire file contents. This may be a STRING variable or part of an expression.
  
      Example:
  

             CALL FILEWRITE("myTextFile.txt", "WRITE ERASE", TEXTSTR)
  

           The contents of the string TEXTSTR are written to the file myTextFile.txt, replacing the current contents.
  
  
• The XLATEFROM function translates a string from a given format. The syntax is:
  
      target-string = XLATEFROM ( source-string, xlate-format )
  
      target-string    is the destination string after the translation has been completed. This may be a single-byte string variable (STRING) or a two-byte string variable (NSTRING).
  
      source-string    is the source string assumed to be in the format specified by xlate-format. This may be a single-byte string variable (STRING) or a two-byte string variable (NSTRING).
  
      xlate-format   is the name of format of source-string from which it is to be translated. xlate-format is case insensitive and must be one of:
  
          BASE16   Translates a string in base-16 format.
  
            Reference:
            https://en.wikipedia.org/wiki/Hexadecimal
  
          BASE64    Translates a string in base-64 format. This is a common format for sending and receiving binary data to and from the cloud. For example, SalesForce encodes attached files in base-64.
  
            Reference:
            https://en.wikipedia.org/wiki/Base64
  
          UTF8     Translates a string in UTF-8 format. This is a common method of storing Unicode data into strings of single-byte characters.
  
            References:
            https://en.wikipedia.org/wiki/UTF-8
            https://www.w3schools.com/charsets/ref_html_utf8.asp
            https://tools.ietf.org/html/rfc3629#section-4
  
          UTF16     Translates a string in UTF-16LE format.
          UTF16BE  Translates a string in UTF-16BE format.
  
            Reference:
            https://en.wikipedia.org/wiki/UTF-16
  
  
• The XLATETO function translates a string to a given format. The syntax is:
  
      target-string = XLATETO ( source-string, xlate-format )
  
      target-string    is the destination string after the translation has been completed. This string contains data in the specified format. This may be a single-byte string variable (STRING) or a two-byte string variable (NSTRING).
  
      source-string    is the source string before any translation. This may be a single-byte string variable (STRING) or a two-byte string variable (NSTRING).
  
      xlate-format   is the name of format of target-string after translation. See XLATEFROM for a list of formats.
  
         Examples of XLATEFROM and XLATETO:
  
          The script:

                  DEFINE src : STRING VALUE "Taurus"
                  PRINT "To   Base16:", XLATETO  (src, "Base16")
                  PRINT "To   Base64:", XLATETO  (src, "Base64")
                  PRINT "From Base16:", XLATEFROM("546175727573", "Base16")
                  PRINT "From Base64:", XLATEFROM("VGF1cnVz", "Base64")
  

          Has this output:

                  To   Base16: 546175727573
                  To   Base64: VGF1cnVz
                  From Base16: Taurus
                  From Base64: Taurus