Program Requirements

Programs that access MVSSPLPB must:

  • Include the mfpubspl copybook in Working-Storage (for COBOL programs), or the mfpubspl include member (for PL/I programs); see below for more information.
  • Set the interface function code to an appropriate value.
  • Populate the key field(s) and the index-id (for SPLJOB and SPLDSN).
  • Call the mvssplpb utility passing the mfpubspl level one data name.

mfpubspl.cpy (COBOL users)

The mfpubspl.cpy file is located by default in the cpylib sub-directory of your installation directory on Windows systems, or the $COBDIR/cpylib directory on UNIX systems. We recommend that you open it in a file editor to become familiar with its contents.

mfpubspl.cpy contains all of the Working-Storage fields you need to access the MVSSPLPB API from a COBOL program, including function, key, and reason code fields. Add mfpubspl.cpy to your Enterprise Developer project, and include it in your COBOL program to enable the passing of information to and from the MVSSPLPB API.

When you include mfpubspl.cpy in your program:

  • Include it in Working-Storage as a child of an 01-level field.
  • Use copy...replacing syntax to replace () with a qualifier. For example:
    01 PUBSPL-AREA.
       copy 'mfpubspl.cpy' replacing ==()== by ==WS-API==.

mfpubspl.inc (PL/I users)

The mfpubspl.inc file is located by default in the include sub-directory of your installation directory on Windows systems, or the $COBDIR/include directory on UNIX systems. We recommend that you open it in a file editor to become familiar with its contents.

mfpubspl.inc contains all of the fields you need to access the MVSSPLPB API from a PL/I program, including function, key, and reason code fields. It also contains the entry point declaration for the interface program. Add mfpubspl.inc to your Enterprise Developer project, and include it in your PL/I program to enable the passing of information to and from the MVSSPLPB API.