Figure 121. Generation options
VisualAge Generator 4.5
| EGL produced by the migration tool | Migration tool considerations |
---|---|---|
VAGen generation options part:
| EGL build descriptor part:
|
If your VAGen control parts are all in the same VisualAge Java package or VisualAge Smalltalk application, the control parts will all be placed in the same .eglbld file. In this situation, no import statements are required. If your VAGen control parts are in different VisualAge Java packages or
VisualAge Smalltalk applications, the migration tool does not create the
import statements. You will need to add the import statements.
There will be an error on the Tasks list if EGL is unable to resolve
references to other control parts.
|
VAGen generation option values are only enclosed in quotes if they contain special characters for a directory or file name. | EGL build descriptor option values must be enclosed in quotes. However, if you use the EGL Build Parts Editor, the editor automatically inserts the quotes for you into the XML source. You do not see the quotes in the editor. | The migration tool includes the quotes automatically when it builds the XML source for the .eglbld file. |
Many VAGen generation options can be specified as /xxxx or /noxxxx to
reflect the positive or negative of the generation option. The
following is an example:
| Many EGL build descriptor options can be specified as xxxx="YES" or
xxxx="NO" to reflect the positive or negative of the build descriptor
option. The following is an example:
| The migration tool processes the options as follows:
|
/ansisql | Not supported. | The migration tool includes this option as a comment. |
/bidicontable=xxxx | bidiConversionTable="xxxx" | No special considerations. |
/bind=xxxx In VisualAge Generator, xxxx is the suffix of the bind part. The bind part for a program is named pgmname.xxxx, where xxxx is the suffix specified by the /bind option. The reasons you might have specified a /bind=suffix are as follows:
|
bind="xxxx" The meaning of the bind option is not the same as in VisualAge Generator. In EGL, xxxx is the full name of the bind part. The bind option only needs to be specified if the bind part name differs from that of the program. In most cases, the program and bind part will have the same name, so there is no need to include the bind option. The bind option is only necessary if you generate the same program for multiple runtime environments and require special bind commands for each environment. Another use for the bind option is to specify the name of a part that
contains a template for your bind command. A project administrator or
DBA can define a bind part that includes substitutable SYMPARMS for
member-specific parameters. You can use the EGL bind option to point to
this template part. This technique works well if you bind a package for
each program.
| Because the value for bind has different meanings in VisualAge Generator and EGL, the migration tool cannot migrate this option. The migration tool includes /bind as a comment. |
/checktype=xxxx xxxx is one of the following:
|
checkType="xxxx" xxxx is one of the following:
| No special considerations. |
/cicsdbcs | Not supported. | The migration tool does not include this option as a comment because all supported CICS translators now include support for DBCS. |
/cicsentries=xxxx xxxx is one of the following:
|
cicsEntries="xxxx" xxxx is one of the following:
| No special considerations. |
/cobollevel=le | vs | Not supported. | The migration tool includes this option as a comment. |
commentlevel=n or /commentlevel=commentText n or commentText are one of the following:
|
commentLevel="n" n is one of the following:
|
The migration tool migrates /commentlevel=0 or minimum to 0 and all other
values to 1.
|
/configmapname="xxxx" xxxx is the name of a VisualAge Smalltalk configuration map. | Not supported. | The migration tool includes this option as a comment because it might be useful in determining groups of related EGL projects that should be checked into your source code repository as a unit. |
/configmapversion="xxxx" xxxx is the version name of the VisualAge Smalltalk configuration map specified by /configmapname. | Not supported. | The migration tool includes this option as a comment because it might be useful in determining groups of related EGL projects that should be checked into your source code repository as a unit. |
/contable=xxxx xxxx is the name of a conversion table. |
clientCodeSet="yyyy" serverCodeSet="zzzz" yyyy and zzzz are the names of the client and server conversion tables, respectively. |
The migration tool sets both the clientCodeSet and the
serverCodeSet options from the VAGen /contable generation
option. See Figure 122 for the correspondence between the VAGen and EGL
values. If the value for /contable=xxxx is not in Figure 122 , the migration tool sets both clientCodeSet and
serverCode to xxxx.
|
/createdds | genDDSFile="YES" | "NO"
| No special considerations. |
/currency=xxx (1 to 3 characters) | currencySymbol="xxx" | No special considerations. |
/data = 24 | 31 | data="24" | "31" | No special considerations. |
/dbms=xxxx xxxx is one of the following:
|
dbms="xxxx" xxxx is one of the following:
| The migration tool changes odbc to DB2 and issues a warning message. |
/dbpassword=xxxx | sqlPassword="xxxx" | The migration tool merges the VAGen /dbpassword and /sqlpassword options into the EGL sqlPassword option. If a generation options part includes both /dbpassword and /sqlpassword, the migration tool includes the sqlPassword twice. There should be an error on the Tasks list. |
/dbuser=xxxx | sqlID="xxxx" | The migration tool merges the VAGen /dbuser and /sqlID options into the EGL sqlID option. If a generation options part includes both /dbuser and /sqlID, the migration tool includes the sqlID twice. There should be an error on the Tasks list. |
/debugtrace | debugTrace="YES" | "NO" | No special considerations. |
/destaccount=xxxx | Not supported. | The migration tool includes this option as a comment. |
/destdir=xxxx | destDirectory="xxxx" | No special considerations. |
/desthost=xxxx | destHost="xxxx" | No special considerations. |
/destlib=xxxx | destLibrary="xxxx"
| No special considerations. |
/destpassword=xxxx | destPassword="xxxx" | No special considerations. |
/destuid=xxxx | destUserID="xxxx" | No special considerations. |
/dxfrcancel | cancelAfterTransfer="YES" | "NO" | No special considerations. |
/dxfrxctl | useXctlForTransfer="YES" | "NO" | No special considerations. |
/ejbgroup=xxxx | Not supported. | The migration tool includes this option as a comment. |
/endcommarea | endCommarea="YES" | "NO" | No special considerations. |
/errdest=xxxx | errorDestination="xxxx"
| No special considerations. |
/fastpath | imsFastPath="YES" | "NO"
| No special considerations. |
/fold | Not supported. | The migration tool includes this option as a comment. |
/ftptranslationcmddbcs=xxxx | Not supported. EGL only supports TCP/IP for transferring files to the host. | The migration tool includes this option as a comment. |
/ftptranslationcmdsbcs=xxxx | Not supported. EGL only supports TCP/IP for transferring files to the host. | The migration tool includes this option as a comment. |
/genauthortimevalues | Not supported. | The migration tool includes this option as a comment. |
/genhelpmaps | genHelpFormGroup="YES" | "NO" | No special considerations. |
/genmaps | genFormGroup="YES" | "NO" | No special considerations. |
/genout=xxxx | genDirectory="xxxx" | No special considerations. |
/genproperties /nogenproperties |
genProperties="GLOBAL" genProperties="NO" EGL also provides genProperties="PROGRAM". | The migration tool converts /genproperties to the EGL genProperties="GLOBAL" because this is the closest value in terms of what is generated. |
/genresourcebundle | Not supported. | The migration tool includes this option as a comment. |
/genret | genReturnImmediate="YES" | "NO" | No special considerations. |
/gentables | genDataTables="YES" | "NO" | No special considerations. |
/genuirecords | genUIRecords="YES" | "NO"
| No special considerations. |
/groupname=xxxx | Not supported. | The migration tool includes this option as a comment. |
/inedit=all /inedit=inonly |
validateOnlyIfModified="NO" validateOnlyIfModified="YES" | No special considerations. |
/initaddws In VisualAge Generator, the primary working storage record is always initialized. The /initaddws generation option provides initialization of other working storage records specified on the Tables and Additional Records list. |
initNonIOData="YES" | "NO" In EGL, the record specified as the inputRecord for main programs is always initialized. The initNonIOData build descriptor option provides initialization of other basic records specified in the data declarations for the program. In addition, EGL enables you to specify the initialized property for any record declaration in the program. The initialized property provides a finer control than the initNonIOData build descriptor option. |
The migration tool migrates the primary working storage record for main
programs to the EGL inputRecord property and also includes the
record declaration without the initialized property. The migration tool
migrates the primary working storage record for called programs to a record
declaration with the initialized property. If the migration tool
created an additional record for level 77 items, the migration tool includes a
data declaration for the record and also includes the initialized
property. This provides the same initialization for primary working
storage records as in VisualAge Generator. All other basic records are
initialized based on the initNonIOData build descriptor
option.
|
/initrecd | initIORecords="YES" | "NO" | No special considerations. |
/javadestdir=xxxx | Not supported. | The migration tool includes this option as a comment. |
/javadesthost=xxxx | Not supported. | The migration tool includes this option as a comment. |
/javadestpassword=xxxx | Not supported. | The migration tool includes this option as a comment. |
/javadestuid=xxxx | Not supported. | The migration tool includes this option as a comment. |
/javasystem=xxxx | Not supported. | The migration tool includes this option as a comment. |
/jobcard=xxxx | Not supported. The MVS build server handles the jobcard. | The migration tool includes this option as a comment. |
/jobname=xxxx | Not supported. However, you can use $USERID as the job name in the
build script. EGL generation substitutes $USERID with the value from
the destUserID build descriptor option concatenated with a number to provide a
unique job name.
| The migration tool includes this option as a comment. |
/jspreldir="xxxx" | Not supported. The JSP is no longer generated from EGL source. | The migration tool includes this option as a comment. |
/leftjust | leftAlign="YES" | "NO" | No special considerations. |
/lineinfo | Not supported. | The migration tool does not include this option as a comment because the option was only meanighful for IBM support to debug the VAGen generator. It had no effect on the generated COBOL. |
/lines=nn | Not supported. | The migration tool includes this option as a comment. |
/linkage=xxxx xxxx is the name of a VAGen linkage table part. |
linkage="xxxx" xxxx is the name of an EGL linkage options part. | No special considerations. |
/linkedit=xxxx In VisualAge Generator, xxxx is the suffix of the linkedit part. The linkedit part for a program is named pgmname.xxxx, where xxxx is the suffix specified by the /linkedit option. The reasons you might have specified a /linkedit=suffix are as follows:
|
linkEdit="xxxx" The meaning of linkEdit is not the same as in VisualAge Generator. In EGL, xxxx is the full name of the linkedit part. The linkEdit option only needs to be specified if the linkedit part name differs from that of the program. In most cases, the program and linkedit part will have the same name, so there is no need to include the linkEdit option. The linkEdit option is only necessary if you generate the same program for multiple runtime environments. | Because the value for linkedit has different meanings in VisualAge Generator and EGL, the migration tool cannot migrate this option. The migration tool includes /linkedit as a comment. |
/listing /listingonerror /nolisting
| Not supported. | The migration tool includes this option as a comment. |
/locvalid | Not supported. | The migration tool includes this option as a comment. |
/log=xx OR /nolog |
imsLogID="xx" OR include /nolog as a comment
|
The migration tool processes this option as follows:
|
/math=xxxxx xxxxx is one of the following:
|
math="xxxxx" xxxxx is one of the following:
| No special considerations. |
/mfsdev=list-of-devices list-of-devices provides device information for generating VAGen maps into MFS source code for the IMS environment. | Not currently supported.
| The migration tool includes this option as a multi-line comment. |
/mfseattr /nomfseattr /mfseattrncd In VisualAge Generator, these 3 options provide a 3-way switch to give information that is needed to generate extended attribute support for maps in MFS format. |
mfsExtendedAttr="YES" mfsExtendedAttr="NO" mfsExtendedAttr="NCD"
| No special considerations. |
/mfsignore | mfsIgnore="YES" | "NO"
| No special considerations. |
/mfstest | mfsUseTestLibrary="YES" | "NO"
| No special considerations. |
/msgtableprefix=xxxx In VisualAge Generator, the message table prefix is specified on the program. When you generate the UI record by itself you must specify the message table prefix during generation. | Not supported. | The migration tool includes this option as a comment. |
/msp=xxxx xxxx is one of the following:
|
formServicePgmType="xxxx" xxxx is one of the following:
| No special considerations. |
/nullfill | fillWithNulls="YES" | "NO" | No special considerations. |
/numovfl | checkNumericOverflow="YES" | "NO" | No special considerations. |
/options=xxxx xxxx is the name of another VAGen generation options part. |
nextBuildDescriptor="xxxx" xxxx is the name of another EGL build descriptor part. | No special considerations. |
/packagename=xxxx | Not supported. | The migration tool includes this option as a comment. |
/possign=x x is one of the following:
|
positiveSignIndicator="x" x is one of the following:
| No special considerations. |
/prep | prep ="YES" | "NO" | No special considerations. |
/prepfile | buildPlan="YES" | "NO" | No special considerations. |
/printdest=xxxx xxxx is one of the following:
|
printDestination="xxxx" xxxx is one of the following:
| No special considerations. |
/project="xxxx"[,"version"] xxxx is the name of a VisualAge for Java project, and version is the version name for the specified project. | Not supported. | The migration tool includes this option as a comment because it might be useful in determining groups of related EGLprojects that should be checked into your source code repository as a unit. |
/projectid=xxxx | projectID="xxxx" | No special considerations. |
/recovery | restoreCurrentMsgOnError="YES" | "NO"
| No special considerations. |
/resource=xxxx xxxx is the name of a VAGen resource associations part. |
resourceAssociations="xxxx" xxxx the name of an EGL resource associations part. | No special considerations. |
/resourcebundlelocale=xxxx | Not supported.
In EGL this information is specified on the PageHandler part. | The migration tool includes this option as a comment. |
/resvword=xxxx | reservedWord="xxxx" | No special considerations. |
/rt=xxxx | returnTransaction="xxxx" | No special considerations. |
/runfile | genRunFile="YES" | "NO" | No special considerations. |
/sendtranslationcmddbcs=xxxx | Not supported.
EGL only supports TCP/IP for transferring files to the host. | The migration tool includes this option as a comment. |
/session=xxxx | Not supported.
| The migration tool includes this option as a comment. |
/setfull | setFormItemFull="YES" | "NO" | No special considerations. |
/sp | checkToTransaction="YES" | "NO" | No special considerations. |
/spa=xxxx | spaSize="nnnn"
| No special considerations. |
/spzero | spacesZero="YES" | "NO" | No special considerations. |
/sqldb=xxxx | sqlDB="xxxx" | No special considerations. |
/sqlid=xxxx | sqlID="xxxx" | The migration tool merges the VAGen /dbuser and /sqlID options into the EGL sqlID option. If a generation options part includes both /dbuser and /sqlID, the migration tool includes the sqlID twice. There should be an error on the Tasks list. |
/sqlpassword=xxxx | sqlPassword="xxxx" | The migration tool merges the VAGen /dbpassword and /sqlpassword options into the EGL sqlPassword option. If a generation options part includes both /dbpassword and /sqlpassword, the migration tool includes the sqlPassword twice. There should be an error on the Tasks list. |
/sqlvalid | validateSQLStatements="YES" | "NO" | No special considerations. |
/symparm=pppppppp,'vvvv'
|
EGL supports many of the same predefined symbolic parameters as VisualAge
Generator. You can also use any user-defined symbolic parameters as
long as they do not conflict with any of the new EGL symbolic
parameters.
|
The migration tool processes symbolic parameters as follows:
|
/SYMPARM=EZALTXTR,'xxxx' | transferErrorTransaction="xxxx" | No special considerations. |
/SYMPARM=EZONEAS2,'xxxx' | oneFormItemCopybook="YES" | No special considerations. |
/syncdxfr | synchOnPgmTransfer="YES" | "NO"
| No special considerations. |
/syncxfer | synchOnTrxTransfer="YES" | "NO" | No special considerations. |
/syscodes | sysCodes="YES" | "NO" | No special considerations. |
/system=xxxx xxxx is one of the following:
The following environments can also be specified in VAGen, but not in EGL: IMSBMP, IMSVS, JAVA, HP, JAVAGUI, WINGUI, OS2GUI, OS2, OS2CICS, AIXCICS, NTCICS, SOLARIS, SOLACICS, TSO, VMCMS, VMBATCH, VSEBATCH. VSECICS |
system="xxxx" xxxx is one of the following:
|
The migration tool processes this option as follows:
|
/targnls=xxx xxx is a 3-character national language code. |
targetNLS="xxx" xxx is the 3-character national language code. All the values except ENP (uppercase English) are identical in VisualAge Generator and EGL. ENP does not have a counterpart in EGL. | The migration tool uses the VAGen value as the targetNLS value. If the value is ENP, there will be an error on the Tasks list. You can edit the .eglbld file and change the value. You might want to use ENU (mixed case English) as a replacement for ENP. |
/templates=xxxx In VisualAge Generator, templates are used to generate the preparation and runtime JCL, as well as to generate CICS transaction and program entries. |
templateDir="xxxx" In EGL, build scripts replace build templates. The only templates that are used are to produce runtime JCL for the ZOSBATCH and ISERIESC target environment. | No special considerations. |
/trace=xxxx,yyyy xxxx is one of the following:
yyyy is optional. If yyyy is present, it is set to stmt. Any combination of none, sqlerr, or sqlio, with or without ,stmt , is valid. |
/trace splits into multiple build descriptor options:
| No special considerations. |
/transfertype=xxxx xxxx is one of the following:
| Not supported.
EGL only supports TCP/IP for transferring files to the host. | The migration tool includes this option as a comment. |
/transid=primaryID,restartID In VisualAge Generator, /transid=,restart is valid, with the primary transaction defaulting to the first 4 characters of the program name. |
/transid splits into multiple build descriptor options:
| No special considerations. |
/twaoff=nnnn | twaOffset="nnnn" | No special considerations. |
/unload In VisualAge Generator /unload directed batch generation to unload all VisualAge Java projects or VisualAge Smalltalk configuration maps that contained VAGen parts before loading the projects or configuration maps being requested for the current generation process. | Not supported. | The migration tool does not include a comment for this option. |
/validmix | validateMixedItems="YES" | "NO" | No special considerations. |
/vmloadlib=xxxx | Not supported. | The migration tool includes this option as a comment. |
/vselib=xxxx | Not supported. | The migration tool includes this option as a comment. |
/workdb=xxxx xxxx is one of the following:
|
workdb="xxxx" xxxx is one of the following:
|
The migration tool processes this option as follows:
|
Not used. | vagCompatibility="YES" | The migration tool always adds this option to every build descriptor part. |
In VisualAge Generator, decimalSymbol was a runtime property used when assigning or comparing CHA and NUM values in Java. |
decimalSymbol="x" x is one of the following:
In EGL, you can specify this information at generation time or at runtime. |
The migration tool does not set the decimalSymbol. You
can add this property to your build descriptor part if you plan to generate
Java source. If you do this, the decimalSymbol will be generated into
any EGL properties files. Alternatively, you can add the property
directly to the generated EGL properties file.
|
Not used. |
destPort="xxxx" In EGL, destPort specifies the port to use when transferring generation outputs to a host system to prepare them for execution. The destPort build descriptor option is required for the ZOSCICS and ZOSBATCH target environments. | The migration tool does not set destPort and there is no default value. However, the sample JCL for starting an MVS build server uses the default port of 5555. |
Not supported.
In VisualAge Generator, even if your program checks the value of EZESYS, all the VAGen source code must be valid for every target environment for which you might generate the program. |
eliminateSystemDependentCode= "YES" | "NO" In EGL, if your program checks the value of systemType, you can choose to omit source code that can never be run for your current target generation environment. This can make the resulting COBOL or Java source code smaller. | The migration tool does not set eliminateSystemDependentCode. The default value is "YES". |
Not used. | sessionBeanID="xxxx" | The migration tool does not set sessionBeanID. If you are generating Java or Java wrappers, see the EGL online helps to determine if you need to set the sessionBeanID build descriptor option. |
In VisualAge Generator, you include the SQL JDBC driver class, JNDI name,
and connection URL information in a properties file that is used at
runtime.
|
sqlJDBCDriverClass="xxxx" sqlJNDIName="xxxx" sqlValidationConnectionURL="xx" In EGL, you can specify this information at generation time or at runtime. |
The migration tool does not set the sqlJDBCDriverClass, sqlJNDIName, and sqlValidationConnectionURL. If you want to specify these values at generation time, you can do the following:
In either case, you must also include the genProperties="YES" build descriptor option so that the properties file will be generated. If you want to specify the value at runtime, you can modify the runtime
properties in either the J2EE deployment descriptor or a properties
file.
|
Not supported. | cicsj2cTimeout="nnnn" | The migration tool does not set the cicsj2cTimeout value. If you are generating Java, see the EGL online helps to determine if you need to set the cicsj2cTimeout build descriptor option. |
Figure 122. Generation options - conversion table values
(C) Copyright IBM Corporation 1992, 2005. All Rights Reserved.