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.

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