Troubleshooting ZOAU

Use the following troubleshooting tips to resolve issues with ZOAU. If you choose to contact IBM Support, prepare by collecting MustGather data. To learn more, see Collecting MustGather support information for ZOAU.

General tips

Use the ZOAU health checker to validate that ZOAU is installed correctly. Run zoaversion -c. Then review the output for errors that need to be corrected.

zoaversion -c


FSUM7332 error message

You might see the following message if the _BPXK_AUTOCVT environment variable is not properly set.

FSUM7332 syntax error: got (, expecting Newline


To fix this, enter the following command before running the utilities:

export _BPXK_AUTOCVT=ON


When using mls to display members, those that start with # display help documentation instead

When used in shell commands, the characters # and $ must be escaped with a backslash or surrounded in single quotes. Note the following examples.

In this first example, a backslash character precedes the # character in the grep statement:

mls sys1.proclib | grep -i \#DKSEPB1


In this next example, quotes surround the text string that includes a $ character:

mls sys1.proclib | grep -i '$DKSEPB1'


Tips for opercmd

The following tips can help you troubleshoot issues specific to opercmd.

When I run opercmd I get the message: "BGYSC0803I Insufficient allocated output buffer memory size. Please increase CONSBUFPGNUM."

By default, 128 buffer pages (1KB per page) are allocated for console command output. If output exceeds the default, or if utilities that leverage opercmd need greater size (such as apfadm for a large APF list), allocate more pages with the UNIX System Services environment variable CONSBUFPGNUM.

For example, to allocate 256 pages for console command output, enter the following command:

export CONSBUFPGNUM=256


opercmd is treating my console commands that start with "-" as options

To indicate the end of options, use "--" (two dash characters) after the opercmd options and before the actual console command. For example:

opercmd -d -- "-dbb1 dis ddf"


I'd like cleaner output for my console command via opercmd

Use the -t option to remove the indentation and two lines of information that are included for compatibility with the previous opercmd implementation. For example:

opercmd -t "d iplinfo"


Tips for the Python API

Python's default logging module can help you debug your scripts because it produces verbose output from the ZOAU Python library. To enable Python logging, add the following lines of code to your scripts:

import logging
logging.basicConfig(level=logging.DEBUG)