https://github.com/synergex/ismkey_dd_filespec
This is a modified version of the ismkey CodeExchange entry. It includes a subroutine that uses DD_FILESPEC to generate a file specification from a Repository structure, and a test program to demonstrate how to use the subroutine.
https://github.com/synergex/ismkey_dd_filespec
Last synced: 4 months ago
JSON representation
This is a modified version of the ismkey CodeExchange entry. It includes a subroutine that uses DD_FILESPEC to generate a file specification from a Repository structure, and a test program to demonstrate how to use the subroutine.
- Host: GitHub
- URL: https://github.com/synergex/ismkey_dd_filespec
- Owner: Synergex
- License: other
- Created: 2021-12-06T21:45:55.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2022-07-26T14:22:15.000Z (almost 4 years ago)
- Last Synced: 2025-08-29T10:49:54.371Z (10 months ago)
- Homepage:
- Size: 50.8 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# ismkey_DD_FILESPEC
**Created Date:** 1/10/2017
**Last Updated:** 1/10/2017
**Description:** This is a modified version of the ismkey CodeExchange entry. It includes a subroutine that uses DD_FILESPEC to generate a file specification from a Repository structure, and a test program to demonstrate how to use the subroutine.
**Platforms:** Windows
**Products:** Synergy DBL; Synergy DBMS; Repository
**Minimum Version:** 10.3.3a
**Author:** Tate Chamberlain
Additional Information:
This project contains a subroutine that will generate the parameters
required to create an ISAM file based on a structure and file definition
in the Synergy/DE Repository. It also includes a test program that will
run the subroutine from the command line, with the name of the structure
as a command line argument.
This project is based on the earlier CodeExchange entry "ismkey.zip".
Some of the modifications include:
- Using DD_FILESPEC instead of DD_FILE to get the file specifications.
This demonstrates one way to use DD_FILESPEC, since there aren't
many examples.
- Support for both structures where the kref value is explicitely
defined for each key and structures where the value is implicit.
Provides an error message if a combination is attempted or if a
kref value other than 0 is drepeated.
- Removed code that relied on UI Toolkit.
- Program made more user friendly, accepting the structure name
as a command line argument instead of hard-coding it.
- Various other code improvements.
- Workbench project converted to Visual Studio Traditional Synergy
project.
Instructions
------------
To use the ismkey subroutine, inclue the ismkey.dbl source file in your
program.
To run the test program, open ismkey.sln in Visual Studio, and use Visual
Studio to build the program. Then run the program. It should create an
ISAM file in the 'dat' folder.
The program accepts the name of a Repository structure as a command line
argument, and creates a file based on the specs for the first file that
structure is assigned to.
The test program comes with a sample Repository file that contains a
single structure ("TESTSTRUCT"), which is assigned to the signle file
("DATADIR:FILETEST.ISM"). The Visual Studio project is set up to use that
Repository structure (all of the appropriate environment variables are set,
and the command line argument "teststruct" is provided on the Debug property
page), so all you have to do is run the program.
To run the test program with your own Repository, either modify the command
line argument in the project's properties or run the program from the
command line and give it the appropriate structure name. In either case,
make sure to set the environment variabls (e.g. RPSMFIL and RPSTFIL) to
point to the Repository you want to use.
When running from the command line, I would recommend running the program
with dbs instead of dbr to avoid the Synergy runtime window appearing for
a moment and disappearing again. Aside from that, it should run fine in
either dbs or dbr.
The Workbench project is also included in case you don't have Visual Studio
or you would simply prefer to build and run in Workbench instead of Visual
Studio.
This code example is intended to be used with Traditional Synergy on
Windows, but the code should be able to work on Unix, OpenVMS, and Synergy
.NET on Windows as well. Some modification may be necessary.