This macro generates the User Requirements Interface for batch programs. For CICS, the interface is generated by the DBCVTPR macro. This macro produces the module DBCSVPR, which is link edited with your program. See CA Datacom CICS Services documentation for details.
In the batch environment, the User Requirements Interface must be link edited with your program, which is described in Program Compilation, Link-Edit and Execution.
Note: In z/VSE only, specifying VSERC= in the DBURNIF macro specifies whether a return code is being passed by the application to the operating system in Register 15. If YES is specified, Register 15 is passed to z/VSE unchanged. If NO is specified, Register 15 is ignored by z/VSE. Valid entries for VSERC= are YES or NO. The default is NO.
Application Program Entry Point
If you want CA Datacom/DB to open and close its environment, your program must be executed as a subroutine of CA Datacom/DB. Your program must be linked using an ENTRY BEGIN control statement. Each language has other special requirements discussed in the following:
The value of USRNTRY= in the DBURINF macro defaults to DBMSCBL, which is the name generated in the source by the Preprocessor. If you want a name other than DBMSCBL, specify that name as the USRNTRY= value in the DBURINF macro of the User Requirements Table and for the Preprocessor option of the same name.
The value of USRNTRY= in the DBURINF macro must be the appropriate PL/I entry point, commonly PLISTART.
The value of USRNTRY= in the DBURINF macro must be the program's entry point.
An alternate method is to use the Preprocessor to generate a consistently named entry point. Using this method, a single User Requirements Table assembly may be linked with numerous programs. At preprocess time, the REFNTRY= option must be specified. The value of REFNTRY= is an existing ENTRY or CSECT in the program. To complete the process, use the USRNTRY= option to specify the consistent name. If you do not use the USRNTRY= option, a default name, SQLEXECE, is generated.
Your program, regardless of the language, may control the opening and closing of CA Datacom/DB using the langauge. See the CA Datacom/DB Database and System Administration Guide for more information.
|
Copyright © 2014 CA.
All rights reserved.
|
|