IBM SG24-6526-00 Laptop User Manual


 
142 Geac System21 commerce.connect: Implementation on the iSeries Server
6.1.3 Editing an iSeries stream file using a PC editor
If you exposed some or all of your iSeries IFS using a file share, then you can edit many
configuration, log, and source files with a PC editor. Remember that not all stream files
contain readable text. If you accidentally open one and it is not readable text, then be sure to
exit without saving. If you save the file, you may corrupt it even though you did not make any
deliberate changes.
You must use the editor with care. Ensure that it can read and write simple ASCII files. Word
processors may not be suitable or may only be suitable with care.
Notepad (in the Windows Accessories folder) is suitable for some files, but not all files. Some
iSeries files use the UNIX convention of a line feed between lines rather than the DOS
convention of using a carriage return and line feed. Notepad does not understand these files
and presents them in an incorrect way. An advantage of Notepad is that it can open a file that
is in use but cannot save that file while it is in use.
Wordpad (another Windows accessory) may also suitable for some files. Wordpad can save
in Word document format (be careful not to use this option). It copes with the UNIX style line
feeds that some iSeries files use. However, it cannot open files that are in use.
The best option may be to use a PC editor that is intended for programmer use. There are
may available. Whichever editor you use, you may find that some files that you expect to be
text are unreadable. Be careful to exit these files without saving. If the file contains many @
symbols, then it is possible that it is a text file, but in EBCDIC. For more information, see the
following section.
6.1.4 Stream files and CCSID
CCSIDs are labels for a file and some other objects. They indicate the code page of the data
within them. When database or stream files are labelled with an appropriate CCSID, OS/400
performs any necessary conversion when the file is read or written by OS/400 programs.
If a stream file is created on the PC, for example, by creating a new text file in Windows
Explorer, it is given an ASCII CCSID. Most OS/400 software can use this. That is, although
the software may expect EBCDIC, the operating system can convert the data as required.
If the file is created by Java on the iSeries server, it also gets an ASCII CCSID so you should
be able to read it on both the PC and the iSeries (if it is a text file). However, if the file is
created on the iSeries by something other than Java, it may get an EBCDIC CCSID. This is
usable by OS/400 software but not by PC software as mentioned in the previous section. You
are likely to see many @ characters because the EBCIDC code for space is the same as the
ASCII code for @. A situation in which this may occur is when a file is created using
redirection from a Qshell command.
You can create an ASCII file in the Qshell on the iSeries server by using the touch command.
This command can be useful in scripts. If the file is created with an ASCII CCSID, then data
written to it by following iSeries software should be translated. The result should be readable
from a PC.
It is possible to change the CCSID of a stream file after it is created without changing the data
already in the file.
If it is easy to recreate the file, then the easiest approach may be to delete the file, create it
again with an ASCII CCSID, and run the application again. You should now be able to view
the file from a PC. To create the file with an ASCII CCSID, either create it from a PC using a
mapped drive or by using the touch command.