TAA Tools
SNDSPLPDF       SEND SPOOLED FILE AS A PDF             TAAIFUI

The Send Spooled File as a PDF command sends a normal spooled file as
a PDF to one or more users.  This allows the end user to view the
information with a technique that he may be more familiar with.

A typical command would be:

    SNDSPLPDF  FILE(xxx) SUBJECT(sss) TEXT('ttttt')

Because the default is SENDTO(*SELECT), a prompt will appear for the
users defined to the MAILADR tool.  You may select one or more users.
An option exists to allow a specific E-Mail address to be used.

SNDSPLPDF uses CPYSPLFIFS and then SNDIFSMAIL internally.  SNDIFSMAIL
uses the system command SNDDST to send the mail.  The spooled file is
converted to the IFS as a stream file and placed in the sub-directory
'/taawrk' which is created if it does not already exist in the system
supplied '/tmp' directory.  The stream file is removed if SNDSPLPDF
completes normally.

To use SNDSPLPDF, you must have both 5770-TS1 option 1 (IBM Transform
Services - AFP to PDF) and 5770-SS1 option 33 (PASE) installed.  You
can check these options with:

    CHKPRDOPT PRDID(5770SS1) OPTION(33)
    CHKPRDOPT PRDID(5770TS1) OPTION(1)

Troubleshooting
---------------

If the SNDSPLPDF command fails, there should be appropriate messages
from the tool describing the error.

A typical error is when the Email has the correct syntax, but the
domain does not exist.  You can check all the addresses in the
MAILADRP file with:

    CHKMAILFLD FILE(MAILADRP) FIELD(MAINTA)

If the SNDSPLPDF command completes normally, but no E-Mail message
arrives at the destination, try SNDDST by itself Enter the following
command:

    SNDDST TYPE(*LMSG)
      TOINTNET('xxxx')
      DSTD('A test message')
      LONGMSG('This is a test')

where xxxx is a valid E-Mail address.

If no E-Mail message is sent, the problem exists with the system.

The system mail server jobs must be active.  Try ending the mail
server jobs with ENDMSF and then restarting with STRMSF.  Even though
the STRMSF command may complete normally, there could be messages in
QSYSOPR relating to the problems of an MSF job.

SNDSPLPDF escape messages you can monitor for
---------------------------------------------

None.  Escape messages from based on functions will be re-sent.

SNDSPLPDF Command parameters                          *CMD
----------------------------

   FILE          The name of the spooled file to be sent.

   SUBJECT       The subject matter may be up to 44 characters in
                 length.  At least one character must be entered.

   JOB           The qualified job name of the job with the spooled
                 file.  The default is * meaning the current job.

   SPLNBR        The file number of the spooled file.  This defaults
                 to *ONLY.  *LAST or a specific number may be
                 specified.

   SENDTO        The SENDTO parameter allows:

                     - Sending to a name in the MAILADRP file
                     - Selection from the MAILADRP file
                     - Sending to an E-Mail using the INTADR parm

                 *SELECT is the default which invokes the SELMAILADR
                 command.  This provides a subfile of all names
                 entered into the MAILADRP file (entered by
                 WRKMAILADR).  After selecting the names to be sent
                 to using the '1' Option and pressing Enter, the
                 screen is refreshed to allow more users to be
                 entered.

                 An 'X' is displayed in the option column for any
                 selected entries.  You may cancel a previous
                 selection by entering a blank.

                 When all names to send to have been selected, F3
                 should be used to return to the SNDIFSMAIL prompt.
                 The names of the selected users are used to fill the
                 SENDTO parameter.

                 A group name may also be entered (see the discussion
                 of 'Group names' in the MAILADR tool
                 documentation).'

                 When *SELECT is used, the recipient type defaults to
                 *TO for primary recipient to send to.  This value
                 may be changed at the top of the selection display
                 to *CC (carbon copy), or *BCC (blind carbon copy).
                 Each time the Enter key is pressed, the value for
                 recipient type will be used for those selected
                 users.

                 Instead of the default of *SELECT, you may enter a
                 user name into the first part of the SENDTO
                 parameter.  The name must exist in the MAILADRP file
                 (note that the E-Mail address is not entered into
                 the SENDTO parameter).

                 The second part describes the recipient type.  *TO
                 is the default meaning the user is the primary
                 recipient.

                 *CC may be entered meaning the recipient receives a
                 copy, but is not the primary recipient.

                 *BCC may be entered meaning the recipient receives a
                 blind copy and is not identified in the distribution
                 list.

                 Up to 50 names may be entered.

                 An E-Mail address may be entered on SNDIFSMAIL by
                 using SENDTO(*INT) and then entering the E-Mail
                 address in the INTADR parameter.

   TEXT          The text of the message which may be up to 256
                 bytes.  No special characters may be entered to help
                 format the text.

   INTADR        If SENDTO(*INT) is entered, a list of up to 50
                 internet addresses may be entered.

                 A two part parameter is required.

                 The first part is the E-Mail address (up to 90
                 bytes).

                 The second part describes the recipient type.  *TO
                 is the default meaning the user is the primary
                 recipient.

                 *CC may be entered meaning the recipient receives a
                 copy, but is not the primary recipient.

                 *BCC may be entered meaning the recipient receives a
                 blind copy and is not identified in the distribution
                 list.

   MAILADRLIB    The name of the library where the Mail Address files
                 exist.  *LIBL is the default.  A specific library or
                 *CURLIB may also be entered.

   TEST          A *YES/*NO option for whether testing is occurring.

                 *NO is the default meaning an E-Mail will be sent.

                 *YES may be specified to cause the SNDDST command
                 that will be used to be logged as a message, but not
                 run.


Restrictions
------------

The Mail Servers must be active (see the STRMSF command).

Prerequisites
-------------

The following TAA Tools must be on your system:

     CHKIFSE         Check IFS entry
     CPYSPLFIFS      Copy spooled file IFS
     RSNLSTMSG       Resend last message
     NBRCTR          Number counter
     RTVVALA         Retrieve value attributes
     SNDIFSMAIL      Send IFS mail
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message
     SNDSPLMAIL      Send spooled file mail

Implementation
--------------

If you do not enter a specific E-Mail address, the SendTo information
must be set up using the MAILADR tool.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   SNDSPLPDF     *CMD                   TAAIFUI       QATTCMD
   TAAIFUIC      *PGM       CLP         TAAIFUIC      QATTCL
					

Added to TAA Productivity tools April 15, 2012


Home Page Up to Top