Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

There are three UAG configuration options for SYSOUT processing:

  • JES_SYSOUT_CLASS specifies the JES held class dedicated to UAG SYSOUT processing.
  • JES_SYSOUT_DISP specifies the disposition of the SYSOUT data sets once UAG has completed SYSOUT processing.
  • JES_SYSOUT_RETENTION specifies the number of hours that job SYSOUT files are retained in the UAG cache directory.

...

The first step is to select a JES held class to dedicate to UAG. The class cannot be shared with any other SYSOUT application. Specify the class with the UAG JES_SYSOUT_CLASS configuration option. By specifying a JES_SYSOUT_CLASS value, UAG will modify the JOB statement of the jobs it submits to JES. The JOB statement MSGCLASS parameter is changed to the JES_SYSOUT_CLASS value. If no MSGCLASS parameter is present on the JOB statement, it will be added. The JOB statement MSGCLASS parameter specifies the JES class where the job's JES system data sets are spooled.

Once UAG has completed processing the SYSOUT data sets, it performs final disposition on them as specified by the UAG JES_SYSOUT_DISP configuration option. The SYSOUT data sets must be moved to the JES class or classes used by the next SYSOUT application to process them.

...

  • If the original JOB statement MSGCLASS value correctly specified the class, then a JES_SYSOUT_DISP value of KEEP,* will keep the SYSOUT data sets and move them to the original MSGCLASS class. This configuration requires no JCL changes nor changes to the other SYSOUT application.
  • The class can be specified directly. For example, a JES_SYSOUT_DISP value of KEEP,H will keep the SYSOUT data sets and move them to held class H.

...

UAG z/OS task definitions may be defined to retrieve the job log (that is the job's JES system data sets) once the job completes processing. The job logs are transmitted to the Controller and stored in the database. The job logs can be viewed from the Universal Controller web interface. In this configuration, once UAG has completed retrieving the job log, the SYSOUT data sets can be deleted from the JES spool. It is assumed that there are no other SYSOUT applications processing the SYSOUT data sets other then UAG.

The JES_SYSOUT_CLASS option is not required in this configuration. By default, UAG will process a job's SYSOUT data sets from any JES class in which it finds them.

Once UAG has completed processing the SYSOUT data sets, it performs final disposition on them as specified by the UAG JES_SYSOUT_DISP option. Since UAG is the one and only SYSOUT application, the SYSOUT data sets can be deleted. A JES_SYSOUT_DISP value of DELETE will remove the SYSOUT data sets from the JES spool.

...