CVTTCPCL (Convert TCP/IP CL Source) Command

Purpose

The Convert TCP/IP CL Source (CVTTCPCL) command is used to convert TCP/IP commands from releases prior to Version 3, Release 1, Modification 0 (V3R1M0) to the command syntax for the current release. The TCP/IP CL commands to be converted must exist in a source physical file.

The following commands are converted based on their specified parameter values. In some cases you may need to manually update the commands after conversion. Messages are issued to help identify the command statements that require manual updates.

ADDTCPLNK

CHGTCPLNK

RMVTCPLNK

STRTCPLNK

ENDTCPLNK

ADDTCPRTE

CHGTCPRTE

RMVTCPRTE

ADDTCPPORT

RMVTCPPORT

ADDTCPRSI

RMVTCPRSI

CHGTCPA

ENDTCPCNN

STRTCPTELN

CHGVT1MAP

SETVT1MAP

DSPVT1MAP

ENDSBS SBS(QTCP)

STRSBS SBSD(QTCP/QTCP)

The CVTTCPCL command creates a printer file with the name CVTTCPCL. This printer file contains a report that indicates the success or failure of the source file conversion.

If a printer device file with the name CVTTCPCL is found in the job's library list when the CVTTCPCL command is issued, that printer device file is used to create the printer file. Otherwise, the CVTTCPCL command uses the Override with Printer File (OVRPRTF) command to use printer device file QSYS/QSYSPRT to create the printer file.

Note: Use the Create Printer File (CRTPRTF) command to create a printer device file.

Successful conversions of TCP/IP command source are noted in the report with the message:

TCP1E08 Member has been converted.

Informational messages are printed for unsuccessful command conversions. (Informational messages are also sent to the job log during conversion, and a single escape message is sent when the CVTTCPCL command has completed if any informational messages have been sent.) Some examples of functions that cannot be converted and may be printed as informational messages in the report are:

TCP1E07 Command &1; cannot be converted TCP1E10 Parameter keyword cannot be converted in command &1;

The user can write a program, perhaps by using the Copy Spooled File (CPYSPLF) command, to process the report based on the success or failure of the conversion.

Required Parameters

FROMFILE Specifies the qualified name of the AS/400 system CL source file containing TCP/IP commands to convert.

The name of the file can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

from-file: Specify the name of the AS/400 CL source file to convert.

TOFILE Specifies the qualified name of the file in which the converted source is placed. It must be different than the name of the FROMFILE parameter.

The name of the file can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

to-file: Specify the name in which the converted source file is placed.

FROMMBR Specifies the member name of the source file member to convert.

*ALL: All members of the specified source file are converted to V3R1M0 TCP/IP command syntax if possible.

generic*-member-name: Specify the generic name of the source file members to convert. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic name specifies all objects with names that begin with the generic prefix for which the user has authority. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete object name. If the complete object name is specified and multiple libraries are searched, multiple objects can be converted only if *ALL or *ALLUSR library values can be specified for the name. Only the first 50 members matching the generic name's criteria will be converted.

member-names: Specify the names of the source file members to convert. Specify no more than 50 names.

Note that the only source members that are processed are those with a member type of CL, CLP, or TXT. Members in the FROMFILE with any other value for the member type are ignored by the CVTTCPCL command. If a source member is processed, the name of the converted source member in the TOFILE will be the same as the member name in the FROMFILE.

Example

CVTTCPCL FROMFILE(OLDLIB/QCLSRC) TOFILE(NEWLIB/QCLSRC) FROMMBR(TCPPGM1 TCPPGM2 TCPPGM3)

This command converts all TCP/IP commands in the three members (TCPPGM1, TCPPGM2, TCPPGM3) of a CL source file (QCLSRC) located in library OLDLIB, to their new command names and formats. The converted source file members are located in QCLSRC, in library NEWLIB. The converted members keep their original member names, TCPPGM1, TCPPGM2, and TCPPGM3.