bpxmtext - Display reason code text
Format
bpxmtext [-d] reason_code | error_number
Description
bpxmtext displays the description and action text for a reason code returned from zFS, TFS, TCP/IP, and the XL C/C++ runtime library. It also returns information about error numbers. It can be run from the z/OS® UNIX shell and the TSO environment. You can also enter that command through System REXX as an operator command.
Reason codes such as those returned by HFS or NFS are not supported by this command
This command is intended as an aid for problem determination. When an error_number is specified, the description for that error number is displayed.
reason_code is specified as 7-8 hexadecimal characters.
error_number is specified as 1-4 hexadecimal characters.
Options
- -d
- reason_code or error_number is provided as a decimal number.
Usage notes
- If no text is available for the reason code, a blank line is displayed.
- An argument that is not 1-8 hexadecimal digits in length results in a usage message. The message is not translated.
Examples
- The command:
produces data displayed in the following format:bpxmtext 058800B0
BPXFSUMT 08/18/98 JRUserNotPrivileged: The requester of the service is not privileged Action: The service requested required a privileged user. Check the documentation for the service to understand what privilege is required.
- To find information for reason code 058800B0, issue:
F AXR,BPXMTEXT 058800B0
Exit values
0
- Successful completion.
2
- Failure due to an argument that is not 1-8 hexadecimal digits.