Defining SAPI Selection Criteria

You can select data from the JES spool bases on a combination of four NODE parameters.

The platform server does not process held output. In addition, the platform server requests that JES processes the data in priority order, although that priority is up to the individual JES system.

The four NODE parameters are as follows:

  • SAPI_CLASS: JES SYSOUT classes. You can define up to eight JES SYSOUT classes.
  • SAPI_DEST: JES destination.
  • SAPI_FORM: JES form name.
  • SAPI_WRITER: JES writer name.

These parameters are specified on individual NODE definitions. Each NODE definition that you define must have different selection criteria. Multiple selection parameters can be defined for a single NODE definition. The platform server only extracts data that meets all of the selection criteria.

Note: You cannot specify SAPI_CLASS as the sole selection criteria because all data for that class will be retrieved by the platform server.

It is good practice to use SAPI_WRITER as selection criteria. The writer name can contain 1 - 8 characters. Most importantly, the writer name does not have to be predefined to the JES2 or JES3 systems. To send a data set to a JES writer, you can specify the following parameter in the JCL that writes the output: SYSOUT=(A,writer_name). Wherein, the parameter defined as A is a SYSOUT class. Any valid SYSOUT class can be defined.

Note: If the SAPI_CLASS parameter is defined, its class must match one of the classes defined.