z/VM

The sample command sequence that follows contains the steps required to make a host language source program with embedded SQL into form of executable modules.

The host language for the example is COBOL. Change the specification of precompiler name, precompiler options, and compiler name according to the host language and version of your program.

Following the example is a table that gives the meaning of variables used in the examples and a set of usage notes.

Commands for Central Version Execution

/*****************************************************************/
/**                  PRECOMPILE COBOL PROGRAM                   **/
/*****************************************************************/

FILEDEF sysipt1 DISK program source a
FILEDEF sysidms1 DISK sysidms1 parms a
FILEDEF syspch DISK progname COBOL A3

FILEDEF SYSLST PRINTER
OSRUN IDMSDMLC PARM='optional precompiler parameters'

/*****************************************************************/
/**                  CREATE ACCESS MODULE                       **/
/*****************************************************************/

FILEDEF sysipt2 DISK create accmod a
FILEDEF sysidms2 DISK sysidms2 parms a
OSRUN IDMSBCF

/*****************************************************************/
/**                  COMPILE COBOL PROGRAM                      **/
/*****************************************************************/

FILEDEF TEXT DISK progname TEXT A3
COBOL progname (OSDECK APOST LIB
TXTLIB DEL utextlib progname
TXTLIB ADD utextlib progname

/*****************************************************************/
/**                  LINK PROGRAM MODULE                        **/
/*****************************************************************/

FILEDEF SYSLST PRINTER
FILEDEF SYSLMOD uloadlib LOADLIB A6 (RECFM V LRECL 1024 BLKSIZE 1024
FILEDEF objlib DISK utextlib TXTLIB a
FILEDEF SYSLIB DISK coblibvs TXTLIB p
LKED linkctl (LIST XREF LET MAP RENT NOTERM PRINT SIZE 512K 64K

Linkage editor control statements (in linkctl):

INCLUDE objlib(progname)
INCLUDE objlib1(IDMS)
ENTRY   progname
NAME    progname(R)

Variable Definitions

Variable	Definition
coblibvs TEXTLIB p	Filename, filetype, and filemode of the library that contains host language compiler modules
create accmod a	Filename of the file containing the CREATE ACCESS MODULE statement
linkctl	Filename of the file that contains the linkage editor control statements
loadlib	DDname of the load library containing the CA IDMS executable modules
objlib	DDname of the user object library
objlib1	DDname of the CA IDMS object library
program COBOL A3	Filename, filetype, and filemode of the precompiler output
progname	Name of the user program
program source a	Filename of the file containing the program source
sysidms1	DDname for the file of SYSIDMS parameters for the precompiler step
sysidms1 parms a	Filename of the file containing SYSIDMS parameters for the precompiler step
sysidms2	DDname for the file of SYSIDMS parameters for the step to create the access module
sysidms2 parms a	Filename of the file containing SYSIDMS parameters for the step to create the access module
sysipt1	DDname for the program source file
sysipt2	DDname for the file containing the CREATE ACCESS MODULE statement
syspch	DDname for the precompiler output
uloadlib LOADLIB A6	Filename, filetype, and filemode of the user load library
utextlib TXTLIB a	Filename, filetype, and filemode of the user text library