Procedure for specifying email protocol attributes

Do these steps to create a new printer definition for an email destination. These steps describe fields that have special considerations for the email protocol. You might also need to specify other fields in the printer definition to use all the functions that Infoprint Server provides.

1. Use the Infoprint Server ISPF panels to add a printer definition. On the Choose a Definition Type and Protocol panel, select IP PrintWay email.
2. On the Email Protocol panel, specify the To addresses field and any of these other fields:

   To addresses

   The email addresses or alias names of the recipients of the email. You can specify 1 - 32 email addresses (to add more entries, put your cursor on more and press Enter). Each email address can be 1 - 60 characters. An address that the job submitter specifies overrides this value.

   CC addresses

   The email addresses or alias names of the “copy (cc)” recipients of the email. A cc means that other recipients of the email can see the cc recipient listed. You can specify 1 - 32 email addresses (to add more entries, put your cursor on more and press Enter). Each email address can be 1 - 60 characters. An address that the job submitter specifies overrides this value.

   BCC addresses

   The email addresses or alias names of the “blind copy (bcc)” recipients of the email. A bcc means that other recipients of the email do not see the bcc recipient listed. You can specify 1 - 32 email addresses (to add more entries, put your cursor on more and press Enter). Each email address can be 1 - 60 characters. An address that the job submitter specifies overrides this value.

   From name

   The descriptive name or other identifier of the sender of the email. You can specify one name. It can be 1 - 60 characters, including blanks. IP PrintWay always includes userid@domainname to identify the sender. The user ID of the job submitter is userid. The domain name where Infoprint Server is running is domainname. For example: JOHN@SYSTEM1.

   Reply address

   The email address or alias name that recipients of the email can reply to. You can specify one email address. It can be 1 - 60 characters. An address that the job submitter specifies overrides this value. If you do not specify this field, most email programs use the sender's email address, which is userid@domainname. The user ID of the job submitter is userid. The domain name where Infoprint Server is running is domainname.

   Embedded headers

   If any line-data documents contain email headers, select the Embedded headers field. When this field is selected, IP PrintWay looks for an email header in each document with line-data format. If a header is found, IP PrintWay sends the email to the recipients specified in the header. If no line-data documents contain email headers, clear this field for improved performance.

   Inline text and line data

   Select this field if you want to include text data and line-data inline in the body of the email instead of in attachments.

   Inline text attribute

   Specify an optional text job attribute that you want to include inline as a text string value at the beginning of each email before an inline message. The text job attributes are:

   • building-text
   • department-text
   • name-text
   • room-text
   • title-text

   The text string value that is defined for the text job attribute is included in the email on the line before an inline message. For example, if name-text="Bob Sill", then Bob Sill is included on the first line in the email.

   Inline message

   Specify an optional message to include in the beginning of each email on the line after the optional Inline text attribute text string.

   Each email address or alias name must be in this format:

   username[@domainname]

   username

   The name of the recipient or the name of an alias that is defined to the sendmail bridge.

   @domainname

   The domain name of the target system. If you specify an alias, omit @domainname.

3. On the Allocation panel, specify these fields:

   Spool allocation values

   Specify either the job-selection values that are specified in the IP PrintWay job selection rule (extended mode) or the work-selection values specified in the JES FSA definition (basic mode). For example, if the job-selection value for IP PrintWay is class E, specify E in the CLASS field.

   Title

   (Optional) Specify a default subject for the email. You can specify up to 60 characters, including blanks and any other printable characters. A job submitter can override this value.

   If you run IP PrintWay basic mode, this field applies only to documents that NetSpool or Print Interface processes.

4. On the Processing panel, specify these fields:

   Filter

   (Optional) Specify any transforms that you want to use. For example, you might want to specify the AFP to PDF transform for the Line data and MO:DCA-P data formats to create PDF documents. If you run IP PrintWay basic mode and specify a transform, also select the Resubmit for filtering option.

   Printer code page

   Specify one of these code pages:

   • Any ASCII code page: IP PrintWay converts EBCDIC data from the document code page (default is IBM®-1047) to the specified ASCII code page.
   • EBCDIC code page IBM-1047: The sendmail bridge converts EBCDIC data from code page IBM-1047 to the ASCII code page.

   Tips:

   1. The only EBCDIC code page that you can specify is IBM-1047 because the sendmail bridge can convert data only from code page IBM-1047 to an ASCII code page.
   2. If the code page for the locale on the z/OS® system where Infoprint Server is running is not IBM-1047, specify an ASCII code page instead of an EBCDIC code page.
   3. Specify a code page that the iconv utility supports, or specify a custom ASCII code page. For code page names that iconv supports, 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 the custom code page and these code pages:
      • The code page in the Document code page field
      • The code page for the z/OS locale
      For information about how to create conversion tables, see information about code set conversion utilities in z/OS XL C/C++ Programming Guide.

5. On the NetSpool Options panel, if your installation prints from VTAM® applications such as CICS® and IMS, select the Convert to line formatting option. NetSpool can transform line data to PDF data if you specify the AFP to PDF transform on the Processing panel. Or, IP PrintWay can convert the line data to text data. Both PDF and text data can be viewed in an email attachment. Do not select the Convert to PCL formatting option because PCL data cannot be easily viewed.
6. On the IP PrintWay Options panel:
   1. Select how you want IP PrintWay to handle data sets that are in the same JES output group. Select one of these values in the Dataset grouping field:

      Concatenate job

      All data sets are sent in the same email to the address specified for the first data set in the output group.

      None or Job

      Each data set is sent in a separate email. IP PrintWay extended mode sends each email to the address specified for the first data set in the output group unless the AOP_MAIL_USE_FIRST_ADDRESS =NO environment variable or the mail-use-first-address=no attribute is set. If AOP_MAIL_USE_FIRST_ADDRESS=NO or mail-use-first-address=no, IP PrintWay extended mode sends each email to the address or addresses that are specified for the data set in the email header, in a job attribute, or in a JCL parameter.

      Tips:

      1. In IP PrintWay extended mode, the Automatic dataset grouping field provides the same function as the Concatenate job option.
      2. These fields apply only for data sets that JES assigns to the same output group. For example, when Print Interface and NetSpool allocate data sets on the JES spool, JES assigns each data set to a separate output group. For more information, see Transmitting multiple data sets in a JES output group.
   2. Leave the Retry time and Retry limit fields blank. Retries are not suggested for the email protocol. For more information about these fields, see Handling unsuccessful data transmissions.

To modify a printer definition that currently represents a printer to send data to an email destination instead:

1. Use the Infoprint Server ISPF panels to list the printer definition you want to modify. On the List Printer Definition panel, use the X function. On the Choose a Definition Type and Protocol panel, select IP PrintWay email.
2. On the Email Protocol panel, specify the To addresses field and any of these other fields:

   To addresses

   The email addresses or alias names of the recipients of the email. You can specify 1 - 32 email addresses (to add more entries, put your cursor on more and press Enter). Each email address can be 1 - 60 characters. An address that the job submitter specifies overrides this value.

   CC addresses

   The email addresses or alias names of the copy (cc) recipients of the email. A cc means that other recipients of the email can see the cc recipient listed. You can specify 1 - 32 email addresses (to add more entries, put your cursor on more and press Enter). Each email address can be 1 - 60 characters. An address that the job submitter specifies overrides this value.

   BCC addresses

   The email addresses or alias names of the blind copy (bcc) recipients of the email. A bcc means that other recipients of the email do not see the bcc recipient listed. You can specify 1 - 32 email addresses (to add more entries, put your cursor on more and press Enter). Each email address can be 1 - 60 characters. An address that the job submitter specifies overrides this value.

   From name

   The descriptive name or other identifier of the sender of the email. You can specify one name. It can be 1 - 60 characters, including blanks. IP PrintWay always includes userid@domainname to identify the sender. The user ID of the job submitter is userid. The domain name where Infoprint Server is running is domainname. For example: JOHN@SYSTEM1.

   Reply address

   The email address or alias name that recipients of the email can reply to. You can specify one email address. It can be 1 - 60 characters. An address that the job submitter specifies overrides this value. If you do not specify this field, most email programs use the sender's email address, which is userid@domainname. The user ID of the job submitter is userid. The domain name where Infoprint Server is running is domainname.

   Embedded headers

   If any line-data documents contain email headers, select the Embedded headers field. When this field is selected, IP PrintWay looks for an email header in each document with line-data format. If a header is found, IP PrintWay sends the email to the recipients specified in the header. If no line-data documents contain email headers, clear this field for improved performance.

   Inline text and line data

   Select this field if you want to include text documents and line-data documents inline in the body of the email instead of in attachments.

   Inline text attribute

   Specify an optional text job attribute that you want to include inline as a text string value at the beginning of each email. The text job attributes are:

   • building-text
   • department-text
   • name-text
   • room-text
   • title-text

   The text string value for the text job attribute is included in the email on the line before an inline message. For example, if name-text="Bob Sill", then Bob Sill is included on the first line in the email.

   Inline message

   Specify an optional message to include in the beginning of each email, but on the line after the optional Inline text attribute text string.

   Each email address or alias name must be in this format:

   username[@domainname]

   username

   The name of the recipient or the name of an alias that is defined to the sendmail bridge.

   @domainname

   The domain name of the target system. If you specify an alias, omit @domainname.

3. On the Allocation panel, specify these fields:

   Spool allocation values

   Change these fields to specify either the job-selection values that are specified in the IP PrintWay job selection rule (extended mode) or the work-selection values specified in the JES FSA definition (basic mode). For example, if the job-selection value for IP PrintWay is class E, specify E in the CLASS field. If the printer definition currently represents an IP PrintWay controlled printer, no changes are required.

   Title

   (Optional) Specify a default subject for the email. You can specify up to 60 characters, including blanks and any other printable characters. A title that is specified by the job submitter overrides this value. If you run IP PrintWay basic mode, this field applies only to documents that NetSpool or Print Interface processes.

4. On the Processing panel, specify these fields:

   Printer code page

   Specify an ASCII code page or EBCDIC code page IBM-1047.

   Print page header

   Clear this field if you do not want a page header on each page of the email attachment.

   PostScript header

   Remove any selected options so that IP PrintWay does not attempt to add a PostScript header.

   Filter

   (Optional) Specify transforms. For example, you might want to specify the AFP to PDF transform for the Line data and MO:DCA-P data formats to create PDF documents. If you run IP PrintWay basic mode and specify a transform, also select the Resubmit for filtering option.

   Remove filter lpd_compat.so if it is specified for the Text data format.

5. On the NetSpool Options panel, if your installation prints from VTAM applications such as CICS and IMS, select the Convert to line formatting option. NetSpool can transform line data to PDF data if you specify the AFP to PDF transform on the Processing panel. Or, IP PrintWay can convert the line data to text data. Both PDF and text data can be viewed in an email attachment. Do not select the Convert to PCL formatting option because PCL data cannot be easily viewed.
6. On the IP PrintWay Options panel:
   1. Select how you want IP PrintWay to handle data sets that are in the same JES output group. Select one of these values in the Dataset grouping field:

      Concatenate job

      Each data is sent in the same email to the address specified for the first data set in the output group.

      None or Job

      Each data set is sent in a separate email. IP PrintWay extended mode sends each email to the address specified for the first data set in the output group unless the AOP_MAIL_USE_FIRST_ADDRESS =NO environment variable or the mail-use-first-address=no attribute is set. If AOP_MAIL_USE_FIRST_ADDRESS=NO or mail-use-first-address=no, IP PrintWay extended mode sends each email to the address or addresses that are specified for the data set in the email header, in a job attribute, or in a JCL parameter.

      Tips:

      1. In IP PrintWay extended mode, the Automatic dataset grouping field provides the same function as the Concatenate job option.
      2. These fields apply only for data sets that JES assigns to the same output group. For example, when Print Interface and NetSpool allocate data sets on the JES spool, JES assigns each data set to a separate output group. For more information, see Transmitting multiple data sets in a JES output group.
   2. Blank out any values that are specified in the Retry time and Retry limit fields. Retransmissions are not suggested for the email protocol. For more information about these fields, see Handling unsuccessful data transmissions.
   3. Blank out any values that are specified in the Document header and Document trailer fields. Printer commands might be displayed as unrecognizable text when the email attachment is viewed.