z/OS TSO/E Administration
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


To view the General PRINTDS Parameters

z/OS TSO/E Administration
SA32-0977-00

  1. Type Y in the PRINTDS USED field on Figure 1.
  2. Then type ICQCPC15 in the CLIST NAME field. Press the Enter key to return to Figure 1.
  3. Select the PARAMETERS option (option 3) in Figure 1.

These actions bring you into the series of panels for General PRINTDS Parameters and you see the following panel, the first of six.

Figure 1. Printer – General PRINTDS Parameters
ICQAPE53              General PRINTDS Parameters                     Page 1 of 6
Command ===>

   Printer Location ..... NY/701/R09
   Print Format ......... LETTER
   Printer Type ......... 6670
   Description .......... 6670 printer, letter with logo

Enter or change the following optional information.
To continue press ENTER.  To exit without saving, press END.

   OUTDES          ===> ________ Output descriptor
   FORMS           ===> ____     Special paper required.  SYSOUT forms name
   DCF             ===> _        (Y/N) Input is formatted by DCF (SCRIPT)

   Members         ===> _        (Y/N) Y to print members of a PDS
   Directory       ===> _        (Y/N) Y to print PDS directory

   To Dataset      ===> ________________________________
                                 (Output is directed to dataset without printing)
   HOLD            ===> _        (Y/N) Y to hold data set before printing
OUTDES
The OUTDES field allows you to specify the name of an output descriptor that you want used with the print definition. The name must be defined in the user's LOGON procedure or using the TSO/E OUTDES command (JES2 only). Valid names may have up to 8 characters, A-Z, 0-9, $, #, or @. The first character cannot be 0-9. For information about defining output descriptors on OUTPUT JCL statements, see z/OS MVS JCL Reference. For more information about using the TSO/E OUTDES command to dynamically define output descriptors, see z/OS TSO/E Command Reference.
FORMS
To specify that the output be printed on a special form, type the name of the form. Valid form names have up to four characters, A-Z, 0-9, $, #, or @.
DCF
 
Type Y
If you want data sets formatted by the script command's Document Control Facility (DCF) to be printed using the font information from DCF.
Type N
If you do not want any DCF font information used in printing.

If you do not type a value, Y is assumed. If a data set is not formatted by DCF, or does not have ANSI or machine code carriage control characters, this field is ignored when the data set is printed.

MEMBERS DIRECTORY
These fields correspond to the MEMBERS/DIRECTORY/ALL parameter of the TSO/E PRINTDS command.

To print the members and directory of a partitioned data set (PDS), type Y in both fields or leave them blank. (The directory is a list of the members in the PDS.) To prevent printing either PDS members or directories, type N in the appropriate field. DO NOT type N in both fields as this would prevent the printing of any part of a PDS.

TO DATASET
If you want output data to go to a data set instead of being printed, specify the data set in this field. Output data replaces any existing data in the data set. If the specified data set does not exist, the PRINTDS command will attempt to allocate it.
HOLD
 
Type Y
If you want the data set to be placed in the JES Held Output queue before printing.
Type N
Or leave a blank if you want the data set to be available for printing immediately.
Note: If the pre-defined SYSOUT class has a HOLD/NOHOLD condition associated with it, that condition overrides any value in this field.

The second panel of the General PRINTDS Parameters is as follows:

Figure 2. Printer – PRINTDS – Output Format
ICQAPE54                   PRINTDS - Output Format                   Page 2 of 6
Command ===>

   Printer Location ..... NY/701/R09
   Print Format ......... LETTER
   Printer Type ......... 6670
   Description .......... 6670 printer, letter with logo

Enter or change the following optional information.
To continue press ENTER.  To exit without saving, press END.


   SYSOUT Class      ===> _        A-Z, 0-9
   Page Length       ===> ____     Number of lines including margins
   Title             ===> _        (Y/N) Y to print title on every page
   Top Margin        ===> __       Number of blank lines at top of page
   Bottom Margin     ===> __       Number of blank lines at bottom of page
   Left Margin       ===> __       Number of columns indented on left of page
   Maximum Length    ===> ___      Maximum length of the output line
   Excess Length     ===> ___      FOLD or TRUN(truncate) if max length exceeded
   Line Spacing      ===> _______  SINGLE, DOUBLE, TRIPLE space output,
                                   or CONTROL if spacing specified in column 1
SYSOUT CLASS
Type the SYSOUT class that you want used when this print definition is selected. Choose from among the output classes that have been established at your location. Valid entries are a single character: A-Z, 0-9. If you leave a blank, a SYSOUT class of A is assumed, unless TO DATASET was specified on the previous panel.
PAGE LENGTH
Type the number of lines that you want to appear on a page. You can type a number from 1 to 4095. If you do not type a number, a page length of 60 lines is assumed. The page length must include any lines specified in the TOP MARGIN and BOTTOM MARGIN fields. The page length, less the TOP and BOTTOM MARGIN values, must be at least 3, or at least 6 if a title is printed on each page.
TITLE
To print a title on every page of the printed output, type Y. The title includes the name of the data set being printed and the page number. To omit the title, type N. If you leave the TITLE field blank, Y is assumed, unless the data set has carriage control characters or the LINE SPACING field is set to C. If the TITLE field is blank in either of those cases, N is assumed.
TOP MARGIN
Type the number of lines to be left blank at the top of each printed page. You can type a number from 0 to 99. Typing 0 is the same as leaving the field blank. Any TOP MARGIN value other than 0 or a blank is mutually exclusive with a value of C in the LINE SPACING field.
BOTTOM MARGIN
Type the number of lines to be left blank at the bottom of each printed page. You can type a number from 0 to 99. Typing 0 is the same as leaving the field blank. Any BOTTOM MARGIN value other than 0 or a blank is mutually exclusive with a value of C in the LINE SPACING field.
LEFT MARGIN
Type the number of columns that you want the printed output to be indented from the left side of the page. You can type a number from 0 to 99. Typing 0 is the same as leaving the field blank. When printing a partitioned data set (PDS) directory, this margin is ignored.
MAXIMUM LENGTH
This field corresponds to the FOLD/TRUNCATE parameters of the TSO/E PRINTDS command. Type the maximum number of characters that you want to appear in the printed line. If you type FOLD in the following field, lines of input data will continue on the next printed line when they exceed this number. If you type TRUN in the following field, lines of input data will be truncated when they exceed this number.
EXCESS LENGTH
This field corresponds to the FOLD/TRUNCATE parameters of the TSO/E PRINTDS command. Type FOLD if you want the lines of input data to continue on the next printed line when they exceed the value in MAXIMUM LENGTH. Type TRUN if you want the lines of input data to be truncated when they exceed the value in MAXIMUM LENGTH. If you leave the field blank, lines of input data will be truncated when they exceed the output record length as determined by the printer.
LINE SPACING
This field corresponds to the CCHAR/SINGLE/DOUBLE/TRIPLE parameter of the TSO/E PRINTDS command. Use this field to specify line spacing in the printed output. For single spacing, type SINGLE, for double spacing type DOUBLE, for triple spacing, type TRIPLE. If you want ANSI or machine code carriage control characters in the data set to determine line spacing, type CONTROL. If the input data set contains carriage control characters, CONTROL is assumed.

The third panel of the General PRINTDS Parameters is as follows:

Figure 3. Printer – PRINTDS – Content Description
ICQAPE55              PRINTDS - Content Description                  Page 3 of 6
Command ===>

   Printer Location ..... NY/701/R09
   Print Format ......... LETTER
   Printer Type ......... 6670
   Description .......... 6670 printer, letter with logo

Enter or change the following optional information.
To continue press ENTER.  To exit without saving, press END.


   First Line        ===> ____     Line number of first line to be printed
   Last Line         ===> ____     Last line to be printed or LAST

If printing is to be based on embedded line numbers, enter the following:

   First Column      ===> ___      First column containing embedded line number
   Length            ===> ___      Length of embedded line number


FIRST LINE/LAST LINE
To specify a range of lines to be printed, type the numbers of the first and last lines in the range. To print the first line of a data set, type 1 in the FIRST LINE field. To print to the end of a data set, type LAST in the LAST LINE field. If you are specifying a range of lines using embedded line numbers, fill in the FIRST COLUMN and LENGTH fields.
FIRST COLUMN/LENGTH
These fields correspond to the NUM parameter of the TSO/E PRINTDS command. To print lines based on embedded line numbers, do the following:
  • In the FIRST COLUMN field, type the number of the column where embedded line numbers begin.
  • In the LENGTH field, type the number of columns that the line number field occupies. The length may not be greater than 8.

The fourth panel of the General PRINTDS Parameters is as follows:

Figure 4. Printer – PRINTDS – Content Description
ICQAPE56              PRINTDS - Content Description                  Page 4 of 6
Command ===>

   Printer Location ..... NY/701/R09
   Print Format ......... LETTER
   Printer Type ......... 6670
   Description .......... 6670 printer, letter with logo

To print only selected columns, enter or change the following information.
To continue press ENTER.  To exit without saving, press END.

   From Column   ===> ___      To Column   ===> ___
   From Column   ===> ___      To Column   ===> ___
   From Column   ===> ___      To Column   ===> ___
   From Column   ===> ___      To Column   ===> ___
   From Column   ===> ___      To Column   ===> ___
   From Column   ===> ___      To Column   ===> ___
   From Column   ===> ___      To Column   ===> ___
   From Column   ===> ___      To Column   ===> ___
   From Column   ===> ___      To Column   ===> ___
   From Column   ===> ___      To Column   ===> ___
FROM COLUMN/TO COLUMN
To print certain columns of a data set, specify the numbers of the columns where you want printing to begin (FROM COLUMN) and end (TO COLUMN). You can specify up to ten pairs of column numbers. The columns of data are printed in the order in which you specify them on the panel.
For example, if you specified the following:
From Column ===> 72     To Column ===> 80
From Column ===> 20     To Column ===> 50

The printed lines would contain the data from columns 72-80 of the input data set, followed by the data from columns 20-50.

Note: If an input record contains a carriage control or TRC character, column 1 refers to the first position after that character.

The fifth panel of the General PRINTDS Parameters is as follows:

Figure 5. Printer – PRINTDS – 3800 Parameters
ICQAPE57                  PRINTDS - 3800 Parameters                 Page 5 of 6
Command ===>

   Printer Location ..... NY/701/R09
   Print Format ......... LETTER
   Printer Type ......... 3800
   Description .......... 3800 printer, letter with logo

Enter or change the following optional information.
To exit without saving, press END.

   SYSOUT Writer      ===> ________  SYSOUT writer (if other than JES)
   UCS                ===> ____      Character set name to print with
   Total Copies       ===> ___       Number of copies to be printed
   Per Group(if any)  ===> ___ ___ ___ ___
                                   Copy group value (Sum not to exceed 255)
   FCB                ===> ____      Name of forms control buffer or image
   Modify             ===> ____      Name of copy-modification module
   Translate Code     ===> _         (0/1/2/3) Table reference for modify
   TRC                ===> _         (Y/N) Y indicates  OPTCD J
   Flash              ===> ____      Name of forms overlay
   Flash Count        ===> ___       Number of copies to be flashed
   Burst              ===> _         (Y/N) Y to burst output
SYSOUT WRITER
This field corresponds to the WRITER parameter of the TSO/E PRINTDS command. Specify the name of an installation-written program that is to write the SYSOUT data set, instead of JES2 or JES3. Valid names have up to eight characters, A-Z, 0-9, $, #, or @. The first character cannot be 0-9.
UCS
Specify the universal character-set UCS name for a special character set to be used on a 3211, 3203 Model 5, or 1403 printer. The character set will be used with the print definition in the absence of any other font names. Valid UCS names can have up to four characters, A-Z or 0-9.
TOTAL COPIES
Specify the number of copies of the data set to be printed. Use a number from 1 to 255 in a JES2 system and from 1 to 254 in a JES3 system. If PER GROUP is specified for the 3800 printer, any number in this field is ignored.
PER GROUP
These fields correspond to the COPIES parameter of the TSO/E PRINTDS command. Use this option with the 3800 printer to print each page a specified number of times before the next page is printed. For example, if a data set has five pages and you type:
Per Group ===> 2 3
the resulting pages are printed in the following order:
1,1,2,2,3,3,4,4,5,5, and 1,1,1,2,2,2,3,3,3,4,4,4,5,5,5
This option overrides any number in the TOTAL COPIES field.
FCB
Specify the name of a forms control buffer (FCB) or image used to store vertical formatting information for printing. The FCB information includes the lines per inch and page length to be used. IBM® provides standard FCB images for specific printers. Valid names can have up to four characters, A-Z, 0-9, $ #, or @.
MODIFY
Specify the name of a module that modifies and prints copies of data sets on the 3800 printer. Other printers ignore this parameter. Valid names can have up to four characters, A-Z, 0-9, $, #, or @. The module must be predefined with modification information and stored in the SYS1.IMAGELIB data set.
TRANSLATE CODE
This field corresponds to the TRC operand on the MODIFY parameter of the TSO/E PRINTDS command. Specify a font to be used with the Modify module named in the preceding field. The font must be in the list of fonts for the print definition and must have a font order number of 1, 2, 3, or 4. Type 0 to specify font number 3, or 3 to specify font number 4.
TRC
For the 3800 printer, to indicate that each line of data begins with a print control character followed by a table reference character (0, 1, 2, or 3), type Y. The table reference character (TRC) corresponds to a font to be used to print that line. To indicate that the data set does not contain TRCs, type N.

Y is assumed if any fonts are defined.

FLASH
Specify the name of a 3800 forms overlay to be printed over each page of the output data set. Valid names can have up to four characters, A-Z, 0-9, $, #, or @.
FLASH COUNT
Type the number, 0 to 255, of copies to be printed with the overlay on the 3800 printer, beginning with the first copy printed. Leave the field blank to flash all copies.
BURST
To request that output from the 3800 printer be burst into separate sheets, type Y. If you do not want the BURST option, type N or leave a blank. This field requires special hardware on the 3800 and is ignored for other printers.

The sixth panel of the General PRINTDS Parameters is as follows:

Figure 6. Printer – Parameters
ICQAPE60                     Parameters                              Page 6 of 6
Command ===>

   Printer Location ..... NY/701/R09
   Print Format ......... LETTER
   Printer Type ......... 6670
   Description .......... 6670 printer, letter with logo

Type or change locally defined parameters, if any.
To exit without saving, press END.

   Parameter 1        ===> _______________________________________
   Parameter 2        ===> _______________________________________
   Parameter 3        ===> _______________________________________
   Parameter 4        ===> _______________________________________
   Parameter 5        ===> _______________________________________
   Parameter 6        ===> _______________________________________

This panel allows you to store information about the print definition for use by the calling application or print function.

The information at the top of the panel identifies the print definition. Below it are fields where you can type print parameters specific to this print definition. Be sure to type parameters and values in their required format.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014