VisualAge Generator to Enterprise Generation Language Migration Guide

Linkage table parts

The linkage table parts are Calllink, Filelink, Crtxlink, and Dxfrlink.

callLink


Figure 123. Linkage table options for :calllink

VisualAge Generator 4.5
EGL produced by the migration tool Migration tool considerations
:calllink callLink No special considerations.
linktype=xxxx

xxxx is one of the following:

  • dynamic
  • static
  • cicslink
  • remote
  • csocall
  • sessionejb

Type of call, where the EGL equivalent options are the following:

  • localCall
  • localCall
  • localCall
  • remoteCall
  • remoteCall
  • ejbCall

If the VAGen linktype is omitted, the migration tool uses localCall. The migration tool also uses linktype in additional places to set other properties for the EGL CallLink information.
applname=programName

programName is the name of the program being called. Wildcards are permitted.

pgmName="programName" No special considerations.
externalname=applname alias="applname" If your VAGen program had to be renamed because the name was an EGL reserved word, you can use the alias property either on the program definition or in the linkage table to provide the original VAGen name for the program as the name of the generated program. Either technique can help you avoid having to modify non-VAGen programs that call the VAGen program.
package=packageName package="packageName" No special considerations.
library=libraryName
 
 
OR
dllname=libraryName

In VisualAge Generator, library and dllname are treated as synonyms.

library="libraryName" The migration tool merges the VAGen library or dllname into the EGL library property.
linktype=xxxx

xxxx is one of the following:

  • dynamic
  • static
  • cicslink
linkType="xxxx"

xxxx is one of the following:

  • DYNAMIC
  • STATIC
  • CICSLINK
No special considerations.
parmform=xxxx

xxxx is one of the following:

  • oslink
  • commptr
  • commdata
  • cicsoslink
parmForm="xxxx"

xxxx is one of the following:

  • OSLINK
  • COMMPTR
  • COMMDATA
  • CICSOSLINK
No special considerations.
contable=xxxx

xxxx is one of the following:

  • a conversionTableName
  • *
  • EZECONVT
  • BINARY
  • NONE
conversionTable="xxxx"

xxxx is one of the following:

  • converstionTableName
  • *
  • PROGRAMCONTROLLED
  • not supported
  • not supported

The migration tool uses the same conversionTableName when creating the EGL CallLink information.

The migration tool migrates the VAGen contable=BINARY to BINARY, which is an unsupported value in EGL. The migration tool also issues an error message. There will be an error on the Tasks list. You must correct the error by editing the .eglbld file and selecting the supported value that you want to use.

The migration tool omits the conversionTable property if the VAGen contable=NONE.

location=xxxx

xxxx is one of the following:

  • systemName
  • EZELOC
location="xxxx"

xxxx is one of the following:

  • systemName
  • PROGRAMCONTROLLED
No special considerations.
remotecomtype=xxxx

xxxx is one of the following:

  • appcims
  • ca400
  • cicsclient
  • dce
  • dcesecure
  • direct
  • exci
  • ipc
  • java400
  • lu2
  • tcpip
remoteComType="xxxx"

xxxx is one of the following:

  • not supported
  • not supported
  • CICSECI
  • not supported
  • not supported
  • DIRECT
  • not supported
  • DISTINCT
  • JAVA400
  • not supported
  • TCPIP

The migration tool converts cicsclient to CICSECI because that is the closest corresponding EGL value. If the VAGen :calllink entry did not already specify the ctgport and ctglocation, the migration tool issues an error message to remind you to specify these values.

The migration tool migrates the values listed as not supported "as is" and issues a message. You must determine what communications protocol you want to use now and then update the EGL CallLink entry with the correct information. There will be an error on the Tasks list until you correct the CallLink information.

If you decide to use CICSSSL, you must add the ctgPort, ctgLocation, ctgKeyStore, and ctgKeyStorePassword properties to the EGL CallLink information.

If you decide to use CICSJ2C, you must add the pgmName, conversionTable, remotePgmType, luwControl, remoteBind, location, and parmForm properties to the EGL CallLink information.

remoteapptype=xxxx

xxxx is one of the following:

  • vg
  • nonvg
  • vgjava
  • itf
remotePgmType="xxxx"

xxxx is one of the following:

  • EGL
  • EXTERNALLYDEFINED
  • not applicable
  • not supported

If the VisualAge Generator remoteapptype=vgjava, the migration tool migrates the :calllink entry, but omits the remotePgmType property.

If remoteapptype=itf, the migration tool turns the entire :calllink entry into a comment.

serverid=serverName serverID="serverName" No special considerations.
luwcontrol=xxxx 

xxxx is one of the following:

  • client
  • server
luwControl="xxxx"

xxxx is one of the following:

  • CLIENT
  • SERVER
No special considerations.
remotebind=xxxx

xxxx is one of the following:

  • generation
  • runtime
remoteBind="xxxx"

xxxx is one of the following:

  • GENERATION
  • RUNTIME
No special considerations.
providerURL=URLName providerURL="URLName" No special considerations.
ctglocation='tcpipInfo' ctgLocation="tcpipInfo" No special considerations.
ctgport=portID ctgPort="portID" No special considerations.
bitmode=nn

nn is one of the following:

  • 16
  • 32
Not supported. The migration tool includes this option as a comment.
binform=xxxx 

xxxx is one of the following:

  • intel
  • host
Not supported. The migration tool includes this option as a comment.
Not supported.

In VisualAge Generator, you specify the NOMAPS option on a CALL statement to achieve better performance if the called program does not send any maps to the screen.

refreshScreen="YES" | "NO"

The migration tool does not set this property. If you previously specified NOMAPS for a VAGen call statement, you can continue to use the noRefresh option on the EGL CALL statement if you use the vagCompatibility="YES" build descriptor option. Alternatively, you can obtain the same support by specifying refreshScreen="NO" on the CallLink entry for the called program.

Not used.

None of the communication protocols supported by VisualAge Generator required this information.

ctgKeyStore
ctgKeyStorePassword

The migration tool does not set this property. ctgKeyStore and ctgKeyStorePassword are required if you decide to use remoteComType="CICSSSL".

Not used.

In VisualAge Generator, you use the /system=JAVAWRAPPER generation option whenever you want to generate a Java wrapper for a called batch program.

javaWrapper="YES" | "NO"

The migration tool does not set this property. You must specify javaWrapper="YES" if you want a Java wrapper to be generated whenever you generate the called program.

fileLink


Figure 124. Linkage table options for :filelink

VisualAge Generator 4.5
EGL produced by the migration tool Migration tool considerations
:filelink fileLink No special considerations.
linktype=xxxx

xxxx is one of the following:

  • local
  • remote

In VisualAge Generator, the default is local.

Type of file, where the EGL equivalent options are as follows:

  • localFile
  • remoteFile

.If the VAGen linktype is not specified, the migration tool converts to localFile.
filename=fileName

fileName is the name of a file in a VAGen record definition. Wildcards are permitted.

fileName="fileName" No special considerations.
contable=xxxx

xxxx is one of the following:

  • a conversionTableName
  • *
  • EZECONVT
  • BINARY
conversionTable="xxxx"

xxxx is one of the following:

  • conversionTableName
  • *
  • PROGRAMCONTROLLED
  • not supported

The migration tool uses the same conversionTableName when creating the EGL FileLink information.

The migration tool migrates the VAGen contable=BINARY to BINARY, which is an unsupported value in EGL. The migration tool also issues an error message. There will be an error on the Tasks list. You must correct the error by editing the .eglbld file and selecting the supported value that you want to use.

location=xxxx

xxxx is one of the following:

  • CICS
  • EZELOC
locationSpec="xxxx"

xxxx is one of the following:

  • CICS
  • PROGRAMCONTROLLED
No special considerations.

Crtxlink


Figure 125. Linkage table options for :crtxlink

VisualAge Generator 4.5
EGL produced by the migration tool Migration tool considerations
:crtxlink asynchLink No special considerations.
linktype=xxxx

xxxx is one of the following:

  • local
  • remote
Note:
In VisualAge Generator the default is local.

Type of file, where the EGL equivalent options are the following:

  • localAsynch
  • remoteAsynch

If the VAGen linktype is not specified, the migration tool converts to localAsynch.
recdname=recordName

recordName is the name of a VAGen record definition. Wildcards are permitted.

recordName="recordName" No special considerations.
contable=xxxx

xxxx is one of the following:

  • a conversionTableName
  • *
  • EZECONVT
  • BINARY
conversionTable="xxxx"

xxxx is one of the following:

  • conversionTableName
  • *
  • PROGRAMCONTROLLED
  • not supported

The migration tool uses the same conversionTableName when creating the EGL AsynchLink information.

The migration tool converts the VAGen contable=BINARY to BINARY, which is an unsupported value in EGL. The migration tool also issues an error message. There will be an error on the Tasks list. You must correct the error by editing the .eglbld file and selecting the supported value that you want to use.

location=xxxx

xxxx is one of the following:

  • CICS
  • EZELOC
locationSpec="xxxx"

xxxx is one of the following:

  • CICS
  • PROGRAMCONTROLLED
No special considerations.
package=packageName package="packageName" No special considerations.

Dxfrlink


Figure 126. Linkage table options for :dxfrlink

VisualAge Generator 4.5 EGL produced by the migration tool Migration tool considerations
:dxfrlink transferToProgram No special considerations.
fromappl=programName

programName is the name of the program that is transferring with a DXFR to another program. Wildcards are not permitted.

fromPgm="programName" No special considerations.
toappl=programName2

programName2 is the name of the program to which the transfer is occurring.

toPgm="programName2" No special considerations.
linktype=xxxx

xxxx is one of the following:

  • dynamic
  • static
  • noncsp
linkType="xxxx"

xxxx is one of the following:

  • DYNAMIC
  • STATIC
  • EXTERNALLYDEFINED

If you previously specified NONCSP for a VAGen DXFR statement, you can continue to use the externallyDefined option on the EGL transfer to program statement if you include vagCompatibility="YES" in your build descriptor options. Alternatively, you can obtain the same support by specifying linkType= "EXTERNALLYDEFINED" on the transferToProgram entry for the program to which you are transferring.

Not supported. alias="applname"

If your VAGen program had to be renamed because the name was an EGL reserved word, you can use the alias property either on the program definition or in the linkage table to provide the original VAGen name for the program as the name of the generated program. Either technique can help you avoid having to modify non-VAGen programs that call the VAGen program.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]