SARFSS report collection mechanism and JES2 Work Selection criteria

Products

• OM View
• OM Deliver

Issue/Introduction

This article explains how the SARFSS task collects data from the JES2 output queue for archival into the OM View database and how to configure the associated JES2 Work Selection criteria.

Environment

OM View

OM Deliver

z/OS

Resolution

The SARFSS task does not "send" output to a printer; instead, it acts as a collector of input data from the JES2 output queue for archival into the OM View database. This collection is controlled by IBM Functional Subsystem (FSS) parameters defined in the JES2 initialization.

To configure the routing and collection criteria:

1. Define the PRINTER(####) parameters in JES2 to specify default values.
2. Use the WS (Work Selection) parameter to define criteria for archival. Available criteria include:
   • CLASS (WS=Q): Specifies the SYSOUT class.
   • PRMODE (WS=PRM): Specifies the processing mode (e.g., LINE, ACIF).
   • ROUTECDE (WS=R): Specifies the route code.
   • FORMS (WS=F): Specifies the form identifier.
   • WRITER (WS=W): Specifies the writer name.

Examples:

• Select by Processing Mode: WS=(PRM),PRMODE=LINE (Selects datasets with mode LINE).
• Select by Class: WS=(Q),CLASS=S (Selects datasets with SYSOUT class S).

Example of a FSS printer definition in JES2 parms:

FSS(SARFSS##) PROC=SARFSS##,AUTOSTOP=YES       
PRT## MODE=FSS,FSS=SARFSS##,                   
      CLASS=9,FORM=MSPS,                       
      START=YES,WS=(Q,F/W,PRM,W,R,LIM,UCS,FCB) 

where

• FSS(SARFSS##): Specifies the name of the FSS.
• PROC=SARFSS##: Defines the name of the JCL procedure (cataloged in a system procedure library) used to start the SARFSS task.
• PRT##: name used in JES commands ie: $P PRT##, $S PRT##
• MODE=FSS: Specifies that the printer is managed by a Functional Subsystem (SARFSS).
• CLASS=9: The JES output class the printer will select for processing.
• FORM=MSPS: The specific JES form name required for output selection.
• START=YES: Specifies that the printer should be started automatically when the FSS task starts.
• WS=(Q,F/W,PRM,W,R,LIM,UCS,FCB): Defines the Work Selection (WS) criteria. The collector uses criteria to the left of the slash (/) for selection.
  • Q (CLASS): Matches based on the CLASS parameter.
  • F (FORMS): Matches based on the FORMS/FORM parameter.
  • PRM (PRMODE): Matches based on the Print Mode.
  • W (WRITER): Matches based on the Writer name.
  • R (ROUTECDE): Matches based on the Destination/Route code.

Example of a FSS procedure definition in procedure library:

SARFSS##  PROC                                   
$$$$$$@  EXEC PGM=SARFSS,TIME=NOLIMIT,REGION=0M  
SARINDEX DD  DISP=SHR,DSN=<view database index>   
PRT##    DD DISP=SHR,DSN=SYSDEV.VIEW.INDEX(PRT##)
SARLOG   DD  SYSOUT=X                            
SYSUDUMP DD  SYSOUT=*                            
 PEND                                            
$$$$$$@  EXEC SARFSS##                           

where

• SARFSS##: procedure nae as defined in the JES2 FSS printer definition
• SARINDEX: primary OM View database index
• PRT##: parameter member in view.CVDEOPTN

 

 

 

Additional Information

Configure FSS Collector