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

Use the Guardian STOP command to stop processes. The STOP command uses either the process
name or the processor number and PIN combination to access the process. For example, the
following two commands are equivalent:
STOP $SRVR
STOP 5,48
OSS utilities enhanced to access a Guardian process would specify /G/srvr or /G/5,48 for the
previous commands. The OSS command line would look like one of the following:
kill -s GUARDIAN /G/SRVR
kill -s GUARDIAN /G/5,48
Managing Files From TACL
Within TACL, you use the FUP command to manipulate files. The following table shows some FUP
commands for a few common Guardian file operations:
OperationFUP Command
Displays all information about the file REPORT.FUP INFO REPORT, DETAIL
Copies the file REPORT to REPRTOLD.FUP DUP REPORT, REPRTOLD
Renames the file TESTFILE to TESTSAVE.FUP RENAME TESTFILE, TESTSAVE
Purges the file REPRTSAV.FUP PURGE REPRTSAV
Purges the complete subvolume OUTPUT on volume
$DATA01.
FUP PURGE $DATA01.OUTPUT.*
Changes file protection so that any user can read or execute
the file TESTPROG (only the owner can write or purge the
FUP SECURE TESTPROG, “AOAO”
file). The order of attributes is read, write, execute, and
purge.
Editing Files From TACL
ASCII text files in the OSS environment have the same format as these files have on a UNIX system:
a string of bytes with each line ending with a line-feed character (0X0A). Most ASCII text files in
the Guardian environment are in a special format, called “EDIT format” or “type 101.” Normally,
this file type is used for text input and text output. Refer to the PS Text Edit and PS Text Format
User’s Guide for information on editing TEDIT or EDIT format files in the Guardian environment.
If you are not familiar with the Guardian editor, TEDIT, and are more comfortable using OSS
(UNIX) editors, you might want to move the EDIT-format file from the Guardian environment to the
OSS environment, edit the file with the vi utility, and then move the file back to the Guardian
environment. The following are descriptions of how to make these conversions.
For detailed user information on using the vi utility in the OSS environment, refer to the Open
System Services User’s Guide, which contains tutorial and advanced user information about the
vi utility.
Moving Files From the Guardian Environment to the OSS Environment
You may access EDIT-format files directly from the /G file system with an OSS utility. Three options
for moving files to the OSS environment are provided:
• The following command copies and converts the EDIT file (type 101) called
$DATA01.REPORTS.JAN94 to the OSS file (type 180) /home/stu01/report in the correct
OSS format:
cp /G/DATA01/REPORTS/JAN94 /home/stu01/report
• It is possible to read EDIT files into your current OSS workspace for vi or ed. In the following
command sequence, ed creates the /home/stu01/report file. (This sequence is also
possible for vi.)
Guardian Commands for the UNIX User 63