Creating FSS definitions (basic mode)

In an IP PrintWay™ FSS definition, you can specify configuration information that applies to an IP PrintWay FSS and to all FSAs in that FSS. An IP PrintWay FSS definition is required in these situations:
  • If any of the FSAs in the FSS transmit output to VTAM controlled printers. In this case, you must specify the name of the VTAM® APPL statement you defined for the FSS.
  • If you need to change the IP PrintWay configuration defaults. If an IP PrintWay FSS definition does not exist when IP PrintWay starts, IP PrintWay uses default values.

Table 1 shows the fields that you can specify in an FSS definition. The table lists the field names on the ISPF panel, describes each field, and indicates the default value that IP PrintWay uses if you do not create an FSS definition or if you leave a field blank.

Table 1. IP PrintWay FSS definition
ISPF field name Description Default
Applid The application program ID that IP PrintWay uses to establish a VTAM session with printers. This ID must match the name of the APPL statement that is defined to VTAM.
Note: Specify this field only after you installed Infoprint Coaxial Printer Support for z/OS®. Otherwise, IP PrintWay ends abnormally.
No default. This field is required to use the IP PrintWay VTAM protocol.
Description A description of the FSS definition, for information purposes only. No default.
Document code page The default EBCDIC code page that is used as the document code page when IP PrintWay translates data from EBCDIC to ASCII. You can specify the name of an IBM-supplied or custom ASCII code page that is supported by the z/OS iconv utility. For the names of IBM supplied code page names, see z/OS XL C/C++ Programming Guide.

Infoprint Server converts data from the document code page to the printer code page and the code page for the z/OS locale to the document code page. Therefore, if you specify a custom code page, make sure that conversion tables exist to let Infoprint Server convert between code pages. For information about how to create conversion tables, see information about code set conversion utilities in z/OS XL C/C++ Programming Guide.

Code page IBM-1047.
FSS name The name of the FSS.
If the IP PrintWay startup procedure does not contain a JOB JCL statement, specify either:
  • In JES2, the name of the JES FSS initialization statement
  • In JES3, the name of the JES FSSDEF initialization statement

If the IP PrintWay startup procedure contains a JOB JCL statement, specify either:

  1. The name of the EXEC JCL statement (step name) in the IP PrintWay startup procedure (default name is IEFPROC)
  2. If no step name is specified, the name of the PROC JCL statement in the IP PrintWay startup procedure (default is ANFWPROC)
No default. This field is required.
Hiperspace blocks The maximum number of 4 KB blocks that each FSA can use in hiperspace. The number that you specify can affect system performance and also can limit the size of the data sets the FSA can process. The maximum amount of hiperspace available is 2 GB.

You might need to increase this value to process large data sets. IP PrintWay always writes data sets to hiperspace when it uses the LPR transmission protocol. It also writes data sets to hiperspace when it uses the IPP, direct-sockets, or email transmission protocol and either the Maximum document size or Delete form feed option is selected in the printer definition. IP PrintWay does not write data sets to hiperspace when it transmits data to VTAM controlled printers.

8,000 (32 MB).

National language The language IP PrintWay uses for messages. You can select either English or Japanese. English messages.
Old style translation An indicator of how IP PrintWay converts data from EBCDIC to ASCII when a printer definition does not specify the code pages or translate table to use. That is, the printer definition does not specify either a document or a printer code page, a customized TCP/IP translate table, or a DBCS translate table.
  • If this field is selected, IP PrintWay uses the standard TCP/IP translate table to convert data from EBCDIC to ASCII.
  • If this field is not selected, IP PrintWay uses code pages to convert data from EBCDIC to ASCII. The EBCDIC code page is the code page that is specified in the Document code page field of the IP PrintWay FSS definition in the Printer Inventory. The ASCII code page is IBM-850.

This field is ignored when IP PrintWay prints on VTAM controlled printers or to email destinations. 1

See the "Description" column.
TCP/IP job name The name of the TCP/IP startup procedure. The default TCP/IP name is used.
Trace mode The type of IP PrintWay tracing for the FSS, and the default tracing mode for all FSAs. Tracing starts when the FSS and FSAs starts. The trace mode that is specified in an FSA definition overrides this trace mode. No tracing is done.
Trace prompt An indicator of whether the operator is prompted each time the FSS starts. If this option is selected, message ANFM020A is sent to the operator. No prompting is done.
Trace table size The number of 4 KB pages of storage (above the 16 MB line) to allocate for each internal FSA trace table. 32 (128 KB).
  1. When you are printing to VTAM controlled printers or to email destinations, if the printer definition does not specify code pages or a customized TCP/IP translate table, IP PrintWay does not convert data between code pages.
This ISPF panel shows a sample IP PrintWay FSS definition:
                                 IP PrintWay FSS
 
 FSS name. . . PRINTWAY
 Description . My IP PrintWay FSS (extend)
 
     Old-style translation
   Hiperspace blocks . . 8000 
   TCP/IP job name . . . MYTCPIP 
   Document code page. . IBM-850        
   Applid. . . . . . . . PWAPPL01
   National language . . 1   1. English 2. Japanese
   Trace mode. . . . . . 2   1. None  2. Internal  3. No printing  4. Full
      _ Trace prompt
      Trace table size . ___
 
 
Note: If you create an FSS definition after the FSS started or if you change any information in the FSS definition, you must restart the IP PrintWay FSS so that your changes take effect.