Configuring Access to Data Files Through AcuServer

Note: It is assumed that your environment and server is already configured correctly for using AcuServer.

Syntax:

To access a data file through AcuServer, the following syntax must be passed to the file handler:

acurfap://servername:[port]:/path/to/file

acurfap://: The protocol to use for AcuServer. This does not change.
servername: The name of the AcuServer server.
port: The server port to use when connecting to AcuServer. This is optional, and if omitted, the default port number is used.
path/to/file: The path name to the file.

Specifying the file explicitly:

You can specify the full syntax in the SELECT statement. For example, the following statement connects to the server asvr1, on port 3011, then locates the file idx1 at /home/idx/.

...
select acusvridx assign to acurfap://asvr1:3011:/home/idx/idx1.
...

Specifying the file implicitly:

If you are not explicitly using the AcuServer syntax in your SELECT statement, for example:

...
select acusvridx assign to idx1.
...

you must specify it in the COBDATA environment variable using the syntax described above:

set COBDATA=%COBDATA%; "acurfap://servername:port:path/to/file"

export COBDATA=$COBDATA: '"acurfap://servername:port:path/to/file"'

The following example connects to the server asvr2, on the default port, then locates the file in the SELECT statement at /home/idx/.

set COBDATA=%COBDATA%; "acurfap://asvr2::c:\idx"

export COBDATA=$COBDATA: '"acurfap://asvr2::/home/idx"'

Note: An additional set of quotation marks is required around the AcuServer syntax to preserve the original quotation marks.

If a path name is specified in COBDATA, it is prepended to the file name before file name mapping takes effect.

You must also compile with FILETYPE=17 if you are using a sequential file, or if your file handling configuration file does not specify IDXFORMAT=17 for the Vision file.

File name mapping:

If you have used any ACUCOBOL file name mapping techniques to specify an AcuServer file, you will need to update the configuration to use Micro Focus file name mapping. Use the following table as a guide to some of the equivalents in this COBOL system.

ACUCOBOL variable	Replace with
FILE_CASE	FILECASE configuration option
FILE_PREFIX	COBDATA environment variable
FILE_SUFFIX	FILESUFFIX configuration option
APPLY_FILE_PATH	n/a
FILE_ALIAS_PREFIX	dd_ mapping

Restrictions

The encryption and password protection features are not supported in Visual COBOL.