Running the COBOL Unicode Conversion Utility for z/OS

This section discusses running the PeopleTools COBOL Unicode conversion utility for z/OS.

By default, the PeopleTools COBOL Unicode conversion utility for z/OS runs in the background of the server transfer process if you select the Unicode database option during installation.

You may want to run the utility manually in situations such as when converting PeopleSoft-delivered COBOL program patches or converting custom COBOL programs.

Use the following command syntax to run the COBOL Unicode conversion utility on the Microsoft Windows file server: 

PS_HOME\bin\client\winx86\pscblucvrtz.exe -s:Source_Directory -t:Destination_Directory -r:Log_Directory [-psfs]

The following table provides a description of the commands:

Command

Description

-s: Source_Directory

Specify the source directory where the non-Unicode version of COBOL resides. For the directory, you must specify where the COBOL subdirectories reside (\BASE, \MVS, and so on.), unless you specify –psfs flag to process all the PeopleSoft COBOL source subdirectories at once.

Example:-s:d:\PT8\SRC\CBL

Note: The utility processes COBOL source under Source_Directory\Unicode, but it does not modify the source found under the \Unicode subdirectory. The \Unicode subdirectory may be used to maintain the customization to the source already converted to Unicode.

-t: Target_Directory

Specify where you want to place the converted version of COBOL. The utility puts the modified source file in the same COBOL subdirectory in which it was found when you specified –psfs flag.

Example: -t:d:\PT8\SRC\CBLUNICODEZ

-r: or –rd: Log_Directory

-r generates only the summary log file; -rd generates all of the log files.

See Using Error, Exception and Summary Logging.

-psfs

Specify when you are processing conversion against PeopleSoft file server directory. If this flag is specified, the conversion utility processes both \BASE and \MVS subdirectories under the source directory.

The utility produces a new source file for each .CBL file that is found. These new files are placed under the specified target directory. If you specify the –psfs flag, the files are placed in \BASE and \MVS subdirectories under the target directory.

When you manually run the conversion utility you must transfer the generated .CBL files under the target directory to SRCLIB and COPYLIB data sets on the z/OS server, and compile the programs by submitting JCLs.

Note: The PeopleSoft COBOL conversion program for the Unicode environment on Unix and Microsoft Windows is named pscblucvrt. The COBOL conversion program for the z/OS environment is named pscblucvrtz. Do not use pscblucvrt for COBOL programs running on z/OS because the conversion logic used for z/OS COBOL programs is completely different from that used for Unix and Microsoft Windows.