|
On Windows systems, XFRAME Batch Environment is configured by two files: xrun.conf and xgdg.conf.
xrun.conf
This file controls the behaviour of XFRAME batch runtime on Windows. It must be located in the %HOMEDRIVE%%HOMEPATH%\etc folder of the user running the batch job. To load an alternate configuration you may set the XRUN_CONF environment variable, assign the full path to your xrun.conf. I.e.
set XRUN_CONF="C:\xrun.conf"
The configuration file supports the following instructions:
Parameter definition
General parameters are defined using the set directive
Syntax
set <parameter>[=<value>]
Parameters
dbid=<id>
|
Specifies the connection string, in the format user/password@database_identifier
|
abend_threshold=<value>
|
defines the abend return code threshold. When the return code is equal or greater to the specified value, the program handled as abnormally terminated, and CATLG dispositions, if active, are properly handled. The default value is 12.
|
sql_loader=<pgm>
|
if set, the runtime uses the specified SQL loader program <pgm>
|
redirect_sysout
|
if set, the runtime redirects the STDOUT on the SYSPRINT file specified by the SYSOUT DD.
|
redirect_sysprint
|
if set, the runtime redirects the STDOUT on the SYSPRINT file specified by the SYSPRINT DD
|
show_dd
|
if set, the runtime logs all the DD link set up for the program
|
show_cards
|
if set, the runtime shows the data cards (SYSIN) provided to the program
|
xbm
|
if set, the runtime interfaces XBM
|
vse_mode
|
if set, the runtime will emulate the VSE file link (DLBL) management. By default the runtime emulates the MVS DD management style.
|
handle_catlg
|
if set, the runtime handles the CATLG disposition, creating an empty file whenever required
|
define standalone <pgm>
|
defines <pgm> as a standalone program (no RTS or loader is invoked)
|
default_object_type=<value>
|
defines the default object type. Admitable values:
If no value is specified, objects are run by the COBOL runtime system
If value is set to "exe" programs are directly executed, without any RTS
|
The database identifier
The database identifier, specified in the connection string with the parameter database_identifier, is name used by the database communication layer to identify a local or remote database instance. It corresponds at the following objects, depending on the database in use.
Database
|
Value
|
Oracle Database
|
The TNS name of the instance, as referred in sqlnet.ora
|
IBM UDB
|
The database name as defined in the local UDB instance
|
MS SQL Server
|
The ODBC connection name that identifies the SQL Server instance
|
ODBC database connections
|
The ODBC connection name that identifies the ODBC database instance
|
Standalone program definition
You may define some programs as standalone, thus not requiring the XFRAME runtime system
Syntax
define standalone <program>
Parameters
standalone <program>
|
name of the standalone program
|
Sample
#
# xrun.conf
#
set rdbms=oracle
set dbid=scott/tiger@ORCL
set redirect_sysprint
set show_dd
set show_cards
set xbm
define standalone IEBGENER
define standalone RUNFTP
xgdg.conf
This is the file which controls the behaviour of the GDG subsystem and it is named xgdg.conf and must be located in the %HOMEDRIVE%%HOMEPATH%\etc directory of the user running the batch job. To load an alternate configuration you may set the XGDG_CONF environment variable, assign the full path to your xgdg.conf. I.e.
set XGDG_CONF="C:\xgdg.conf"
Configuration is specified using the following commands
Parameter definition
General parameters are defined using the set directive
Syntax
set <parameter>[=<value>]
Parameters
verbose
|
if specified xgdg runs in verbose mode
|
keep=<threshold>
|
defines the return code threshold for files cataloging. When the Job return code is greater than the defined threshold, the runtime will not catalogue the new GDG versions created during the job run.
|
Files definition
In order to have GDG working properly on a certain file it must be defined in xgdg.conf. If a file is not defined but GDG handling is requested for it, default values are assumed.
Syntax
define name=<fileid> [group=<gdg>] [record_length=<recl>]
Parameters
name=<fileid>
|
this parameter is mandatory. It defines the file identifier, which can be:
| • | a path relative to $XVSAM |
|
group=<gdg>
|
specifies the GDG width. Default is 8 (eight)
|
record_length=<recl>
|
specifies the record length for the file. If xrun runs in EBM mode, the parameter specifies the ddname_LRECL parm (in lrecl is not specified in the dlbl_)
|
An example
#
# configuration for xgdg
#
set keep=8
set verbose
define name=C:\home\rttydata\FILE01 group=42
define name=FLATCAT\CATE.BKUP00.PROVA group=50
| 
