Setting print output options

The OUTP major command and its minor commands control the printing of XLFLOG and REPORT files.

OUTP
Controls the characteristics of log files.
Type:
Major
Format:
OUTP cccccc

The variable cccccc is either XLFLOG or REPORT.

The OUTP major command displays column headings for pending and current values associated with all of its minor commands:


 
 OUTP REPORT
+                         |----- Pending ------|----- Current ------|

If you type an OUTP minor command followed by the new value you want to assign and press ENTER, the new value displays in the pending value column. It will become the active value when you reallocate the log with /LOG OUT, .LOGOUT, /XLFLOG, or .XLFLOG.

The log will be routed to one of the following data set types:

  • SYSOUT, the initial data set type for OUTP. This file is designated FREE=CLOSE. This means that every time you enter the /LOGOUT, .LOGOUT, /XLFOUT, or .XLFOUT command, the REPORT log or the XLFLOG automatically spins off and is available for printing.
  • A sequential data set, with a ddname you specify. Its DCB attributes are LRECL=nn, where nn is the screen column width plus 1; RECFM=FBA; and BLKSIZE is a multiple of LRECL. If you specify attributes that do not conform to these standards, OMEGAMON will dynamically reset them.

    The IDSP parameter may be set to MOD, SHR, or OLD.

    CAUTION:
    The OMREPORT DD statement is optional and is not recommended. If DISP=SHR or DISP=OLD is used, any action to close and reopen the file will reinitialize it, thus deleting existing information.

Only one session at a time per address space can use a specific ddname.

Note: Some prior releases of OMEGAMON used ddname OMREPORT if it was present. This release also looks for ddname OMREPORT if present, but will access it only if it is not currently in use.
Each OUTP minor command controls one XLFLOG or REPORT file characteristic. That characteristic is under the control of ddname or SYSOUT. When SYSOUT is active, ddname is inactive and vice versa. Parentheses around a value in the OUTP display indicate that it is currently inactive. Table 1 shows the minors and the initial settings for the SYSOUT or ddname data sets.
Table 1. OUTP minor commands and initial values
Parameters Initial values
SYSOUT DDNAME
SOUT A (inactive)
HOLD NO (inactive)
COPY 1 (inactive)
FORM *NONE* (inactive)
DEST *NONE* (inactive)
DSTU userID (inactive)
DDNM (inactive) *DYNAMIC
FOLD YES YES
LNCT 60 60
ID1 jobname jobname
ID2 (blank) (blank)
ID3 (blank) (blank)
ID4 (blank) (blank)
COPY
Specifies the number of copies to print.

The COPY minor is under SYSOUT control.

Type:
Minor of OUTP
Format:
COPY nn

If you set the HOLD minor command to YES, OMEGAMON ignores the COPY command. If the value you type is not valid, OMEGAMON redisplays it where you typed it and does not transfer it to the pending column.

DDNM
Directs output to a particular ddname.

The DDNM minor removes control from SYSOUT.

Type:
Minor of OUTP
Format:
DDNM cccccccc

If the value you type is not valid, OMEGAMON redisplays it where you typed it and does not transfer it to the pending column.

DEST
Specifies the destination that is to receive the output.

The DEST minor is under SYSOUT control.

Type:
Minor of OUTP
Format:
DEST cccccccc

The default is *NONE*, which sends output to the local printer. The destination can be a terminal, a node, a remote work station, a local device or group of devices, or a user ID.

Your installation determines valid destinations. OMEGAMON checks your installation’s table for valid destinations only when you reset the log (with .LOGOUT or .XLFOUT). During initialization, OMEGAMON only checks syntax validity.

If the destination is a specific user ID (at the device destination), use the DSTU minor command for the user ID.

DSTU
Specifies the destination user ID to receive a report.

The DSTU minor is under SYSOUT control.

Type:
Minor of OUTP
Format:
DSTU cccccccc

The default is *NONE*, which sends output to the local printer. Enter the destination user ID in the format established for your installation.

Your installation determines valid destinations. OMEGAMON checks your installation’s JES parameters for valid destinations only when you reset the log (with .LOGOUT or .XLFOUT). During initialization, OMEGAMON only checks syntax validity.

FOLD
Changes lowercase characters to uppercase.

FOLD is active under ddname or SYSOUT.

Type:
Minor of OUTP
Format:
FOLD ccc
YES
Lowercase characters are changed to uppercase before printing (default).
NO
Lowercase characters are not changed to uppercase before printing.

If the value you type is not valid, OMEGAMON redisplays it where you typed it and does not transfer it to the pending column.

FORM
Specifies the name of the form on which to print.

The FORM minor is under SYSOUT control.

Type:
Minor of OUTP
Format:
FORM cccc

The default value is *NONE*. This means that OMEGAMON uses the form defined as the default for the printer at that destination.

If the value you type is not valid, OMEGAMON redisplays it where you typed it and does not transfer it to the pending column.

If you change *NONE* to a value (such as HOLE), and you then want to return to *NONE*, type an asterisk(*).

HOLD
Specifies that output be placed in the hold queue.

The HOLD minor is under SYSOUT control.

Type:
Minor of OUTP
Format:
HOLD ccc
YES
Places the print file on the hold queue, and allows it to be retrieved from TSO.
NO
Does not place the print file on the hold queue (default).

If the value you type is not valid, OMEGAMON redisplays it where you typed it and does not transfer it to the pending column.

ID1
Requests separator pages and page headers that identify output from different OMEGAMON sessions.

ID1 is active under ddname or SYSOUT.

Type:
Minor of OUTP
Format:
ID1 cccccccc
*
OMEGAMON generates separator pages and page headers with the appropriate job name printed in block letters on the pages. This is the default.
*NONE*
OMEGAMON does not generate separator pages and page headers.
cccccccc
OMEGAMON generates separator pages and page headers with cccccccc printed in block letters on the pages. cccccccc is up to 8 user-defined characters.
ID2
Defines up to 16 characters on the left of separator page.

ID2 is active under ddname or SYSOUT.

Type:
Minor of OUTP
Format:
ID2 ccc|ccc

When separator pages and page headers are requested with ID1, ID2 can define up to 16 characters to appear on the left of the separator page justified underneath the block letters.

ID3
Defines up to 16 characters in the center of separator page.

ID3 is active under ddname or SYSOUT.

Type:
Minor of OUTP
Format:
ID3 ccc|ccc

When separator pages and page headers are requested with ID1, ID3 can define up to 16 characters to appear centered on the separator page beneath the block letters.

ID4
Defines up to 16 characters on the right of the separator page.

ID4 is active under ddname or SYSOUT.

Type:
Minor of OUTP
Format:
ID4 ccc∥ccc

When separator pages and page headers are requested with ID1, ID4 can define up to 16 characters to appear on the right of the separator page justified below the block letters.

LNCT
Sets the number of lines per page for the REPORT or XLFLOG file output.
Type:
Minor of OUTP
Format:
LNCT nn
SOUT
Removes control from a sequential data set and directs it to the specified SYSOUT class.

The SOUT minor removes control from the ddname currently used for your XLFLOG or REPORT log and directs it to SYSOUT.

Type:
Minor of OUTP
Format:
SOUT c

The variable c is the SYSOUT class.