Open System Services Porting Guide (G06.29+, H06.06+, J06.03+)

Managing Files From OSS
In the OSS environment, several utilities provide file operations. In the Guardian environment, the
File Utility Program (FUP) is used to provide this function. The following table shows some common
file operations, the OSS shell utility for those operations, and examples of the same operations
using a FUP command:
FUP CommandOSS Shell UtilityOperation
FUP DUP REPORT, REPRTSAVcp report reprtsavCopies a file.
FUP FILESlsDisplays filenames.
FUP INFO OLDFILEls -l oldfileDisplays file attributes.
FUP PURGE OLDFILErm oldfileDeletes file.
FUP RENAME OLDNAME, NEWNAMEmv oldname newnameRenames file.
FUP SECURE TESTFILE, “OOOO”chmod u=rwx testfileChanges protection.
Editing Files From OSS
OSS has two primary editors: vi and ed utilities. vi is a screen-oriented editor; ed is a line-mode
editor. These editors are roughly equivalent to Guardian TEDIT and EDIT in line mode. The Open
System Services User’s Guide describes these OSS editors in detail. Whenever possible, use the
OSS (UNIX) editors for OSS files and the Guardian editors for Guardian files.
Most OSS utilities can access Guardian type 101 files (EDIT files). These files can be read from
OSS and can also be written from OSS by using OSSTTY. You can use the OSS editors to read
and write Guardian type 180 files. If you want to edit a type 101 file using an OSS editor, you
must first convert the file to type 180 with the Guardian utility EDITTOC. If necessary, later convert
it back to type 101 with the Guardian utility CTOEDIT to use a Guardian editor. See “Editing Files
From TACL ” (page 63) for more information on using EDITTOC and CTOEDIT.
Printing Files From OSS
You can use the OSS lp utility to print files, the lpstat utility to display the status of print jobs,
and the cancel utility to remove print jobs from the print queue. The function of lp is equivalent
to using FUP COPY to a spool location. lpstat is equivalent to PERUSE. lpstat and cancel
are equivalent to SPOOLCOM.
Examples
The following example prints the file testprog.c. The -d parameter specifies the spool destination
laser for the output:
lp -d laser testprog.c
Use the following command to list the status of all spool jobs in the print queue:
lpstat
In the following example, the -o parameter limits the output to those spool jobs queued to a specific
printer location (in this case, $S.#LASER):
lpstat -o laser
These examples specify the spool destination using an alias; this is true for both lp and lpstat
utilities. The definitions of the spool location abbreviations are specified in the /etc/printcap
file. Your system administrator is responsible for setting up and maintaining this file. If the
/etc/printcap file contains the alias of laser for the spool location $S.#LASER, then the output
goes to the printer called #LASER, controlled by the Guardian process named $S.
60 Interoperating Between User Environments