Procedure for specifying attributes

To request that NetSpool convert SCS and 3270 data streams to PCL data streams:

1. On the NetSpool Options panel, select the Convert to PCL formatting option.

   _______________________________________________________

2. (Optional) On the Processing panel, specify code pages for EBCDIC to ASCII conversion:
   • Document code page field: Leave this field blank or specify the name of an EBCDIC code page supported by IBM®. If you leave this field blank, the default code page is the EBCDIC code page specified in the ebcdic-codepage attribute Infoprint Server configuration file (aopd.conf) or in the system configuration definition. If the attribute is not specified, NetSpool uses code page IBM-1047.
   • Printer code page field: Specify the name of an ASCII code page that is supported by IBM. The ISPF panels automatically display the ASCII code page that is specified in the ascii-codepage attribute Infoprint Server configuration file (aopd.conf) or in the system configuration definition. If no code page is specified in the printer definition, NetSpool uses code page IBM-850.
   Guidelines:

   1. For most printing situations, you do not need to modify the code pages in the printer definition. The initial values in the printer definition are generally suitable.
   2. If you plan to use this printer definition with Print Interface as well as with NetSpool, leave the Document code page field blank and specify a code page in the Printer code page field. For information about how Print Interface uses these fields, see Converting data from EBCDIC to ASCII or ASCII to EBCDIC.
   3. You can specify any code pages supported by IBM. For valid code page names, see z/OS XL C/C++ Programming Guide.
   4. If you specify a custom code page, make sure that conversion tables exist to convert between these code pages:
      • The code pages in the Document code page and Printer code page fields.
      • The code page for the z/OS® locale and the custom code page.
      For information about how to create conversion tables, see information about code set conversion utilities in z/OS XL C/C++ Programming Guide.

   _______________________________________________________

3. (Optional) On the Processing panel, specify these default page-formatting values, which NetSpool uses for input SCS data streams only:
   • Line length field: Specify the maximum number of columns on each line. This is the default value for the SCS maximum presentation position (MPP) value. Allowed values are 1-255. The default value is 80.
   • Page length field: Specify the maximum number of lines per page. This is the default value for the SCS maximum presentation line (MPL) value. Allowed values are 1-255. The default value is 1, which means that NetSpool does not control the number of lines that are placed on a page. The VTAM® application controls the number of lines per page.
   • Margins: Left field: Specify the column number at which you want data to start on each line. This is the default value for the SCS left margin (LM) value. Allowed values are 1-255. The default value is 1.
   • Margins: Right field: Specify the column number at which you want data to end on each line. This is the default value for the SCS right margin (RM) value. Allowed values are 1-255. The default value is 80.
   • Margins: Top field: Specify the line number of the first line on each page. This is the default value for the SCS top margin (TM) value. Allowed values are 1-255. The default value is 1.
   • Margins: Bottom field: Specify the line number of the last line of data on each page. This is the default value for the SCS bottom margin (BM) value. Allowed values are 1-255. The default value is 1 (no bottom margin).

     If you specify a value of 1, NetSpool does not insert form feeds when the input data stream spaces past the bottom margin. However, NetSpool does insert form feeds when an explicit form feed or a Select Vertical Channel command occurs in the input data.

   • Tabs: Horizontal field: Specify horizontal tabs. This is the default value for the SCS horizontal tab (HT) value. Allowed values are 0-255. The default is no horizontal tabs. The input data stream can add additional tab positions but cannot remove default tabs set in this field.

     NetSpool always sets the first tab to the left margin value. Therefore, do not specify it. NetSpool ignores a value of 0. In this example, NetSpool sets horizontal tabs at columns 6, 15, 50, 75, and 100.

      SCS Conversion:
         Margins:  Top . . . ___   Bottom . . ___   Left . . 6     Right . . ___
         Tabs:  Vertical . . ___  ___  ___  ___  ___  (extend)
                Horizontal . 15   50   75   100  ___  (extend)
      

   • Tabs: Vertical field: Specify vertical tabs. This is the default value for the SCS vertical tab (VT) value. Allowed values are 0-255. The default is no vertical tabs.

     NetSpool always sets the first tab to the top margin value. Therefore, do not specify it. NetSpool ignores a tab value of 0. NetSpool uses the first eleven tabs as line numbers for Select Vertical Channel 2 through 12. In this example, NetSpool sets:

     • Vertical tabs at lines 6, 20, 40, and 50
     • Vertical channels are set: CH01=6, CH02=20, CH04=40, CH05=50

     These vertical channels are not set: CH03, CH06 through CH12.

      SCS Conversion:
         Margins:  Top . . . 6  
         Tabs:  Vertical . . 20   0    40   50   ___  (extend)

   _______________________________________________________

4. (Optional) On the Processing panel, specify these PCL conversion values:
   • Print density field: Specify the number of characters per inch. Valid values are 1-255. The default is the PCL Pitch command or Horizontal Motion Index command specified in the Document header field or, if none is specified, the value set on the printer's control panel.
   • Line density field: Specify the number of lines per inch. Valid values are 1-72. The default is the PCL Line Spacing command or Vertical Motion Index command specified in the Document header field or, if none is specified, the value set on the printer's control panel.
   • Orientation field: Select one of these options. None is the default.
     • None: NetSpool does not specify the PCL page orientation. The PCL Logical Page Orientation command specified in the IP PrintWay™ Document header field or the orientation set at the printer is used.
     • Portrait: Lines are printed parallel to the paper's short edge.
     • Landscape: Lines are printed parallel to the paper's long edge.
   • SCS automatic page orientation field: Select this field if you want NetSpool to automatically determine the orientation (portrait or landscape) of each page. NetSpool ignores this field for 3270 data streams.
     Guideline:

     If you select this field, also specify values in the Print density, Line density, Line length, and Page length fields.

   _______________________________________________________

5. On the IP PrintWay Options panel:
   • Select any IP PrintWay formatting option, because IP PrintWay ignores the IP PrintWay Formatting field if NetSpool has already converted data to PCL.
   • (Optional) Specify PCL commands in the Document header and Document trailer fields.
     Guidelines:

     1. You might want to select a font in the Document header field. For more information, see Selecting a font.
     2. If you specify PCL commands in the Document header field, (1) specify PCL and PJL reset commands before any other PCL commands in the Document header field and also (2) specify PCL and PJL reset commands in the Document trailer field. This is because NetSpool does not reset the printer to its original status when you specify your own PCL commands in the Document header field.

        Specify these PCL 5 commands to reset the printer to its original status:

         Document header  . . <ESC>%-12345X<ESC>E                           (extend)
            / Translate document header
        Document trailer . . <ESC>E<ESC>%-12345X                            (extend)
            / Translate document trailer     

        Command

        Meaning

        <ESC>%-12345X

        Resets the printer and enters PJL mode.

        <ESC>E

        Resets the printer.

        You can also choose to leave the Document header field and Document trailer fields blank. If you leave these fields blank, NetSpool automatically generates the necessary PCL commands to reset the printer to its original status both before and after each data set.

   _______________________________________________________

Examples

These examples show how to fill in the ISPF panels for SCS and 3270 input data streams.

Example 1. Converting SCS data streams to PCL data streams

This ISPF panel shows how to request that NetSpool convert the input data stream to PCL format.

                             NetSpool Options

 Printer definition name . myprinter         

 Formatting . . . . 3   1. None  2. Convert to line  3. Convert to PCL
    Record size . . _____
    RECFM . . . . . _   1. VB  2. VBA  3. VBM

·
·
·

This ISPF panel shows how to specify code pages and other formatting values.

                             Processing
 

·
·
·

 
Document code page . . ________________
Printer code page. . . ISO8859-1       
 

·
·
·

 SCS Conversion:
    Margins:  Top . . . 6     Bottom . . 61    Left . . 3     Right . . 75 
    Line length . . . . 80              Page length . . 66 
    Tabs:  Vertical . . ___  ___  ___  ___  ___  (extend)
           Horizontal . 5    10   15   20   ___  (extend)
 
 NetSpool PCL Conversion:
    Print density . . . 10 
    Line density. . . . 6  
    Orientation . . . . 1 1. None  2. Portrait  3. Landscape
    / SCS automatic page orientation
 

·
·
·

Example 2. Converting 3270 data streams to PCL data streams

These ISPF panels shows how to request that NetSpool convert input data streams to PCL data streams.

                             NetSpool Options

 Printer definition name . myprinter         

 Formatting . . . . 3   1. None  2. Convert to line  3. Convert to PCL
    Record size . . _____
    RECFM . . . . . _   1. VB  2. VBA  3. VBM

·
·
·

This ISPF panel shows how to specify code pages and other formatting values.

                             Processing
 

·
·
·

Document code page . . ________________
Printer code page. . . ISO8859-1       
 

·
·
·

 NetSpool PCL Conversion:
    Print density . . . 10 
    Line density. . . . 6  
    Orientation . . . . 2  1. None  2. Portrait  3. Landscape
 

·
·
·