ipcs — Report status of the interprocess communication facility

Description

ipcs writes to the standard output information for active interprocess communication facilities. If you do not specify any flags, ipcs writes information in a short form about currently active message queues, shared memory segments, and semaphores.

The column headings and the meaning of the columns in an ipcs command listing are listed in Table 1. . The letters in parentheses indicate the command flags that cause the corresponding heading to appear. (all) means that the heading is always displayed. These flags determine what information is provided for each facility. They do not determine which facilities are listed.

Options

–q

Writes information about active message queues.

–m

Writes information about active shared memory segments.

–s

Writes information about active semaphore set.

–S

Write information about active __map memory segments.

If –q, –m, –s, or –S are specified, only information about those facilities is written. If none of these four are specified, information about message queues, shared memory segments and semaphores are written subject to the following options. __Map memory information will not written unless the –S is specified.

–a

Uses the –b, –c, –o, –p, and –t flags.

–b

Writes the maximum number of bytes in messages on queue for message queues, the size of segments for shared memory, and the number of semaphores in each semaphores set. This option will be ignored for __map memory option [–S].

–c

Writes the login name and group name of the user that made the facility. This option will be ignored for __map memory option [–S].

–m

Writes information about active shared memory segments.

–o

Writes the following usage information:

• Number of messages on queue
• Total number of bytes in messages in queue for message queues
• Number of processes attached to shared memory segments

–p

Writes the following:

• Process number of the last process to receive a message on message queues
• Process number of the creating process
• Process number of last process to attach or detach on shared memory segments

–q

Writes information about active message queues.

–s

Writes information about active semaphore set.

–t

• Time of the last control operation that changed the access permissions for all facilities
• Time of the last msgsnd() and msgrcv() on message queues
• Time of the last shmat and shmdt on shared memory
• Time of the last semop on semaphore sets

–w

Writes message queue wait status and semaphore adjustment status in these fields:

Fields
AJNUM	KEY	RCVPID	T
AJPID	MSGQPID	RCVTYP	WTRNM
AJVAL	MSGQTYP	SNDLEN	WTROP
GROUP	OWNER	SNDPID	WTRPID

This option ignores all other print options except –x and –y.

–x

Writes extended status in these fields:

Fields
ATADDR	KEY	SEGSZ	T
ATPID	OWNER	SEGSZPG	TERMA
CNADJ	PGSZ	SNCNT
GROUP	QCBYTES	SNDWAIT
INFO	RCVWAIT	SZCNT

This option will be ignored for __map memory option [–S]. This option ignores all other print options except the –y option.

–y

Writes summary and system limit status in these fields:

Fields
CIDSA	ENOMEM	MAXSEG	SPAGES
CKEY	GETEX	MNIDS	TPAGES
CPAGES	HWIDS	MNOPS
CPRIV	QMNUM	MNSEMS
CSBYTES	MAXQB	SEGPR

This option ignores all other print options. This option is a summary and system limit status for message queues, semaphores and shared memory. It will not include the __map memory segments [–S] summary and system limit status.

–M

Writes the multilevel security label associated with the resources except the __map memory facility. See z/OS Planning for Multilevel Security and the Common Criteria for more information about multilevel security.

–B

Writes extended information about __map memory segments in these fields: BLKSIZE, BLKSINUSE, BLKSINMAP, and BLKSMAPPED. This option only applies to __map memory segments [–S].

Exit values

0

Successful completion

1

Failure due to incorrect command-line option

Related information

ipcrm