Upload Files to a Microsoft SQL Server Datastore

Attention: This feature is in Early Adopter Program (EAP) release status. We will continue the development of additional features and provide additional interfaces via patch updates and future releases. Please contact Micro Focus SupportLine if you require further clarification.

Use these steps to create the datastore databases that correspond to the data sources you previously created. You can then upload existing data files to the datastore.

Open an Enterprise Developer command prompt.

Note: On Windows, the command prompt must be the same bitism as the ODBC data source that you intend to use.
Set the MFDBFH_CONFIG environment variable to locate the MFDBFH.cfg file that contains a reference to the data source:
```
set MFDBFH_CONFIG=<location-and-name-of-file>
```
If you do not set this variable, the file is assumed to be located in the current directory.

Note: The MFDBFH_SCRIPT_DIR environment variable is also required to point to the stored procedures used to interact with a datastore; however, this variable is implicitly set already when using an Enterprise Developer command prompt.
Using the dbfhdeploy command line utility, create the datastore:
```
dbfhdeploy data create URL/<datastore-name>
```
<datastore-name> must correspond to the datastore name you specified when creating the data source for your database. For example, VSAM would be the <datastore-name> in the following database: MicroFocus$SEE$Files$VSAM. For the URL details, see The dbfhdeploy Command Line Utility.

The datastore database is created, along with a number of default tables and stored procedures.
Add a data file to the datastore:
```
dbfhdeploy data add <filename> URL/<file-ref>[?folder=<folder-name>]
```
If <folder-name> does not already exist, it is created.
To test that the data file is now in the datastore, you can produce a listing of files and folders in the database using dbfhdeploy:
```
dbfhdeploy list URL[?folder=<folder-name>]
```
A list of files is displayed.

Note: If you do not specify a folder name, only files and folders at the base level of the datastore are displayed.

If any of the files in your datastore are transactional, you must also configure an XA resource within the enterprise server region that points to the datastore; see Create an XA Resource. If none of your files are transactional, you can skip that step and proceed to configuring your CICS or batch (JCL) applications to use the file(s) in the datastore, and if resource locking is to be managed by an enterprise server region, configuring region and cross-region databases.