Inconsistent tk etkt names during execution

CL commands and utilities from directspool / directmail / pdfenhancer

Contents overview

WRKEML work with emails

The WRKEML command can be used to work with the e-mails in a mailbox.


0321 - Working with directmail emails


Mailbox (MAILBOX) - Enter the mailbox.

Valid values ​​are:

Character value Enter mailbox name
*CURRENT The currently valid mailbox is selected (default)

CHGDMLLNG - Change the language settings of the IBM i displays

The CHGDMLLNG command can be used to change the language settings of the IBM i.


0305 - change language


New directmail language (NEWLANG) - Language to be used

Valid values ​​are:

OF German (Switzerland)
DEU German
CLOSELY English
FRA French
ITA Italian
FRS French (Switzerland)

SNDSPLEML - Send spooled file via email

If the name of the spooled file is known, it can be sent with the IBM i command SNDSPLEML.


0287 - Send spooled file via email Image 1

Spool file (FILE) - The name of the spooled file to be attached.

Valid values:

Surname - Name of the spooled file
* NONE - No spooled file is sent, but an email without an attachment (New from version 5.50, PTF 12)

If the parameter FILE (* NONE) is specified, the parameters JOB, SPNBR and DLTSPLF are ignored.

Job name, user, number (JOB) - The job information of the spooled file (can be viewed using the IBM i command WRKSPLF).

Spool file number (SPLNBR) - The current spool number of the job.

Delete spool file (DLTSPLF) - Here you determine whether the spool file should be deleted after it has been sent.

Valid values ​​are:

*YES The spooled file is deleted after it is attached to the email
*NO The spooled file is not deleted.

Output format (FORMAT) - Specify the format to which the spooled file should be converted: PDF, HTML, text file, etc.

The values ​​for this parameter are described in the CVTSPLF command.

Page range from-to (PAGERANGE) - Here you can select from which side and up to which side the spool file should be attached.

Valid values ​​are:

Page number
*LOADAppend to the last page number
*END Append to the last page number.

CSV column separation (CVSTAB) - Here you control the column separation.

Valid values ​​are:

1-200 Number of columns
*NONE no column separation

Call editor (EDIT) - Here you can control whether the editor should be called to supplement the e-mail with the subject, text and other information.

Valid values ​​are:

*YES The editor is started after it has been attached to the email
*NO The editor does not start


0288 - Send spool file via email Illus. 2

Mailbox (MAILBOX) - The name of the mailbox via which this spooled file is to be sent. *CURRENT specifies the current mailbox of the user

Sender name (SENDER) - Enter the name of the sender or the special value * MAILBOX here in order to use the user data from the assigned mailbox.

Surname - You can enter any name here
Sender email address - Enter the sender's e-mail address or the special value * MAILBOX to use the user data from the mailbox assigned to the user.

Receiver (RCVR) - Enter the recipient's email address here.

Max. 80 digits

With *SELECT the address book is displayed for selecting an address.

Subject (SUBJECT) - This is the subject of the email.

Message text (TEXT) - Here you can send a message text with the e-mail.


0289 - Send spool file via email Illus. 3

Time for sending (SCDTIME) - If an e-mail is to be sent time-controlled, you can enter the date and time here. Otherwise the email will be sent immediately.

Date for dispatch (SCDDATE) - If an e-mail is to be sent time-controlled, you can enter the date and time here. Otherwise the email will be sent immediately.

Use text only (TEXTONLY) - Here you control that only the pure text without graphics and other elements is used for spooled files.

Green bars (GREENBAR) - for HTML format - Specify whether the lines in HTML format should be separated by white / green bars (gives the same effect as printing on tabulating paper).

Page table (PAGETABLE) - Insert table of contents

If a multi-page document is created, then "J" causes

- a page table is generated at the beginning of HTML output
- A bookmark is created for each page in PDF output

Valid values ​​are:

J A page table is inserted (for PDF: a bookmark is created for each page)
N No page table is inserted (for PDF: no bookmarks are created)

Paper size (PAPERSIZE) - Specifies the paper size for creating the PDF file. This parameter is available only with FORMAT (* EPDF) to disposal.

Valid values ​​are:

A0 to A6 DIN formats
B5 DIN format
LEDGER, LEGAL, LETTER, P11X17 Various other formats

Landscape format (ROTATION) - Specifies whether the form should be written in landscape format. This parameter is only available for the * EPDF format.

Valid values ​​are:

*SPLF The value for the page rotation of the spooled file is used
*YES The form is used in landscape format
*NO The form is not used in landscape format
*AUTOMOBILE The form is automatically rotated so that the margins are not exceeded.

CPI (CPI) - Here you can specify a font width in CPI (characters per inch) that differs from the spooled file.

Valid values ​​are

number A valid CPI specification (e.g. 5,8,10,12,15,16,7 ...)
0 The CPI value of the spooled file is used.

LPI (LPI) - Here you can specify a font height in LPI (lines per inch) that differs from the spooled file.

Valid values ​​are

number A valid LPI specification (e.g. 5,8,10,12,15,16,7 ...)
0 The LPI value of the spooled file is used.

PDF font (FONT) - In the case of Unicode conversions, the specification of the PDF font plays a decisive role in converting the characters.

CCISD code page (CCSID) - With the Unicode conversion, the CCSID controls the correct display of the characters in PDF format.

Create PDF / A - When specifying, you can set the compatibility with PDF / A standards here.

Valid values ​​are:

* NO It is not converted to any PDF / A format
* V1A2005 Sets the PDF / A compatibility level to PDF / A-1a: 2005. Tagged PDF mode is activated automatically
* V1B2005 Sets the PDF / A compatibility level to PDF / A-1a: 2005

If in the parameter FORMAT (* GUMBO) was specified, then you create a PDF / A format with the parameter (2x "A")

Text origin coordinates (PDFAREA) - X axis mm

This allows you to move the original text of the spooled file by the specified millimeters to the right, or to the left with a negative entry (e.g. -10).

X axis mm - You can use this to move the original text of the spooled file by the specified millimeters to the right, or to the left if the entry is negative

Scale X - Here you specify the scaling factor with which the original spool text should be scaled.

Valid values ​​are:

number - A percentage of the original size (e.g. 90 = 90%, 120 = 120%)
*NO - Don't scale
*YES / * FIT - Scaling to the page size - prevents spooled text from being moved over the edge of the page

Y-axis mm - This allows you to move the original text of the spooled file down by the specified millimeters, or up if the entry is negative

Scale Y - Here you specify the scaling factor with which the original spool text should be scaled.

Valid values ​​are:

number - A percentage of the original size (e.g. 90 = 90%, 120 = 120%)

*NO - Don't scale

*YES / * FIT - Scaling to the page size - prevents spooled text from being shifted over the edge of the page

Form first page (OVERLAY) - Enter the name of the form to be added to the PDF file here. This file must be stored in the FORMS directory of DirectMail400. This parameter is only possible when using the * EPDF format.

Position form (MARGINS) - Enter the margins here with which the graphic should be aligned as required.

Form following pages (OVERLAY2) - Enter the form for the following pages here.

Valid values ​​are:

* FIRSTPAGESubsequent pages like the first page
* NONE no form

Position form (MARGINS2) - Enter here the margins with which the form should be aligned.

PDF security settings (PDFSEC) - Here you specify the settings for PDF files sent in encrypted form: permission to print, change, copy, etc.

The parameters are described in detail under the CRTSECPDF command.

CCSID of the parameters (PARAMCCSID) - Here you enter the settings for PDF files sent in encrypted form. This value can be used to specify the CCSID in which the parameters are transferred to the command.

Valid values ​​are:

number CCSID table
*CURRENT CCSID of the current job (default value)

The parameters for e-mail addresses, names, subject and text are then automatically translated into the CCSID of the server jobs.

Alias ​​filename (ALIAS) - Here you can enter an alias file size.

editor

If the parameter "Call up editor" (EDIT) was set to * YES, the editor now opens for entering further information:


0292 - Display of the editor

APIs for sending emails

With the CL commands OPNEMLAPI, WRTEMLAPI and CLSEMLAPI you can "assemble" and send emails. You can add to the content of such mails

  • text
  • Print files (SPLF)
  • IBM i backup files (SAVF)
  • IFS objects

The description of the API commands can be found on the page E-Mail APIs - Automatically create and send e-mails

SNDOBJEML - Send an object via email

The command SNDOBJEML is part of the license group Batch and Spool APIs, but can also be licensed separately instead of the Batch and Spool APIs at a lower price (code OBJ).

As an alternative to the batch and spool APIs, which have many options, there is a simplified form of sending IFS objects (PC files such as PDF) that already exist. There is no conversion here. The parameters are based on the SNDSPLEML command, except that all information for the conversion of spool files has been omitted here.

Send sndobjeml1 – IFS file via email Fig. 1

IFS object (OBJ) - Path including file where the existing PC file (e.g. PDF) is located in the IFS. The length of the input field is limited to 100 places.

Example:

Delete IFS file (DELETE) - Here you determine whether the IFS file should be deleted after the e-mail has been created. Usually the file persists because it was created by a foreign process.

Valid values ​​are:

*YES The file is deleted after it is attached to the email
*NO The file is not deleted. (Default value)

Call editor (EDIT) - Here you can control whether the editor should be called to supplement the e-mail with the subject, text and other information.

Valid values ​​are:

*YES The editor is started after attaching it to the e-mail
*NO The editor does not start


Mailbox (MAILBOX) - The name of the mailbox via which this spooled file is to be sent. *CURRENT specifies the current mailbox of the user. But this only works if each user has their own mailbox. If there is only one central mailbox, the name (without asterisk) must be entered here.

Sender name (SENDER) - Enter the name of the sender or the special value * MAILBOX to use the user data from the assigned mailbox.

Sender email address - Enter the sender's e-mail address or the special value * MAILBOX here in order to use the user data from the assigned mailbox.

Receiver (RCVR) - Enter the recipient's email address here. With *SELECTdetermine that the address will later be selected from an address book or typed in directly by the user (see Editor below).

Subject (SUBJECT) - The subject of the email is here. It can be 256 characters long.

Message text (TEXT) - Here you can send a message text with the e-mail (mail body). Theoretically, 120 lines with 78 characters each are allowed. If the command call is a batch process, the size of the buffer must be selected accordingly (the TEXT area alone requires 9362 bytes).

Time for sending (SCDTIME) - If an e-mail is to be sent time-controlled, you can enter the date and time here. Otherwise the email will be sent immediately.

Date for dispatch (SCDDATE) - If an e-mail is to be sent time-controlled, you can enter the date and time here. Otherwise the email will be sent immediately.

editor

If the parameter "Call editor" (EDIT) was set to * YES, the editor now opens for entering further information. This also applies if * SELECT was specified for the receiver (RCVR). Editor and select options can only be used in an interactive job can be used, with batch jobs all recipient and text information must be transferred by the program.


sndobjeml4 - display of the editor

SELSPLFSND - Select the email system to be used when sending

The SELSPLFSND command is used to select the mail system to be used.

you can find the texts under DSPSPLF + F4 + F1 (IBM command description)


0392 - SELSPLFSND command

Spool file (FILE) - Enter the spool file whose records are to be displayed.

Job name (JOB) - Entry of the relevant job data.

Spool file number (SPLNBR) - Enter the relevant spool file number.

Mail System (MAILSYS) - Enter the relevant mail system.

Valid values ​​are:

*E-MAIL directmail
*SNA Distribution via IBM SNA
*CONVERT Conversion with directmail

EXPEMLATT - Export an email attachment to IFS

With the help of the EXPEMLATT command you can export an attachment from a received e-mail without having to open the e-mail beforehand. The attachment is saved in the IFS.


0275 - Export email attachment

Mail ID (MAILID) - Enter the 20-digit mail ID here, which uniquely identifies each e-mail. You can get the 20-digit mail ID automatically from the mail inbox assistant with the function

*EXITPGM (Call user program).

Appendix number (ATTID) - Identify the number of the attachment you want to export here.

Valid values ​​are:

*FIRST The first attachment is exported
*LOAD The last attachment is exported
NUMBER The attachment with the associated number is exported.

IFS path (PATH) - Enter the path from the IFS under which the attachment is to be stored.

Replace object (REPLACE) - Here you control whether a possibly existing document in the IFS is overwritten or not.

Valid values ​​are:

*YES An existing document will be overwritten
*NO An existing document will not be overwritten

CRTSECPDF - Encrypt PDF file

This command is used to encrypt PDF files that are sent via email. This makes it possible to protect confidential documents in such a way that only the recipient with the appropriate password data can open this file. Encryption is possible with up to 128 bit. Certificates are not supported with this encryption.

Note: Even with 128-bit encryption, this is only as good and secure as the password used. You should therefore use a password that is as long as possible with a mixed combination of characters and digits.


0260 - Encrypt PDF file

PDF file (OBJ) - Enter the directory and name of the unencrypted PDF file here.

New PDF file (TOOBJ) - Enter the directory and name of the encrypted PDF file here.

Replace file (REPLACE) - If the file already exists, it can be replaced.

Valid values ​​are:

*YES The file will be overwritten if a file with the same name exists
*NO The file will not be overwritten.

Current owner password (CURPWD) - The currently valid owner password for this file is shown here. You need this password if the file is already protected with a password in order to change the following attributes.

Allow printing (PRINT) - Here you specify whether the recipient is allowed to print the file.

Valid values ​​are:

*YES The file can be printed.
*NO The file must not be printed.
*SAME The attribute is not changed

Allow modification (MODIFY) - Here you specify whether the recipient can change the file with Adobe Acrobat.

Valid values ​​are:

*YES The file can be changed.
*NO The file must not be changed.
*SAME The attribute is not changed

Allow copying (COPY) - Here you specify whether the recipient is allowed to copy the contents of the file using cut & paste (screen reader).

Valid values ​​are:

*YES The file can be copied.
*NO The file must not be copied.
*SAME The attribute is not changed

Allow comments (ANNOTS) - Here you specify whether the recipient can insert or change comments with Adobe Acrobat.

Valid values ​​are:

*YES Comments can be inserted.
*NO Comments are not allowed to be inserted.
*SAME The attribute is not changed.

Allow form fields (FORMS) - Here you specify whether the recipient can insert or change form fields with Adobe Acrobat.

Valid values ​​are:

*YES Form fields may be inserted.
*NO Form fields may not be inserted.
*SAME The attribute is not changed.

Allow access to content (ACCESSIBLE) - Here you specify whether the recipient is allowed to access the content of the PDF file with, for example, screen readers (from Acrobat version 5).

Valid values ​​are:

*YES The content can be accessed.
*NO The content must not be accessed.
*SAME The attribute is not changed.

Allow assembly (ASSEMBLE) - Here you determine whether the recipient can insert, delete or rotate pages with Adobe Acrobat, or whether thumbnails and bookmarks can be inserted.

Valid values ​​are:

*YES Compilation is possible.
*NO Compilation is not possible.
*SAME The attribute is not changed.

Allow high resolution printing (HIRESPRINT) - Here you specify whether the recipient can print the content of the PDF file in high resolution or only as a raster with low resolution.

Valid values ​​are:

*YES The PDF file may be printed in high resolution.
*NO The PDF file must not be printed in high resolution.
*SAME The attribute is not changed.

Key length (KEYLENGTH) - Here you specify the length of the key with which the PDF file is encrypted.

Valid values ​​are:

40 A 40-digit key length is used
128 A 128-digit key length is used
*NONE The file is not encrypted.
*SAME The attribute is not changed

Owner password (MASTERPWD) - Here you can assign a new password for the owner of the PDF document. An owner password is required to be able to change the attributes of the PDF file.

Valid values ​​are:

Surname Any password
*NONE The file is not password protected.

User password (USERPWD) - Here you can set a user password with which the PDF file can be opened and edited within the limits set by the owner.

Note:The user password is requested when the PDF file is opened and therefore offers additional protection against unauthorized access.

Valid values ​​are:

Surname Any password
*NONE The file is not password protected.

SGNOBJ - Sign an object

The SGNOBJ command is used for the qualified electronic signing of any IFS objects. The signature is made using directcard and card terminal. An API and cryptography API license is required for this command.


0387 - Sign IFS objects

IFS object (OBJ) -

Enter any IFS object here.

IFS signature object (SGNOBJ) - After a successful signature, a signature file is created with the name specified here (the standard extension for signature objects is .pkcs7).

Smart Card Terminal (TEMINAL) - Here you specify which terminal you want to use to sign the object. To do this, enter the name from the terminal configuration (from DIRCARD / WRKCRDTRM).

Certificate (CERT) - This parameter offers the possibility to sign an object with DirectCard and soft certificates.

Password (PASSWORD) - Entering a password for the signature.

Note: If the parameters CERT and PASSWORD are used, then * CERT must be specified for the parameter TERMINAL.

Replace object (REPLACE) - If the signature object from a previous signature already exists, you can overwrite it with this parameter when signing again.

Valid values ​​are:

*YES an existing signature object will be overwritten
*NO an existing signature object will not be overwritten

Card no. (CARD) - Here you can restrict the signature to a specific SmartCard, enter the card number. a. You can read out the currently inserted card with DIRCARD / WRKCRDTRM and selection 15 in front of the terminal.

Valid values ​​are:

Card no. an explicit card number. for signing
*ANY The currently inserted SmartCard is used for signing.

Reference text (REF) - Here you can enter a text that will be displayed when the object is signed on the terminal.

Hash algorithm (HASHALGO) - The hash algorithm is used to calculate a unique test value. The values ​​SHA1 and SHA256 are supported.

Valid values ​​are:

*SHA1 simple encryption technology
*SHA256a very secure encryption technology.

RLSATMBCH - Release held automail batches

The RLSATMBCH (Release AutoMail Batch) command can be used to release complete AutoMail batches that were created in "Halt" mode with one command.

0278 - Command RLSATMBCH
Batch ID
The unique batch ID must be specified as a parameter. This can be determined with the option 5 = Show in the MailBox.

DLTATMBCH - Delete one or more attachments from an email

A complete batch of AutoMails can be deleted using the DLTATMBCH (Delete AutoMail Batch) command.


0268 - Delete AutoMail batch

Batch ID (BATCH) - The unique batch ID must be specified as a parameter. This can be determined with option 5 in the MailBox.

With the commands of this group you can via FTP

  • Transfer objects from IFS to other systems (SNDOBJFTP)
  • Get from other systems into the local IFS (RCVOBJFTP)
  • Renaming objects on other systems (RNMOBJFTP)
  • Delete objects on another system (DLTOBJFTP)

To be able to use these commands, the option API be licensed.

Further information can be found in the section Notes on licensing on the directmail "homepage". If you have any questions, please contact [email protected]

SNDOBJFTP - Transfer the object to a remote system via FTP

The SNDOBJFTP command can be used to transfer files to a remote system via FTP.

To be able to use the command, the option API be licensed. Further information can be found in the section Notes on licensing on the directmail "homepage". If you have any questions, please contact [email protected]




0306 - Send object via FTP

IFS object (OBJ) - Here you enter the name of the IFS object that is to be sent.

Remote system (RMTSYS) - Here you enter the name of the remote system to which the object is to be sent.

Remote user (RMTUSR) - Enter the name of the remote user here.

Remote password (RMTPWD) - Enter the remote user's password here.

Remote Path (RMTPTH) - Here you enter the name of the remote path to which the object is to be sent.

Binary mode (BINARY) - Here you specify whether the object should be sent in binary mode.

Valid values ​​are:

*YES The object is sent in binary mode (default)
*NO The object is not sent in binary mode

Delete IFS object (DELETE) - Here you specify whether the IFS object should be deleted after sending.

Valid values ​​are:

*YES The IFS object is deleted after sending
*NO The IFS object is not deleted after sending (default)

RCVOBJFTP - Object received from a remote system via FTP

The RCVOBJFTP command can be used to receive files from a remote system via FTP.

To be able to use the command, the option API be licensed. Further information can be found in the section Notes on licensing on the directmail "homepage". If you have any questions, please contact [email protected]