Return codes

Return code guidelines for ZOAU 1.2.x

ZOAU v1.2.0 introduces some updated return codes, which are listed in the following tables. Only updated codes are indicated. All other return codes remain unchanged.

General return code guidelines

ZOAU returns program-specific or default UNIX return codes. Guidelines:

  • 2 is returned for syntax printout.

  • 4 is returned for syntax error / invalid arg format.

  • 8 is returned if no equivalent UNIX program exists for comparison.

  • If an equivalent UNIX return code does exist that is not a syntax printout or syntax error, ZOAU returns the default UNIX return code. For example, if the default return code is 4, ZOAU will return 4.

  • mvscmd will return whatever the MVS program returns.


Updated return codes

apfadm Old New
opercmd failure 16 8
dataset not found 16 8
dataset not found on the vol 16 8
vol not sms 16 8
dataset multi entry found 16 8
add/del to APF list error 16 8
add/del persistent entry error 16 8
syntax printout 4 2
dcp Old New
dlsraw command failure dlsraw RC 1
dataset member with wildcards 16 4
too few args 16 4
syntax printout 4 2
ddiff Old New
dlsraw command failure dlsraw RC 2
mls command failure mls RC 2
dataset and/or member does not exist 16 2
multiple datasets and/or members 16 2
too few arg 16 4
syntax printout 4 2
decho Old New
invalid arg 8 4
syntax printout 4 2
dgrep Old New
dlsraw command failure dlsraw RC 2
mls command failure mls RC 2
mvscmd isrsupc failure isrsupc RC 2
multiple datasets and/or members 16 2
too few args 16 4
syntax printout 4 2
dls Old New
too few args 16 4
syntax printout 4 2
dmod Old New
icov failure icov RC 1
unable to open/read/write 8 1
failed to lock/unlock dataset 8 1
unable to get dataset metadata 8 1
invalid input length 8 4
wrong regex pattern 8 4
invalid marker format 8 4
invalid marker length 8 4
invalid  number of args 16 4
invalid arg 8 4
dmv Old New
dlsraw command failure dlsraw RC 1
mvscmdauth idcams failure idcams RC 1
multiple datasets match 16 1
dataset exists 16 1
dataset does not exist 16 1
cannot move to member 16 1
cannot move from member 16 4
too few args 16 4
syntax printout 4 2
drm Old New
dlsraw command failure dlsraw RC 1
drmraw failure drmraw RC 1
does not support member deletion 16 4
too few args 16 4
syntax printout 4 2
dsed Old New
icov failure icov RC 1
unable to open/read/write 8 1
failed to lock/unlock dataset 8 1
unable to get dataset metadata 8 1
invalid input length 8 4
wrong regex pattern 8 4
invalid  number of args 16 4
invalid arg 8 4
dtail Old New
unable to seek 2 1
unable to open 2 1
record specified out of range 2 1
invalid number of args 2 4
invalid arg 2 4
dunzip Old New
restore failure 15 8
unpack failure 15 8
temp dataset allocation failure 15 8
no volume specified 15 4
invalid volume name 15 4
invalid dataset name 15 4
invalid size 15 4
syntax printout 4 2
dzip Old New
mvscmdauth dump failure dump RC 8
mvscmdauth pack failure pack RC 8
copy failure 15 8
temp dataset allocation failure 15 8
file create failure 15 8
file exists 15 8
too many volumes 15 4
invalid volume name 15 4
invalid dataset name 15 4
invalid size 15 4
syntax printout 4 2
hlq Old New
too many args 16 4
syntax printout 4 2
llwhence Old New
incorrect number of args 16 4
syntax printout 4 2
mls Old New
too few args 16 4
syntax printout 4 2
mmv Old New
dlsraw failure dlsraw RC 1
mvscmdauth iehprogm move failed iehprogm RC 1
dataset does not exist 16 1
multiple datasets 16 1
empty dataset pattern 1 4
incorrect number of args 16 4
syntax printout 4 2
mrm Old New
dls failure dls RC 1
mvscmdauth idcams member delete failed idcams RC 1
multiple datasets match pattern 16 1
incorrect number of args 16 4
syntax printout 4 2
parmgrep Old New
dgrep failure 8 1
too many args 16 4
syntax printout 4 2
parmwhence Old New
incorrect number of args 16 4
syntax printout 4 2
pll Old New
syntax printout 4 2
pparm Old New
syntax printout 4 2
pproc Old New
syntax printout 4 2
procgrep Old New
too many args 16 4
syntax printout 4 2
procwhence Old New
dwhence failure dwhence RC 1
incorrect number of args 16 4
syntax printout 4 2
zoaversion Old New
too many args 16 4
syntax printout 4 2