VisualAge Generator to Enterprise Generation Language Migration Guide

Resource association part


Figure 127. Resource association

VisualAge Generator 4.5
EGL produced by the migration tool Migration tool considerations

In VisualAge Generator, a resource association part specifies how a file is to be implemented for a specific target environment. The file is the File Name specified in a VAGen record definition.

The resource association part can also specify how print output is to be implemented for a specific target environment.

When generating a program, the fileName for each indexed, serial, relative or print output is matched to the resource association part. The first entry that matches based on the fileName and generation target environment is the entry that is used for that file.

The EGL resource association part specifies how a file is to be implemented for a specific target environment. The file is the fileName property that is specified in an EGL record definition.

The resource association part can also specify how print output is to be implemented for a specific target environment.

When generating a program, the fileName for each indexed, serial, relative or print output is matched to the resource association part. The first entry that matches based on the fileName and generation target environment is the entry that is used for that file.

No special considerations.
For VisualAge Generator, resource association files are also used at runtime. For EGL, resource association information is stored in EGL parts. The migration tool includes support for converting additional options that were only valid in VAGen resource association files.
/system=targetSystem

targetSystem is one of the following:

  • AIX *
  • AIXCICS *
  • HP-UX *
  • IMSBMP
  • IMSVS
  • LINUX **
  • MVSBATCH
  • MVSCICS
  • NTCICS *
  • OS2 *
  • OS2CICS
  • OS400
  • SCO *
  • SOLACICS *
  • SOLARIS *
  • TSO
  • VMCMS
  • VMBATCH
  • VSEBATCH
  • VSECICS
  • WINNT **
Note:
  • * -- Indicates environments used for C++ generation.
  • ** -- Indicates environments used for Java generation.
  • /system is optional.
  • VisualAge Generator supports an * as a wildcard in the target system. (For example, MVS* or *CICS).

This is the EGL target environment.

The corresponding environment values are as follows:

  • aix
  • not supported
  • not supported
  • not supported
  • not supported
  • linux
  • zosbatch
  • zoscics
  • values will not be valid
  • not supported
  • not supported
  • iseriesc
  • not supported
  • not supported
  • not supported
  • not supported
  • not supported
  • not supported
  • not supported
  • not supported
  • win
Note:
Wildcards are not supported.

The migration tool processes the /system option as follows:

  • For a target system that is listed as not supported, the migration tool includes the information for the VAGen resource association entry as a comment in the EGL resource association part. This helps preserve as much of your information as possible.
  • If the /system option is omitted from the VAGen resource association entry, the migration tool uses any as the EGL resource association target environment.
  • If the /system option uses a wildcard, the migration tool migrates the option exactly as it is, including the wildcard (for example, mvs* or *cics). The migration tool also issues an error message.

filetype=fileType

fileType is one of the following:

  • BTRIEVE
  • GSAM
  • IBMCOBOL
  • MFCOBOL
  • MMSGQ
  • MQ
  • OS2COBOL
  • SEQ
  • SEQRS
  • SMSGQ
  • SPOOL
  • TEMPAUX
  • TEMPMAIN
  • TRANSIENT
  • VSAM
  • VSAMRS

The EGL file type, where the corresponding values are in the following list:

  • not supported
  • not supported
  • ibmcobol
  • not supported
  • not supported
  • mq
  • not supported
  • seq or seqws
  • seqrs
  • not supported
  • spool
  • tempaux
  • tempmain
  • transient
  • vsam
  • vsamrs

The migraton tool processes the /filetype option as follows:

  • If the /system option specifies a host target environment, the migration tool converts the VAGen SEQ file type to the EGL seq file type.
  • If the /system option is a workstaton environment, the migration tool converts the VAGen SEQ file type to the EGL seqws file type.
  • If the /system is MVSBATCH and the filetype is GSAM, the migration tool migrates the resource association entry as a comment.
  • For all other unsupported file type values, if the resource association is for a /system that is supported, the migration tool creates an EGL resource association entry using the VAGen file type and issues an error message. There will also be an error on the Tasks list. You must fix this error before you can use the EGL resource association part.

sysname=systemName systemName="systemName" The migration tool converts any symbolic parameters that are used within the /system option to the corresponding EGL replacement symbolic parameter.
/replace 
/noreplace
replace="YES" 
replace="NO"
No special considerations.
/dup
/nodup
duplicates="YES"
duplicates="NO"
Note:
This is for ISERIESC.
No special considerations.
/commit 
/nocommit

These options are only used for the OS/400 target environment.

commit="YES"
commit="NO"
Note:
This is for ISERIESC.
No special considerations.
/noff

There is no /FF option in VisualAge Generator. This option is only supported in VAGen resource association files.

FormFeedOnClose="NO"
FormFeedOnClose="YES" 
The migration tool converts /noff to FormFeedOnClose="NO".
/text

There is no /NOTEXT option in VisualAge Generator. This option is only supported in VAGen resource association files.

text="YES"
text="NO" 
The migration tool converts /text to text="YES".
/basename=xxxx

In VisualAge Generator, this option is only used for the OS/2 target environment. This option is only supported in VAGen resource association files.

Not supported. The migration tool comments out any entry for the OS/2 target environment.
/contable=xxxx

xxxx is one of the following:

  • a conversionTableName
  • EZECONVT

This option is only supported in VAGen resource association files.

conversionTable="xxxx"

xxxx is one of the following:

  • a conversionTableName
  • PROGRAMCONTROLLED
The migration tool uses the same conversionTableName when creating the EGL resource association entry.
/keys=xxxx

In VisualAge Generator, this option is only used with /filetype=BTRIEVE. This option is only supported in VAGen resource association files.

KEYS="xxxx"
Because BTRIEVE is used in supported target environments, the migration tool migrates the /keys option to an EGL keys option.
/blksize
/sysnum

These options are only used for VSE target environments.

Not supported. The migration tool comments out the resource association entry for target environments that are not supported.
/pcbno=n

This is only valid for IMSVS or IMSBMP target environments or for MVS Batch if the file type is GSAM.

Not supported. The migration tool comments out the resource association entry for target environments that are not supported or for MVS Batch if the file type is GSAM.


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