BPXO040I message explanation

BPXO040I hh.mm.ss DISPLAY OMVS

Explanation: The following material is part of the message text:

 BPXO040I message

     In response to a DISPLAY OMVS,ASID=, DISPLAY OMVS,U=, DISPLAY OMVS,VSERVER or DISPLAY OMVS,PID= operator command, this message displays information about the state of z/OS UNIX and its processes. The line beginning with user appears one or more times for each process. In response to a DISPLAY OMVS,PID=,BRL command, this message displays information about a possible Byte Range Lock situation, where a byte range of a file is locked by another thread for exclusive use only.

     In response to a DISPLAY OMVS,ASID=DUBW command, this message displays jobs waiting to become processes.

In the message text:

hh.mm.ss
The time in hours (00–23), minutes (00–59), and seconds (00–59) for the DISPLAY OMVS command.
procname
The name of the z/OS UNIX cataloged procedure.
kernelasid
The address space id of the Kernel.
status
One of the following:
ACTIVE
z/OS UNIX is currently active.
NOT STARTED
z/OS UNIX was not started.
INITIALIZING
z/OS UNIX is initializing.
TERMINATING
z/OS UNIX is terminating.
TERMINATED
z/OS UNIX has terminated.
ETC/INIT WAIT
z/OS UNIX is waiting for the /etc/init or /usr/sbin/init program to complete initialization.
FORK SHUTDOWN
FORK Service has been shutdown.
SHUTTING DOWN
z/OS UNIX is shutting down.
SHUTDOWN BLOCKED
z/OS UNIX shutdown processing is blocked by one or more jobs, and it waits for all of the blockers to unblock or terminate.
SHUTDOWN
z/OS UNIX is shut down.
RESTARTING
z/OS UNIX is restarting after a shut down.
parmmemberlist
The parmlib member name list specified on the SET OMVS command or on the initialization of OMVS.
user
The user ID of the process.
jobname
The job name of the process.
asid
The address space ID for the process or zero when states are Z or L.
pid
The process ID, in decimal, of the process; or “-” if no process id has been assigned yet.
ppid
The parent process ID, in decimal, of the process.
state r
A 6-character field showing the state of either the process or the most recently created thread in the process. This field includes a 5-character state field and a 1-character r field that contains the restart state.state is one or the combination of the following codes:
             Column is not being used.
1
             Single-thread process.
A
             Message queue receive wait.
B
             Message queue send wait.
C
             Communication system kernel wait.
D
             Semaphore operation wait; or, when there is no process id assigned yet, D means the job is waiting to become a process.
E
             Quiesce frozen.
F
             File system kernel wait.
G
             MVS Pause wait.
H
             Process state is for multiple threads and pthread_create was used to create one of the threads. Process state is obtained from the Initial Pthread created Task (IPT).
I
             Swapped out.
K
             Other kernel wait (for example, pause or sigsuspend).
L
             Ended and parent has performed wait. The process is the session or process group leader of a process that is still active, but will be removed from the process table after the last session or process group member terminates. (L is for latent zombies.)
M
             Process state is for multiple threads and pthread_create was not used to create any of the multiple threads. Process state is obtained from   the most recently created thread.
P
             Ptrace kernel wait.
Q
             Quiesce termination wait.
R
             Running (not kernel wait).
S
             Sleeping.
T
             Stopped.
W
             Waiting for child (wait or waitpid callable service).
X
             Creating new process (fork callable service is running).
Z
             Ended and parent has not performed wait. (Z is for zombies.)
r is the 1 character restart status:
             Column is not being used
B
             Blocked
P
             Permanent
shhmmss
The time, in hours, minutes, and seconds, when the process was started.
ct_secs
The total execution time for the process in seconds in the format ssssss.hhh. The value displayed is an approximate value, which may be less than a previously displayed value. When this value exceeds 11.5 days of execution time this field will overflow. When an overflow occurs the field is displayed as ******.***
latchwaitpid
Either zero or the latch process ID, in decimal, for which this process is waiting.
command
The command that created the process truncated to 40 characters. You can convert it to uppercase by using the CAPS option.
servername
The name of the server process. You can convert it to uppercase by using the CAPS option.
activefiles
The number of active server file tokens.
maxfiles
The maximum number of active server file tokens allowed.
servertype
One of the following:
FILE
A network file server
LOCK
A network lock server
FEXP
A network file exporter
SFDS
A shared file server
threadid
The thread ID, in hexadecimal, of the thread.
tcbaddr
The address of the TCB that represents the thread.
prijob
The job name from the current primary address space if different from the home address space, otherwise blank. This is only accurate if the thread is in a wait, otherwise it is from the last time that status ‘.’was saved. When the data is not available the field will be displayed as ********.
username
The username of the thread if a task level security environment created by pthread_security_np exists, otherwise blank. When the data is not available the field will be displayed as ********.
ac_secs
The accumulated TCB time in seconds in the format ssssss.hhh. When this value exceeds 11.5 days of execution time this field will overflow. When an overflow occurs the field is displayed as ******.***. When the data is not available the field will be displayed as **********.
sc
The current or last syscall request.
thdstate
The state of the thread as follows:
A
Message queue receive wait
B
Message queue send wait
C
Communication system kernel wait
D
Semaphore operation wait
E
Quiesce frozen
F
File system kernel wait
G
MVS Pause wait
J
The thread was pthread created rather than dubbed
K
Other kernel wait (for example, pause or sigsuspend)
N
The thread is medium weight
O
The thread is asynchronous and medium weight
P
Ptrace kernel wait
Q
Quiesce termination wait
R
Running (not kernel wait)
S
Sleeping
U
Initial process thread (heavy weight and synchronous)
V
Thread is detached
W
Waiting for child (wait or waitpid callable service)
X
Creating new process (fork callable service is running)
Y
Thread is in an MVS wait
tagdata
The tag data associated with the thread, if present. From 1 to 65 EBCDIC characters
devicenumber
The Device number for which the Byte Range Lock (BRL) Wait occurred.
inodenumber
The Inode number of the file owning the BRL.
filename
The name of the file. If the filename has more than 16 characters, the first 15 are displayed followed by a plus sign (+).
lockpidid
The PID of the process locking that file. This is usually the owner (or one of the owners) of a lock on the same range, but sometimes it is another process that is also waiting.
progresscounter
An increasing progress counter.
The blocking process is on system: sys
Displays the name of the system where the blocking process is when the command is issued in a sysplex configuration and the blocking process is from a different system in the sysplex than the system where the command was issued.
System action:

The system continues processing.

Operator response:

Resolve the Byte Range Lock situation in order to keep the waiting process running.

System programmer response:

None.

Source:

z/OS UNIX System Services kernel (BPX)

Detecting Module:

BPXOMAST

Routing Code:
Descriptor Code:
5,8,9