SYSOUT Groups and Related Topics

SYSOUT is archived in units named SYSOUT groups.
SYSOUT is archived in units named
SYSOUT groups
A SYSOUT group is comprised of one or more SYSOUT data sets for a job that have the same characteristics. For example, these data sets could have the same SYSOUT ID, the same SYSOUT class, the same forms name, and the same FCB and are presented to
sequentially. Any change in characteristics causes the current SYSOUT group to close and a new SYSOUT group is allocated. Once a SYSOUT group is closed, it cannot be reopened to receive more output.
SYSOUT Group Considerations:
  • Each individual SYSOUT group is assigned a 1- to 32-character name referred to as the SYSOUT ID.
  • The default ID assigned to a SYSOUT group is its job name.
  • You can override the default ID for a SYSOUT group.
    To override the ID, code a writer-name as the second positional parameter of the SYSOUT parameter on its DD statement.
  • The ID is coded as a 1-to 8-character writer-name conforming to standard JCL syntax rules.
Specify a dollar sign as the first character of the program name. A dollar sign indicates that the remaining characters of the writer-name are to be appended to the job name to form the SYSOUT ID. If the resulting ID is longer than 32 characters, it is truncated on the right.
Two other national characters -- the at sign (@) and pound sign (#) -- are reserved for
. Do not use these characters as the first character of the writer-name.
Record Length
The logical record for reports processed by
cannot exceed 32752 for fixed-length records or 32756 for variable-length records. This includes the carriage control character.
Example of SYSOUT ID Assignments
This example assumes the following DD statements are contained in a job named PRODJOB:
The SYSOUT IDs that are assigned to data sets are:
Other Features
These features are also available.
  • User Exits
    The product provides a number of user exits that allow you to tailor the product to meet your site's requirements. These user exits are links to the source code.
  • Alternate Date Format
    The default date format for all dates is mm/dd/yyyy (month, day, year). You can set alternate formats of dd/mm/yyyy, yyyy/mm/dd, or yyyy/dd/mm. The mm/dd/yyyy format is used throughout the documentation.
  • Printing Capabilities
    You can:
    • Specify variables that range from lines-printed and pages-printed limits to multiple printer systems.
    • Print to standard printers and VTAM printers.
    • Print through
    • Use the provided external printing interface to print to other products.
PC Transmission
You can transmit (or download) SYSOUT data to
Web Viewer
. This product runs on a PC running on a supported Microsoft Windows operating system.
A SYSOUT group is queued for transmission to your PC session by printing it in batch mode or online using the J or P SYSOUT selection code. From the Print Attribute panels that are displayed by these options, you specify a destination of PC as follows:
DEST ===> pc
To queue a SYSOUT group for transmission to another user's PC session, you append a period and the user's ID to the destination PC. For example, to queue a SYSOUT group to user TOM, specify:
DEST ===> pc.tom
Alternatively, you can use a device synonym as specified using the Define Device command.
As with printing a SYSOUT group, you can modify the page format by specifying a logical view, and you can limit the data that is transmitted by specifying ranges of pages or records.
Double-Byte Character Sets (DBCS)
provides support for DBCS characters such as Chinese, Japanese, or Korean. For the product to recognize and process DBCS data, ensure the following:
  • DBCS data is enclosed by shift out (X'0E')/shift-in (X'0F') characters
  • Shift-out/shift-in pairing is completed in each logical record
  • PRMODE=SOSI1 or PRMODE=SOSI2 is specified for the data set in its //OUTPUT statement (an IBM requirement for printing to a 3800 printer)
You can view DBCS data only on a workstation that provides DBCS input/output capability such as 3270 information display. Currently, only the ISPF and Native TSO online retrieval options support the viewing of DBCS data.
To reprint a SYSOUT group containing DBCS data, use selection code J from online retrieval or the batch retrieval print function.
The Print Services Facility (PSF) must control the printer to which the output is directed.