gtpo1m64Operations

ZFILE ps-Display Process Information

Use this command to display information about current processes, or entry control blocks (ECBs), in the system that were created by a tpf_fork function call.

Requirements and Restrictions

Format




-f
displays information about the ECBs using the full-listing format. The full-listing format includes the PID, PPID, PROG, STIME, TIME, and USER column headers. See Table 10 for a description and summary of fields the ZFILE ps command supports.

-l
displays information about the ECBs using the long-listing format. The long-listing format includes the ADDR, PID, PPID, PROG, TIME, USER, and VSZ column headers. See Table 10 for a description and summary of fields the ZFILE ps command supports.

-G realgrouplist
displays information for specified ECBs, where realgrouplist is the list of real group identifiers (GIDs) for the ECBs you want information about. If more than one GID is specified, they are separated with commas and the ZFILE ps command will connect them using a logical OR statement.

-o
customizes the display based on what information you want to know about the ECBs.

field
is the name of the field to display, where field is any of the field names supported by the ZFILE ps command. See Table 10 for a list of these names and a description of the information that field name will display. The table also includes information about default column headers and alias names of the display.

field=
indicates that there will be no column header for the field name specified in the field parameter. If all of the field names are specified with an equal sign (=), the column header line is omitted completely. See Table 10 for default column header information.

field=heading
indicates that for the field name specified in field, the column header will be what is specified in heading rather than the default. See Table 10 for default column header information.

-p proclist
displays information for specified ECBs, where proclist is the list of process identifier (process ID) numbers for the ECBs you want information about. If more than one process ID is specified, they are separated with commas and the ZFILE ps command will connect them using a logical OR statement.

-P programlist
displays information for specified ECBs, where programlist is the list of 1- to 4-character program names for the ECBs you want information about. For example, ZFILE ps -P cfj will find all ECBs that have a program name that begins with cfj. This parameter is TPF-specific. If more than one program name is specified, they are separated with commas and the ZFILE ps command will connect them using a logical OR statement.

-t termlist
displays information for specified ECBs, where termlist is the list of 3-byte hexadecimal terminal addresses for the ECBs you want information about. If more than one terminal address is specified, they are separated with commas and the ZFILE ps command will connect them using a logical OR statement.

-u effectiveuserlist
displays information for specified ECBs, where effectiveuserlist is the list of effective user identifiers (UIDs) for the ECBs you want information about. If more than one UID is specified, they are separated with commas and the ZFILE ps command will connect them using a logical OR statement.

-U realuserlist
displays information for specified ECBs, where realuserlist is the list of real user identifiers (UIDs) for the ECBs you want information about. If more than one UID is specified, they are separated with commas and the ZFILE ps command will connect them using a logical OR statement.

-L
displays a list of valid field names for the -o field parameter. Each field name is shown on a separate line and is followed by valid alias names in parentheses (()). You can also refer to Table 10 for the list of field names and their alias names.

Additional Information

Examples

The following example shows the default display format.

+--------------------------------------------------------------------------------+
|User:   zfile ps                                                                |
|                                                                                |
|System: FILE0001I 19.03.30 START OF DISPLAY FROM ps                             |
|               PID PROG  ELAPSED     TIME                                       |
|        1077215431 CFJP 00:00:00 00:00:00                                       |
|        1077215446 CFIM 00:00:04 00:00:00                                       |
|        1077215480 CFIX 00:00:01 00:00:00                                       |
|        1076691213 CLTX 00:23:17 00:00:03                                       |
|        1076625897 CLTW 00:23:58 00:00:02                                       |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

The following example shows the long-listing display format.

+--------------------------------------------------------------------------------+
|User:   zfile ps -l                                                             |
|                                                                                |
|System: FILE0001I 19.04.00 START OF DISPLAY FROM ps -l                          |
|        USER            PID       PPID PROG ADDR     VSZ     TIME               |
|        nobody   1076691213 1076625897 CLTX 02397000 220 00:00:03               |
|        root     1077215524 1077215531 CFJP 023DC000 208 00:00:00               |
|        root     1077215531 1077215559 CFIX 023F1000 248 00:00:00               |
|        root     1077215559          1 CFIM 02445000 248 00:00:00               |
|        tpfdfltu 1076625897          1 CLTW 0262B000  68 00:00:02               |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

In the following example, multiple ECB selection criteria are used. ECBs with program name cfix or cfim are displayed. In addition, ECBs with an effective UID of nobody or tpfdfltu are displayed.

+---------------------------------------------------------------------------------------------+
|User:   zfile ps -l -P cfix,cfim -u nobody -u tpfdfltu                                       |
|System: FILE0001I 16.26.39 START OF DISPLAY FROM ps -l -P cfix,cfim -u nobody -u tpf...      |
|        USER            PID       PPID PROG ADDR     VSZ     TIME                            |
|        nobody   1078067228 1078002121 CLTX 014F4000 220 00:00:00                            |
|        root     1078133090          1 CFIM 018C6000 240 00:00:00                            |
|        tpfdfltu 1078002121          1 CLTW 019FB000  68 00:00:00                            |
|        root     1078133203 1078133090 CFIX 01A19000 244 00:00:00                            |
|        END OF DISPLAY                                                                       |
+---------------------------------------------------------------------------------------------+

The following example shows a customized display. The requested output fields are pgm (an alias for prog), vsz (with a custom column heading of MEMORY), and pid. Only ECBs with a program name starting with cfi or a process ID of 1076625897 are displayed.

+---------------------------------------------------------------------------------------------+
|User:   zfile ps -o pgm,vsz=MEMORY,pid -P cfi -p 1076625897                                  |
|                                                                                             |
|System: FILE0001I 19.06.10 START OF DISPLAY FROM ps -o prog,vsz=MEMORY,pid -P cfi -p...      |
|        PROG MEMORY        PID                                                               |
|        CFIX    256 1077280991                                                               |
|        CFIM    260 1077281006                                                               |
|        CLTW     68 1076625897                                                               |
|        END OF DISPLAY                                                                       |
+---------------------------------------------------------------------------------------------+

The following example shows how the -L parameter works.

+--------------------------------------------------------------------------------+
|User:   zfile ps -L                                                             |
|                                                                                |
|System: FILE0001I 13.29.00 START OF DISPLAY FROM ps -L                          |
|        addr (sva)                                                              |
|        etime (elapsed)                                                         |
|        group (gname)                                                           |
|        pgid                                                                    |
|        pid                                                                     |
|        ppid                                                                    |
|        prog (pgm)                                                              |
|        rgroup                                                                  |
|        ruser (runame)                                                          |
|        stime (start, started)                                                  |
|        time (cputime)                                                          |
|        tty (lniata, longtname, tname, tt)                                      |
|        user (uname)                                                            |
|        vsz (memory, vsize)                                                     |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

Related Information