CL Command Reference - CVTTCPCL
CL Command List > CVTTCPCL Reference
Description:
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 pre-V3R1M0 TCP/IP CL commands to be converted must exist in a source physical file.
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&apos.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.
Examples:
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.