Troubleshooting

I cannot use the dls, dmv, mmv, mrm or dlsraw commands.

If commands dls, dmv, mmv, mrm or dlsraw fail but other commands work, ensure that mvscmdauth is installed correctly. Use the following steps:

1. Enter the command type -a mvscmdauth to determine where mvscmdauth is installed. In this example, mvscmdauth is installed in /usr/lpp/IBM/zoautil.

2. Enter the command ls -E /usr/lpp/IBM/zoautil. If mvscmdauth and mvscmdauthhelper are installed correctly, the first two columns read like -rwxr-xr-x a---. If the ‘a’ is not present, the command is not APF-authorized. To enable APF authorization, enter the command extattr +a /usr/lpp/IBM/zoautil/mvscmdauth*. Then re-enter the command ls -E /usr/lpp/IBM/zoautil. If the ‘a’ is still not present, you might not have permission to enable APF authorization. Consult your systems programmer for more information.

To learn more about authorization, see Installing and configuring ZOAU.

I see the following message:

FSUM7332 syntax error: got (, expecting Newline

This can happen if you do not set _BPXK_AUTOCVT. 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 single quotes. Examples:

ZOAUSER:/u/zoauser/zoau/1.2.0/bin #>mls sys1.proclib |grep -i /#DKSEPB1

ZOAUSER:/u/zoauser/zoau/1.2.0/bin #>mls sys1.proclib |grep -i '$DKSEPB1'

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. 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. Example:

opercmd -t "d iplinfo"