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

ADD * FROM TEST2O
SELECT SEARCH $SYSTEM.SYSTEM.CWIDE
SELECT RUNNABLE OBJECT ON
SELECT LIST * OFF
SET HEAP 20 PAGES
BUILD TESTER
Refer to the C/C++ Programmer’s Guide for detailed information on compiling and binding
programs in the OSS environment.
Guardian Commands for the UNIX User
This subsection is intended for UNIX users who may occasionally directly use Guardian commands
to manipulate Guardian objects. It contains information about working with processes and files
using Guardian commands from within a Guardian environment. Appendix B (page 201) contains
a table of many common OSS shell commands and their functionally equivalent Guardian
commands.
Managing Processes From TACL
Within a Guardian environment, you can use the Guardian STATUS command to obtain the status
of Guardian processes. This is equivalent to the OSS ps utility.
Examples
To list the status of your current Guardian processes, use the following command at the TACL
prompt:
STATUS *, USER
The next example lists the status of all Guardian processes:
STATUS *
The following sample command lists all status information of all processes belonging to the user
named OSS.STU01. Note that parameters are separated by commas (,). The second parameter
is a keyword value pair (USER and OSS.STU01) separated by a space. The DETAIL option specifies
that the full set of status information is to be displayed:
STATUS *, USER OSS.STU01, DETAIL
The following sample command lists status information of processes running in processor 0. Both
Guardian and OSS processes are displayed in the output:
STATUS 0
In this sample output, the OSS processes have an “x” in the second column and program names
whose subvolume names begin with ZYQ (the output is only a small portion of the output for this
command):
Process Pri PFR %WT Userid Program file Hometerm
$XM00 0,278 199 P 041 255,255 $SYSTEM.SYS00.MEASCTL $TA0.#T2
$IMON B 0,279 148 P 001 255,255 $SYSTEM.SYS00.IMON $OSP
$XCVR0 0,280 199 P 001 255,255 $SYSTEM.SYS00.COVERMON $TA0.#T2
X 0,281 150 000 1,174 $XPG.ZYQ00000.Z0000R24 $ZTNT.#PTY007
X 0,282 150 003 1,33 $XPG.ZYQ00000.Z0000R24 $ZTNT.#PTY003
X 0,284 150 000 255,255 $XPG.ZYQ00000.Z0000R24 $ZTNT.#PTY000
In the Guardian environment, you specify a process in Guardian commands either by name or by
the processor and process identification number (PIN). The processor number and PIN are separated
by a comma (,); see the next example.
Guardian process names begin with a dollar sign ($) followed by a letter. The process name can
have up to five characters (excluding the $). The Guardian process names in the previous sample
output are $XM00, $IMON, and $XCVR0.
62 Interoperating Between User Environments