Efectos jurídicos en los hijos

Convert Report Source (CVTRPTSRC)

Type choices, press Enter.

From source file . . . Name

Library . . . *LIBL Name, *LIBL, *CURLIB To source file . . . Name

Library . . . *LIBL Name, *LIBL, *CURLIB From source member . . . Name

*PRTF or RPG printer file . . . *MBRTYPE Name, *MBRTYPE, *PRTF... To source member . . . *FROMMBR Name, *FROMMBR

*PRTF or RPG printer file . . . *PRTF Name, *PRTF, *PRTF38 Bottom F3=Exit F4=Prompt F5=Refresh F12=Cancel F13=How to use this display F24=More keys

Figure: RDA Source Conversion Log

What's In This Chapter

This chapter explains how Report Designer's Convert Report Source (CVTRPTSRC) command works, discusses the

limitations of conversion, gives a detailed explanation of the commands parameters, and contains a sample source

conversion log.

Conversion Explanation

Report Designer contains high level language parsers to convert RPG or DDS source code into Report Designer's

internal representation of report definitions. Additionally, Report Designer contains high level language source code

generators that convert Report Designer's internal representation of report definitions into RPG or DDS. The

Convert Report Source (CVTRPTSRC) command reads in a source member using one of the parsers and outputs a

new member with one of the source code generators. CVTRPTSRC command provides the following functions:



Generate DDS source code for an equivalent externally described printer file from RPG

specifications for an internally described printer file.



Generate RPG source code for an equivalent internally described printer file from DDS source code

for an externally described printer file.



Standardize RPG coding style of printer file O specs by reading in existing RPG and writing out

RPG in the Report Designer style.



Standardize DDS coding style by reading in existing DDS and writing out DDS in the Report

Designer style.

Since printer function provided by RPG is a subset of that provided by DDS, DDS to RPG conversions may lose

some printer function. As an example, since there is no RPG equivalent of the DDS COLOR keyword, COLOR is

dropped on conversion to RPG. Additional differences will occur.

Limitations

Because Report Designer was not designed as a conversion aide, the Convert Report Source (CVTRPTSRC)

command has several limitations:



RPG fields defined by externally defined data structures have incorrect REFFLD keyword values

when converted to DDS. These must be corrected by hand using SEU.



The conversion process does not change the input source member when converting between source

types. Removing output specifications, changing EXCPT opcodes to WRITE, etc must be

performed by hand when converting from RPG to DDS.

Convert Report Source

To prompt the Convert Report Source (CVTRPTSRC) command:

1.

Key in CVTRPTSRC on a command line.

2.

Press F4.

After completing the display, press Enter to convert the report source.

The Convert Report Source (CVTRPTSRC) command converts a report definition contained in a source member

from one source type to another.

From source file (FROMFILE)

Specifies the name of the file containing the source to be converted and the library where it resides.

This is a required parameter.

The possible library values are:

*LIBL

All libraries in the thread's library list are searched.

*CURLIB

Use the current library for the job. If no library is specified as the current library for the job, QGPL is used.

library-name

Specify the name of the library.

To source file (TOFILE)

Specifies the name of the existing file to receive the converted source and the library where it resides.

This is a required parameter.

The possible library values are:

*LIBL

All libraries in the thread's library list are searched.

*CURLIB

Use the current library for the job. If no library is specified as the current library for the job, QGPL is used.

library-name

Specify the name of the library.

From source member (FROMMBR)

Specifies the name of the member containing the source to be converted.

This is a required parameter.

*PRTF or RPG printer file (FROMPRTF)

Specifies whether the source member is treated as DDS or RPG source. In the case of RPG source, specifies the

name of the printer file to process as it appears in the F-spec.

The possible values are:

*MBRTYPE

Infer the printer name from the member's source type. Members with source type PRTF are treated as if *PRTF

were specified. Members with source type PRTF38 are treated as if *PRTF38 were specified. Members with

source type RPG, RPT, RPG36 etc. are treated as if *FIRST were specified.

*PRTF38

The source is treated as System/38 compatible DDS.

*FIRST

The source is treated as RPG and the first printer file name encountered in the source is processed.