Setting Defaults › How to Set Session Options › Setting Output Options

Setting Output Options

The session option fill‑in and SET commands determine default print options when you omit the destination clause from PRINT, COMPILE, or RUN commands. For more information about output services, see the chapter "Output Services." Use the SET OUTPUT SESSION command to call up the fill‑in for output options.

The following fill‑in contains all output options that you can set during a session. You can also use SET commands as described with each option.

All of the following commands are explained in detail in the Command Reference Guide.

=>

 ‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑PARTIALLY SHOWN
 IDEAL:      SET OUT OPT (PSS)          PSS#OPTIONS                    FILL‑IN

                          Set PSS  "session" options
                          ‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑‑

 Maximum number of lines:             64000      (1‑64k)
 Default retention period:            02         (1‑99)
 Default number of copies:            01         (1‑99)
 Default print status:                RELEASE    (Release/Hold/Keep)
 Default output width:                240        (1‑240)
 Default network printer width:       000        (0‑240)
 Post successful msg:                 Y          (y/n)
 Name of the batch JCL proc:          DIDDVPSS
 Default destination
         Type:    LIBRARY                        (LIBrary/NETwork/SYStem/MAIl)
         Name:    ____________________________________________________________

Maximum number of lines

The maximum lines for one output. Specify a number between 1 and 64000. This maximum is checked only for DEST LIB outputs.

SET OUTPUT MAX[LINES]

• Default retention period

  The default number of days an output can reside in the output library before being deleted. Specify a value from 1 to 99, but not greater than the maximum value allowed for the site. You can also set this value using the following command:

  SET OUTPUT RETENTION
  

• Default number of copies

  The default number of copies to print if you do not specify COPIES= in the DESTINATION clause of a PRINT command. The number cannot exceed the site maximum. You can also set this value using the following command:

  SET OUTPUT COPIES
  

Default print status

The default status assigned to all outputs generated during the current session. The status can be HOLD, RELEASE, or KEEP. You can also set this option using the following command:

SET OUTPUT DISPOSITION

Default output width

The default output line width. Specify a value up to 240. Individual reports defined in RDF can have line widths up to and including this value. You can also set this value with the following command:

SET OUTPUT WIDTH

Default network printer width

The default width for all outputs generated for network printers. Specify a number from 0 to 240. If you specify 0, the TCT determines the width. If you specify a width in the destination definition, the defined width overrides this width.

Post successful msg

Specifies whether the CA Ideal message that indicates successful completion of a command is suppressed. You can also set this value with the following command:

SET OUT POSTMSG

Name of the batch JCL proc

The name of the cataloged procedure executed to print an output at a SYSTEM printer. Specify any valid cataloged procedure name. If you change this parameter, be sure to rename or copy the installed cataloged procedure PSSUTIL to the same name. You can also set this value using the following command:

SET OUTPUT PROCEDURE

Default destination

The type and name of the default destination used when you do not specify a DESTINATION clause for a command.

Type

Establishes the default printout destination as a system printer (SYSTEM), a network printer (NETWORK), the output library (LIBRARY), or a CA Email+ recipient (MAIL).

Name

Specifies the system or network printer name or CA Email+ ID that is the default destination for any output printed during the current session with no destination clause specified.

You can also set the destination type and name using the following command:

SET OUTPUT DESTINATION

Setting Compile Options

The following SET commands determine default compilation options affecting the types of compilation listings produced and highlighting errors on the procedure definition. Compilation is described fully in the Creating Programs Guide.

For more information about the following commands, see the Command Reference Guide.

SET COMPILE DBCS

Establishes whether compile processing is sensitive to double‑byte character sets. For more information, see the Administration Guide.

SET COMPILE LSQL

Establishes whether SQL statements generated for FOR statements appear in the compilation listing.

SET COMPILE IDE

Establishes whether identification information appears in the compilation listing.

SET COMPILE EXD

Establishes whether the external data definitions (dataviews, panels, and reports) will appear in the compilation listing.

SET COMPILE BOD

Establishes whether the body of the program appears in the compilation listing.

SET COMPILE ADV

Establishes whether advisory messages appear in the compilation listing.

SET COMPILE MEL

Establishes whether the lines of the procedure in error are highlighted.

SET COMPILE REF

Establishes whether a cross reference listing appears in the compilation listing. You can specify this option for online compiles and for any batch compiles. No cross reference listing is generated in CICS.

Options are FULL, SHORT, and NO. FULL generates a complete cross reference listing. SHORT suppresses those symbol names that are defined but not referenced. NO produces no listing.

SET COMPILE PANEL

Establishes whether panel components appear in the compilation listing. Settings are: F (Full) to provide all panel components.; S (Short) to provide only the Identification Window; and N (No) to provide no panel components.

Note: This option applies only if External Data (SET COMPILE EXD) is set to Y. If External Data is set to N, then this option is ignored.