Procedure for specifying attributes
You can either create a new printer definition for an email destination
or modify an existing printer definition for a printer.
Creating a new email printer definition
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.
- Use the Infoprint Server
ISPF panels to add a new printer definition. On the Choose a Definition
Type and Protocol panel, select IP PrintWay™ email.
_______________________________________________________
- 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, deselect 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 message: Specify an optional message
to include in the beginning of each email.
Each email address or alias name should be in this format:
username[@domainname]
- username
- The name of the recipient or the name of an alias defined to
sendmail.
- @domainname
- The domain name of the target system. If you omit @domainname, the domain name of the system on which
sendmail is running is used. If you specify an alias, omit @domainname.
_______________________________________________________
- On the Allocation panel, specify these fields:
_______________________________________________________
- On the Processing panel, specify these fields:
- Filter: (Optional) Specify any transforms
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:
Sendmail converts EBCDIC data from code page IBM-1047 to the ASCII code page configured
for sendmail.
Tips:
- The only EBCDIC code page you should specify is IBM-1047. This
is because sendmail can only convert data from code page IBM-1047
to an ASCII code page.
- 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.
- 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.
- 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.
_______________________________________________________
- 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.
_______________________________________________________
- On the IP PrintWay Options
panel:
- 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 specified for the data
set in the email header, in a job attribute, or in a JCL parameter.
Tips:
- IP PrintWay extended
mode: The Automatic dataset grouping field
provides the same function as the Concatenate job option.
- 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.
- 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.
_______________________________________________________
Modifying a printer definition
To modify a printer definition that currently represents a printer
to send data to an email destination instead:
- 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.
_______________________________________________________
- 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, deselect 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 message: Specify an optional message
to include in the beginning of each email.
Each email address or alias name should be in this format:
username[@domainname]
- username
- The name of the recipient or the name of an alias defined to
sendmail.
- @domainname
- The domain name of the target system. If you omit @domainname, the domain name of the system on which
sendmail is running is used. If you specify an alias, omit @domainname.
_______________________________________________________
- 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 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.
_______________________________________________________
- On the Processing panel, specify these fields:
_______________________________________________________
- 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.
_______________________________________________________
- On the IP PrintWay Options
panel:
- 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 specified for the data
set in the email header, in a job attribute, or in a JCL parameter.
Tips:
- IP PrintWay extended
mode: The Automatic dataset grouping field
provides the same function as the Concatenate job option.
- 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.
- Blank out any values specified in the Retry time and Retry limit fields. Retries are not suggested for
the email protocol. For more information about these fields, see Handling unsuccessful data transmissions.
- Blank out any values specified in the Document
header and Document trailer fields. Printer
commands might be displayed as unrecognizable text when the email
attachment is viewed.
_______________________________________________________
Testing the printer definition
To verify that you have typed the email addresses correctly in
the printer definition and in the sendmail alias file, submit a job
from the local system with the lp command. For
example, if your printer definition is named deptmail,
enter this command on the z/OS UNIX command
line:
lp -d deptmail myfile
Results:
- IP PrintWay writes a
message to indicate that sendmail successfully accepted the email
request. Sendmail verifies that alias names and recipient names for
users on the local system are correctly specified. However, an error
might occur later when sendmail attempts to send an email to a remote
system.
- If emails were sent successfully to the remote systems, you should
receive no sendmail error messages. To check for sendmail error messages:
- If you specified an owner for a sendmail alias name, see if any
mail is returned to the owner's user ID.
- See if any mail is returned to the user associated with the IP PrintWay startup procedure.
Sendmail returns error messages to this user ID if no other owner
is specified for a sendmail alias name or if the email address is
specified directly in the printer definition. This user ID is AOPSTC
if your installation used the user ID that is suggested in z/OS Infoprint Server Customization.
To check for mail, run the z/OS UNIX mail or mailx command. For
more information about this command, see z/OS UNIX System Services Command Reference.
You
might need to wait several days before sendmail returns a message
to you when it cannot send an email to a remote system. How long you
need to wait depends in part on how long it takes the remote system
to notify sendmail that an email is undeliverable and in part on how
your installation has customized sendmail. For more information about
customizing sendmail timeout values, see z/OS Infoprint Server Customization.
Example
These ISPF panels show how to create a printer definition named deptmail,
select the email protocol, and fill in fields that are specific to
the email protocol.
Tip:
This example
shows only some of the ISPF panels and fields that comprise a printer
definition. For a complete printer definition that is suitable for
the email protocol, see Sample IP PrintWay printer
definitions.
Use the Add function of the Infoprint Server ISPF panels to create a printer
definition. On the Choose a Definition Type and Protocol panel, select
the email protocol:
Choose a Definition Type and Protocol
Option ===> 5
Type Protocol
1 IP PrintWay LPR
2 IP PrintWay direct sockets
3 IP PrintWay IPP
4 IP PrintWay VTAM
5 IP PrintWay email
6 PSF
7 General
To display this Email Protocol panel, press Enter on the Custom values field for the Protocol section on
the main panel for the printer definition:
Email Protocol
Printer definition name . deptmail
To addresses
. . toname@xyz.com,dept123,dept456 (more)
CC addresses
. . copyname@xyz.com (more)
BCC addresses
. . _______________________________________________________________ (more)
From name . . . John Q. Sender
Reply address . johnsender@xyz.com
IP PrintWay extended mode
_ Embedded headers
Inline text and line data
Inline message . Greetings:<LF><LF>The sales report is attached.<LF> (extend)
Results:
- Emails are sent to: toname@xyz.com and the addresses
represented by aliases dept123 and dept456.
- A copy of the email is sent to: copyname@xyz.com.
- The email includes this description of the sender: John Q.
Sender.
- Most email programs that recipients use send replies back to this
address: johnsender@xyz.com.
- All documents are sent as attachments.
- The text in the Inline message field is
included in the beginning of each email.
To display this Allocation panel, press Enter on the Custom
values field for the Allocation section on the main panel for
the printer definition:
Allocation
Printer definition name . deptmail
·
·
·
Values for Separator Pages:
Address . . _____________________________________________________ (extend)
Building . . _____________________________________________________
Department . _____________________________________________________
Name . . . . _____________________________________________________
Room . . . . _____________________________________________________
Title . . . Annual Report for XYZ Corporation
·
·
·
Result: For data sets that IP PrintWay extended mode, NetSpool,
or Print Interface processes, the email subject is Annual Report
for XYZ Corporation unless the job submitter specifies another
title.
To display this IP PrintWay Options
panel, press Enter on the Custom values field
for the IP PrintWay Options
section on the main panel for the printer definition:
IP PrintWay Options
Printer definition name . deptmail
·
·
·
/ Automatic dataset grouping (extended mode)
Dataset grouping. . . . 3 1. None 2. Job 3. Concatenate job
·
·
·
Result: IP PrintWay sends
all data sets in the same JES output group in the same email.
|
z/OS Infoprint Server Operation and Administration
Copyright IBM Corporation 1990, 2014