Creating a set of printer attributes

A set of printer attributes provides parameters for physically printing reports on a printer.

It also can provide values for the "dynamic printing parameters" under certain printing configurations (see Which printing parameter values are used).

To create a set of printer attributes:

  1. From the Output Manager main menu, choose option A, Administrative Functions, and press Enter.
  2. From the Administrative Functions menu, choose option K, Printer Attributes, and press Enter.
  3. Specify search criteria, or leave the fields blank, and press Enter.
    The resulting list is filtered by your search criteria.

    If no printer attributes have been defined, Output Manager first displays a pop-up window that indicates no printer attributes have been found. Press Enter and skip to Step 4.

  4. Type ADD on the command line and press Enter.
    The Printer Attribute Details panel is displayed.
    Tip: Once a printer attribute has been defined, you can type I (Insert) In the CMD column and press Enter to display the Printer Attribute Details panel.

    Fields:

    Note: For detailed information about the printer parameters that correspond to these fields, refer to the z/OS® MVS™ JCL Reference Manual. If a character field is left blank, or if a numerical field is zero (0), Output Manager ignores the field.
    Name
    (Required) A user-defined name for the set of printer attributes. This name can be up to 32 characters long.
    Class
    The one-character output class for the SYSOUT data set. This value can be a letter from A through Z or a number from 0 through 9. If you do not know the class to use, ask your system administrator. Corresponds to the CLASS parameter.
    Destination
    The destination for the SYSOUT data set. A destination can be a remote or local terminal, a node, a node and a remote work station, a node and a user ID, or a local device or group of devices. Corresponds to the DEST parameter.
    Copies
    The number of copies to print. You can specify a number from 0 through 255 (on JES2). The default value of 0 indicates that no copies should be physically printed. Corresponds to the COPIES parameter.
    Page Def
    The name of a member that contains statements to direct the PSF how to print a data set on a page-mode printer. The data set can hold SYSOUT from the spool or be allocated directly to a printer. These statements can indicate:
    • The logical page length and width
    • Fonts
    • Page segments
    • Multiple page types or formats
    • Lines within a page
    • Multiple logical pages on a physical page

    This member must be in the library that is named in the cataloged procedure for initializing the PSF or in a library that is specified in the USERLIB parameter. Corresponds to the PAGEDEF parameter.

    Format Def
    The name of a member that contains statements to direct the Print Services Facility (PSF) how to print a SYSOUT data set on a page-mode printer such as the 3800 Printing Subsystem Model 3. These statements can indicate:
    • Overlay forms to use during printing
    • The location on a page where the overlays are to be placed
    • Suppressions that can be activated for specific page formats

    This member must be in the library that is named in the cataloged procedure for initializing the PSF or in a library that is specified in the USERLIB parameter. Corresponds to the FORMDEF parameter.

    Form
    The name of the form on which the SYSOUT data set is to be printed or punched. This name can be up to eight characters long and is composed of alphanumeric characters or national characters ($, #, @). Corresponds to the FORMS parameter.
    UCS
    The universal character set (UCS) that JES is to use when printing the SYSOUT data set. This value can be up four characters long and is composed of alphanumeric or national ($, #, @) characters. Corresponds to the UCS parameter.
    FCB
    The Forms Control Block (FCB) name that JES uses to print a SYSOUT data set. This name can be up to four characters long and is composed of alphanumeric or national ($, #, @) characters. Corresponds to the FCB parameter.
    PRMODE
    Indicates the printing process mode to be used for printing the SYSOUT data set. Corresponds to the PRMODE parameter.
    TRC (Table Ref Chr)
    Whether the logical records for the SYSOUT data set contain table reference character (TRC) codes. A TRC code indicates which font in the Char Arg Tbl field to use for printing a record. Valid values are Yes (includes TRC codes) and No (does not include TRC codes). Corresponds to the TRC parameter.
    Writer
    The name of the external writer that is to process the SYSOUT data set instead of JES. This name can be up to eight characters in length. Corresponds to the WRITER parameter.
    Priority
    The print priority. This value must be a number from 0 (lowest priority) to 255 (highest priority). The greater the priority value, the sooner a report data set will be printed. Corresponds to the PRTY parameter.
    Line Count
    The maximum number of lines that JES2 will print on each output page. This value must be a number from 0 to 255. Corresponds to the LINECT parameter.
    Note: This field applies only to JES2 systems.
    Flash
    The name of the forms overlay frame to be inserted into the printer before printing the SYSOUT data set on a 3800 printer. You can specify the name of a specific forms overlay frame. This name can be up to four characters in length and can be composed of alphanumeric characters and national characters ($, #, @). Alternatively, you can specify NONE to suppress flashing for the SYSOUT data set. Corresponds to the FLASH parameter.
    Copy Group
    Specifies how many copies of each page are to be printed, with a maximum of eight group-values. Each group-value is 1 through 3 decimal numbers, with a valid range from 1 through 255. The default for these fields is 0. The sum of the CopyGroup fields must not exceed 255. Corresponds to the COPYG parameter: COPYG=(group-value[,group-value]...). For more information, see the JCL Reference manual. The default for these fields is 0.
    Input Tray
    A number that identifies the input tray. Valid values are from 0 through 255. The default value is 0 (blank). Corresponds to the INTRAY parameter.
    Output Bin
    A number that identifies the output bin where the SYSOUT data set will be sent. Valid values are from 0 through 65535. The default value is 0 (blank). Corresponds to the OUTBIN parameter.
  5. Type S (select) next to PSF related fields and press Enter to specify the following fields:
    PSF Notify ID
    The user IDs of the persons to be notified when the output is printed. You can specify up to four user IDs, for a total of 17 characters. If you specify multiple user IDs, you must include a node name in parentheses before each user ID, for example, node1.myid. Corresponds to the NOTIFY parameter.
    FSS Data
    The functional subsystem (FSS) data. This data is passed from a spooling product to a functional subsystem application (FSA) or other de-spooler. This value can be up to 127 characters in length. Corresponds to the FSSDATA parameter.
    Color Map
    Indicates the name of the data set, COLORMAP, that contains color translation information.
    Fiche Setup
    The name of the fiche setup. This name can be up to eight characters long.
    Err Blocking
    An option that indicates how to handle the following types of errors: print-positioning errors (occur when the printed data goes beyond the physical limits of the page, or beyond the overlay or logical page that is associated with this print job) and invalid-character errors (occur when a text character is not part of a font set). These errors can be either reported normally or blocked. Valid values are:
    • Block causes both print-positioning errors and invalid-character errors to not be reported to PSF.
    • Char Blk causes invalid-character errors to be blocked and print-positioning errors to be reported.
    • Pos Blk causes positioning errors to be blocked and invalid-character errors to be reported.
    • Unblock causes both print-positioning errors and invalid-character errors to be reported.
    Print Errors
    On the first line, indicate whether all error messages should be printed at the end of the output data set. Specify Yes to print all messages, or specify No to print only the messages that force an early termination of the print job. On the second line, type a number from 0 to 999 to indicate the maximum number of error messages that can be issued before Output Manager cancels the printing of the current data set. A value of 0 indicates an infinite number of messages. This message count includes all error messages that are generated by PSF, even if you specified No on the first line.
    Error disp
    Indicates what to do if an error occurs during printing that forces the termination of the print job. Default: Performs the standard action that is taken when an early termination error occurs. Quit: Releases the data set back to JES as complete even if an early termination error occurs during printing. Hold: Keeps the data set on the spool until a system operator releases it.
    Remote Queue
    The name of the remote queue for the printer. This name can be up to 125 characters long.
    User Libs
    The names of the libraries that contain the AFP resources to be used by the printer when processing SYSOUT data sets. The system searches these libraries before using any system-defined resources. You can specify up to eight library names, each up to 44 characters long (a maximum of 352 characters). Corresponds to the USERLIB parameter.
    Note: If you also complete the Format Def and Page Def fields, the system will search the user libraries for page definitions and format definitions before continuing to the system libraries.
    User Data
    User-defined keywords and values, or a text string. You can specify up to 16 keywords, each up to 60 characters in length (or a maximum of 928 characters). Corresponds to the USERDATA parameter.
    Press PF3 to return to the Printer Attributes panel.
  6. Type S (Select) in the 3800 Printer related fields field and press Enter to specify attributes related to 3800 printing.
    Front Overlay
    The name of the front overlay to be included on the front side of each printed sheet for the data set. This name can be up to eight characters long.
    Back Overlay
    The name of the back overlay to be included on the back side of each printed sheet for the data set. This name can be up to eight characters long.
    Form Length
    The page length that can be printed without reconfiguring the printer or changing the page length units (inches or centimeters). On the first entry line, specify a number from 0 through 9999. On the second entry line, specify the unit of measure: CM (centimeters) or IN (inches). For example, if you specify 11 IN, a page of length 11 inches could be sent to the printer.
    Front Offset
    The X-Y coordinates for the front-side offset. The front-side offset affects only the front side of each page of output. Valid values are from 0 to 9999 on each entry line. (The first line is for the X coordinate.)
    Back Offset
    The X-Y coordinates for the back-side offset. The back-side offset affects only the back side of each page of output. Valid values are from 0 to 9999 on each entry line. (The first line is for the X coordinate.)
    Press PF3 to return to the Printer Attributes panel.
  7. Type S (Select) in the Miscellaneous Fields field and press Enter to specify more optional attributes:.
    Checkpt Lines
    The maximum number of lines per logical page. JES uses this value, along with the CKPTPAGE parameter, to determine when to take checkpoints while printing the SYSOUT data set or transmitting the SNA data set. This value must be a number from 0 to 32767. Corresponds to the CKPTLINE parameter.
    Checkpt Pages
    The number of logical pages that can be printed or that can be transmitted as an SNA chain to an SNA workstation before JES takes a checkpoint. This value must be a number from 0 to 32767. The default value is 0 (blank). Corresponds to the CKPTPAGE parameter.
    Checkpt Secnd
    The number of seconds that must elapse between checkpoints during the printing of a SYSOUT data set. This value must be a number from 0 to 32767. The default value is 0 (blank). Corresponds to the CKPTSEC parameter.
    Compact Table
    The name of the compact table for JES to use when sending the SYSOUT data set to an SNA remote terminal. This name can be up to eight alphanumeric characters in length. Corresponds to the COMPACT parameter.
    Control
    The printer control that defines the line spacing for the output. Valid values are:
    • Double prints the output with double-spacing.
    • Program causes each logical record to start with a carriage control character.
    • Single prints the output with single spacing.
    • Triple prints the output with triple-spacing.

    Corresponds to the CONTROL parameter.

    Retain Success
    The duration for which to retain the data set after it has been successfully transmitted. Specify a time interval in the format HHHH:MM:SS (hours, minutes, and seconds), or specify FOREVER to retain the data set indefinitely. For example, to release the data set to JES two hours after a successful transmission, type 0002:00:00. Corresponds to the RETAINS parameter.
    Retain Failed
    The duration for which to retain the data set after its transmission has failed. Specify a time interval in the format HHHH:MM:SS (hours, minutes, and seconds), or specify FOREVER to retain the data set indefinitely. For example, if you want to release the data set to JES three hours after the last transmission fails, type 0003:00:00. Corresponds to the RETAINF parameter.
    Retry Limit
    The maximum number of times to reattempt transmitting a data set before the limits that are specified in the Retain Success and Retain Failed fields take effect. This value must be a number from 0 to 32767. Corresponds to the RETRYL parameter.
    Note: If the retries are unsuccessful, the value in the Retain failed field is used to determine what to do next.
    Retry Time
    The duration for which to wait between each attempt to transmit a data set. Specify a time interval in the format HHHH:MM:SS (hours, minutes, seconds). Corresponds to the RETRYT parameter.
    Port Number
    The TCP/IP port number for the FSS connection to the printer. This value must be a number from 1 through 65535.
    Resolution
    The resolution to use for formatting the print data set. Valid values are: P240 (240 pixels per inch) and P300 (300 pixels per inch).
    Norm Disp
    The disposition of the SYSOUT data set after the job is completed normally. Valid values are:
    • HOLD holds the SYSOUT data set until a user or operator releases it, thereby changing its disposition to WRITE. If a held output is not released, the user or operator can purge it.
      Note: In an NJE environment, the system does not hold the data set until it reaches its ultimate destination node.
    • KEEP prints the SYSOUT data set and then changes its disposition to LEAVE.
    • LEAVE changes the disposition of the SYSOUT data set to KEEP after the user or operator releases it. If the LEAVE output is not released, the system hold it until the user or operator purges it.
    • PURGE deletes the SYSOUT data set without printing it.
    • WRITE prints the SYSOUT data set and then purges it. Unless a SYSOUT is held by the system or operator, it will always be printed.
    Cond Disp
    The disposition of the SYSOUT data set after the job is completed abnormally or fails. Valid values are the same as those for Norm Disp above.
    Left Margin
    The left margin for a 3211 printer. This value must be a number from 0 through 99. The value of 1 creates flush-left, full-width lines.

    If you specify this value, you cannot also specify a value in the Right margin field. These fields are mutually exclusive.

    Right Margin
    The right margin for a 3211 printer. This value must be a number from 0 through 99. The value of 1 creates flush-right, full-width lines.

    If you specify this value, you cannot also specify a value in the Left margin field. These fields are mutually exclusive.

    Overflow
    Indicates whether or not a JES overflow check is to be performed. Yes: Printer ejects when an end-of-forms indicator is encountered. No: Does not check for overflow.
    Threshold
    Indicates the maximum size of the SYSOUT data for the JES3 THRESHLD option. Valid values are between 1 and 99999999.
  8. Type S (Select) in the PDF Attribute fields field and press Enter to specify more optional attributes.
    Orientation
    Specifies the Orientation of the PDF attached to the email. Valid values are L (Landscape) / P (Portrait). Default is Landscape.
    Page Size
    Indicates the page size of the PDF attached to the email in terms of Width by Height. Valid values are integers if the unit is MM or decimal if the unit is INCH. The default values are: Width=11.0 Inch and Height=8.50 Inch.
    There are two ways to add or change Page size from the Link panel:
    • Type 1 in the Choose a predefined page size panel and press Enter to specify more optional attributes:

      This offers a list of predefined width and height which are standard and can be chosen by typing S (select) or /.

    • Type 2 in the Choose a custom page size panel and press Enter to specify more optional attributes.
      Page Units
      Page unit can be entered as I (Inch) or M (MM), Default is Inch.
      Page Height
      Specify integer values if unit is MM, ranging between 25-2500.

      Specify decimal values if unit is INCH, ranging between 1.0 – 100.00.

      Default value is 8.5 Inch.

      Page Width

      Specify integer values if unit is MM, ranging between 25-2500.

      Specify decimal values if unit is INCH, ranging between 1.0 – 100.00.

      Default value is 11.0 Inch.

    Top Margin
    Indicates the Top Margin of PDF in units. To add or change the Top Margin go to the Link panel

    Type 3 in the Choose margin size panel and press Enter to specify more optional attributes.

    Top Margin
    • Specify integer values if unit is MM.
    • Specify decimal values if unit is INCH.

      Default value is 1.0 Inch.

    Bottom Margin
    Indicates the Bottom Margin of PDF in units. To add or change the Bottom Margin go to the Link panel

    Type 3 in the Choose margin size panel and press Enter to specify more optional attributes.

    Bottom Margin
    • Specify integer values if unit is MM.
    • Specify decimal values if unit is INCH.

      Default value is 1.0 Inch.

    Left Margin
    Indicates the Left Margin of PDF in units. To add or change the Left Margin go to the Link panel

    Type 3 in the Choose margin size panel and press Enter to specify more optional attributes.

    Left Margin
    • Specify integer values if unit is MM.
    • Specify decimal values if unit is INCH.

      Default value is 1.0 Inch.

    Right Margin
    Indicates the Right Margin of PDF in units. To add or change the Right Margin go to the Link panel

    Type 3 in the Choose margin size panel and press Enter to specify more optional attributes.

    Right Margin
    • Specify integer values if unit is MM.
    • Specify decimal values if unit is INCH.

      Default value is 1.0 Inch.

    Font
    Indicates the font of the PDF to be emailed. To add or change Font go to the Link panel:

    Type 4 in the Choose a font panel and press Enter to specify more optional attributes.

    This offers a list of fonts that can be chosen by typing S (select) or / and press Enter.

    Default value is Lucida Console.

    Font Size
    Specify the font of the pdf to be emailed. Should be a valid integer. Default value is 8.
    Fit to page
    Indicates if user wants to fit the text to the available page size. Valid values are Y or N. Default value is N.
    Wrap Long Lines
    Indicates if user wants to wrap the text to the new line or not. Valid values are Y or N. Default value is N.
  9. (Required) In the Name field, specify a name for this set of printer attributes.
  10. Specify values in any of the other fields, as needed.
  11. Press F3 (Exit). An exit confirmation pop-up window is displayed.
  12. Press Enter to save your entries and exit.
  13. Activate the policy.