AOP_MVS_RETURN_CODES environment variable

The AOP_MVS_RETURN_CODES environment variable determines whether the transform command returns MVS™ return codes (0, 4, 8) instead of UNIX exit values (0, 1). MVS return codes let you determine whether a warning or error occurred during the transform.

MVS return codes are useful when you use the AOPBATCH JCL procedure to run a transform and want a subsequent step in the job to run only if the transform step was successful.

AOP_MVS_RETURN_CODES

Specifies whether the afpxpcl, afpxpdf, and afpxps commands return MVS return codes or UNIX exit values:

Value

Meaning

YES

MVS return codes:

0

Successful.

4

A warning occurred during the transform.

8

The command was not accepted, a data stream error occurred during the transform, or the transform failed.

NO

UNIX exit values:

0

Successful. However, a warning or data stream error might have occurred during the transform.

1

The command was not accepted, or the transform failed.

Notes:

1. Specify this environment variable before the command on the z/OS® UNIX command line. You can also specify this variable in the $HOME/.profile file (if you use the /bin/sh shell) or the $HOME/.tcshrc file (if you use the /bin/tcsh shell).
2. If you use the AOPPRINT JCL procedure, specify this environment variable in the STDENV data set of the procedure. AOPPRINT runs the lp command and returns the code from the lp command.
3. If you use the AOPBATCH JCL procedure to run a transform command, specify this environment variable in the STDENV data set of the procedure. AOPBATCH returns the code from the transform command.
4. Do not specify this environment variable in the transform entry in the Infoprint Server transform configuration file, aopxfd.conf.
5. You can specify the value using lowercase or uppercase letters (for example, no or NO).

Default:

NO

Example:

AOP_MVS_RETURN_CODES=YES

Table 7 shows the transform exit values when the AOP_FAIL_ON_ERROR and AOP_MVS_RETURN_CODES environment variables are set and the transform is successful, a warning occurs, or a data stream error occurs. (The Fail on error field in the printer definition and the fail-on-transform-error job attribute provide equivalent function to the AOP_FAIL_ON_ERROR environment variable.)