267
| 1 | Mapping exit input information | Input | Char(*) |
| 2 | Length of input information | Input | BINARY(4) |
| 3 | Mapping exit output information | Output | Char(*) |
| 4 | Length of output information buffer | Input | BINARY(4) |
| 5 | Length of output information available | Output | BINARY(4) |
The PSF/400 mapping exit program allows a customer to specify a routing tag instead of a mail address in the USRDFNDTA parameter of the printer file, using indices and Infoprint® Server's CRTAFPDTA command, or the DDS STRPAGGRP parameter. The PSF/400 mapping exit program also allows a customer or vendor to provide a program to map a routing tag (such as a customer number) to one or more distribution actions, and configure the details of the distribution. The PDF file can be stored as a streamfile in the Integrated File System, respooled as AFP™ or PDF on an output queue, e-mailed, or any combination of those distributions. In addition, the mapping exit program allows configuration of those distributions, including the ability to specify the name of the PDF streamfile, the ability to specify the subject, encryption settings and additional attachments of the e-mail, or the output queue to spool the PDF.
This exit program is called for each successfully generated PDF file whenever a mapping exit program is speficied on the PDFMAPPGM parameter of the PSFCFG, and the PDFGEN parameter does not have a value of *NONE. Once PSF/400 has received notification from the virtual printer that all pages have been stacked, it calls the exit program for each PDF output file to resolve the routing tag information to the proper distribution action.
None.
The mapping exit program information that is input to the mapping exit program from the PSF/400 print writer. For the format and description of the information, see Mapping Exit Program Input Information.
The length of the input information specified in the mapping exit input information to the mapping exit program parameter.
The information that is output from the mapping exit program to the PSF/400 print writer. For the format and description of this information, see Mapping Exit Program Output Information.
The size, in bytes, of the mapping exit program output information buffer.
The length of the mapping exit program output information available. If this length is less than or equal to the length of the routing tag output information, all available information has been returned. If this length is greater than the length of the mapping program output information, only data up to the length provided is returned in the mapping exit program output information buffer.
The following table shows the structure for the input information that is passed to the PSF/400 Mapping exit program.
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | CHAR(26) | Qualified job name |
| 26 | 1A | CHAR(10) | Spooled file name |
| 36 | 24 | BINARY(4) | Spooled file number |
| 40 | 28 | CHAR(250) | Routing tag |
| 290 | 122 | CHAR(340) | Path and name of PDF file |
| 630 | 276 | CHAR(1) | Mail server type |
| 631 | 277 | CHAR(1) | Reserved |
| 632 | 278 | BINARY(4) | Path name CCSID |
| 636 | 27C | CHAR(10) | Mail sender |
| 646 | 286 | CHAR(10) | User Data |
| 656 | 290 | CHAR(8) | Job system name |
| 664 | 298 | CHAR(8) | Creation time stamp |
| 672 | 2A0 | CHAR(10) | Output queue on which the spooled file is located |
| 682 | 2AA | CHAR(10) | Output queue library |
| 692 | 2B4 | CHAR(10) | PDF mapping object name |
| 702 | 2BE | CHAR(10) | PDF mapping object library |
| 712 | C8 | CHAR(10) | Formtype |
Creation time stamp. The date and time the spooled file was created.
Formtype. The value from the Formtype parameter on the print file.
Job system name. The name of the system on which the spooled file was created.
Mail sender. The sender of the electronic mail. The value is specified on the printer file USRDFNDTA parameter or on the PSF configuration object PDFSENDER parameter. If no mail sender is identified on USRDFNDTA, the value from the PDFSENDER parameter of the PSF configuration object is used.
Mail server type. The mail server in use. Valid values are:
| 1 | The SNDDST (Send Distribution) command is used to send e-mail messages. |
| 2 | The SMTP protocol is being used to send e-mail messages. |
Routing tag. The mail address or routing tag specified on the printer file USRDFNDTA parameter or the DDS STRPAGGRP keyword. This is set to blanks ('40'X) if no value was provided by either parameter. It is possible that the mapping program could return mail addresses based on job, file, and USRDTA information. If both provide tag or address information, the DDS STRPAGGRP keyword takes precedence.
Output queue on which the spooled file is located. The outpue queue to which the writer was started.
Output queue library. The library that contains the output queue to which writer was started.
Path and name of PDF file. The path and name of the PDF file.
Path name CCSID. The CCSID of the path and name of the PDF file.
PDF mapping object library. Name of the PDF mapping object library, if one was specified on the PSFCFG object. This is set to blanks (X'40') if no value was provided on the PDFMAPBOBJ parameter of the PSFCFG object.
PDF mapping object name. Name of the PDF mapping object, if one was specified on the PSFCFG object. This is set to blanks (X'40') if no value was provided on the PDFMAPBOBJ parameter of the PSFCFG object.
Qualified job name. The qualified job name of the job that created the spool file that was converted to PDF. The data is comprised of the following information:
| CHAR(10) | Job name |
| CHAR(10) | User name |
| CHAR(6) | Job number |
Reserved. An unused field.
Spooled file name. The name of the spooled file that was converted to PDF.
Spooled file number. The unique number of the spooled file that was converted to PDF.
User data. The value in the printer file USRDTA parameter. It contains blanks if USRDTA contains blanks.
The following table shows the structure for the output information from the Mapping exit program.
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | CHAR(1) | Disposition of PDF e-mail |
| 1 | 1 | CHAR(1) | More processing |
| 2 | 2 | CHAR(2) | Reserved - initialized to null |
| 4 | 4 | BINARY(4) | Length of message text (0 to 255 bytes) |
| 8 | 8 | BINARY(4) | Length of mail address data (0-16,000,000) |
| 12 | C | CHAR(255) | Message text data |
| 267 |
10B | CHAR(1) | PDF Email Comma Delimiter |
| 268 | 10C | BINARY(4) | Offset to extension area |
| 272 | 110 | BINARY(4) | CCSID of message text data and subject |
| 276 | 114 | CHAR(1) | Disposition of PDF streamfile |
| 277 | 115 | CHAR(1) | Disposition of PDF spoolfile |
| 278 | 116 | CHAR(1) | Disposition of PDF error |
| 279 | 117 | CHAR(1) | Disposition of AFPDS spoolfile |
| 280 | 118 | BINARY(4) | Offset to message text data |
| 284 | 122 | CHAR(3) | Reserved - initialized to null |
| 287 | 11F | CHAR(*) | E-mail addresses |
CCSID of message text data and subject. The CCSID associated with the message text data and subject, if specified.
| 0 | A value from 1 to 65533. |
| ccsid-value | A value from 1 to 65533. |
This field is used only when an SMTP mail server is specified in your PSF configuration object and must be set to zero otherwise.
This CCSID will be used to convert the data to Unicode for inclusion within the e-mail. The receiver of the e-mail may have to have the receiving e-mail program configured for the appropriate character set to be able to view the e-mail correctly.
Disposition of AFPDS spoolfile. Specifies whether the PDF should be spooled. If file is to be spooled as AFPDS, an output queue has to be defined on the PSFCFG or in the Spooled File AFPDS Distribution in the Output Queue Name field.
| '0' | Do not spool AFPDSon an output queue. |
| '1' | Spool AFPDS on an output queue |
Disposition of PDF e-mail. Specifies whether the PDF should be e-mailed.
| '0' | Do not e-mail |
| '1' | E-mail to specified addresses |
Disposition of PDF error. This field can be used to signal to PSF/400 that an error was detected in the Exit Program. If this flag is set, PSF/400 will e-mail the PDF output to the e-mail address on the PSFCFG PDFADMIN, if one is available.
| '0' | No errors mapping input. |
| '1' | Errors were encountered. |
Disposition of PDF spoolfile. Specifies whether the PDF should be spooled. If file is to be spooled as PDF, an output queue has to be defined on the PSFCFG or in the Spooled File PDF Distribution in the Output Queue Name field
| '0' | Do not spool PDF file on an outq |
| '1' | Spool PDF file on an outq |
Disposition of PDF streamfile. Specifies whether the PDF should be stored as a stream file in the Integrated File System. If file is to be stored as a stream file, user will have to have the path name defined in the PSFCFG or specified in the PDF file name field of the Extension Area Format.
| '0' | Do not store PDF as a stream file. |
| '1' | Store PDF as a stream file. |
E-mail addresses. The e-mail addresses that should be used for sending the PDF file. They must be in the following format: ('e-mail address' 'e-mail address'.) Each address must be delimited by single quotes.
Length of e-mail address data. The length of the e-mail address data to be used in sending the PDF file. The maximum length allowed is 16 MB, since this is the largest value that can be used allocate a user space. If the PDF file should not be e-mailed, the length of the e-mail address data should be set to 0.
Length of message text data. The length of the message text to be used in sending the PDF file. This must be a value ranging from 0 to 255. If no message text is to be used in sending the PDF file, the length of the message text data should be set to 0.
Message text data. The message text data to be used in sending the PDF file. This value should be blanks if the text length is 0.
More processing. Whether the exit program should be called again because it has more processing to do for the same spooled file.
Offset to extension area. Offset from the beginning of this structure. The value specified for this entry must be a 4-byte multiple. A value of 0 indicates that the extension area is not being used. See Extension Area Format for additional information.
Offset to message text data. Offset from the beginning of this structure. The value must be a 4-byte multiple Use this field if you specify more than 255 bytes of message text data. If you are using the Message text data field, specify a value of 0 for Offset to message text data.
PDF Email Comma Delimiter. Specifies whether all e-mail addresses are separated by the default delimiter (single quotation marks) or a comma. The default delimiter, for example, is used as follows: 'name1@domain1' 'name2@domain2'. The comma delimiter, for example, is used as follows: name1@domain1, name2@domain2.
If your program is using this field a comma is not required if just a single e-mail address is specified.
| '0' | The default delimiter, an apostrophe, is being used. This field occupies the offset of a field that was reserved in Infoprint Server 5.1. Therefore, X'00' is treated the same as '0' (X'F0') for compatibility. |
| '1' | A comma is being used as a delimiter. Your application must use a comma as a delimiter when specifying more than one e-mail address for TO, CC and BCC. When specifying a single address, no comma is required. Do not use enclosing single apostrophes for any e-mail address, including ReplyTo. This support is provided for SMTP mail servers only. Use of a comma delimiter is not supported when PDFMAILSVR(*SNDDST) is specified in a PSF configuration object. |
Reserved - initialized to null. A reserved field.
Reserved (set to X'00'). A reserved field.
This format is specified only when needed. If your application has no need for it, specify a value of 0 for Offset to extension area in the e-mail exit program output information.
This format must begin on a 4-byte multiple. All offsets are computed from the beginning of the mapping exit program output information structure.
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | BINARY(4) | Length of extension area format |
| 4 | 4 | BINARY(4) | Offset to subject |
| 8 | 8 | BINARY(4) | Length of subject |
| 12 | C | BINARY(4) | Offset to ReplyTo e-mail address |
| 16 | 10 | BINARY(4) | Length of ReplyTo e-mail address |
| 20 | 14 | BINARY(4) | Offset to CC e-mail addresses |
| 24 | 18 | BINARY(4) | Length of CC e-mail addresses |
| 28 | 1C | BINARY(4) | Offset to BCC e-mail addresses |
| 32 | 20 | BINARY(4) | Length of BCC e-mail addresses |
| 36 | 24 | BINARY(4) | Offset to list of path names for body of e-mail |
| 40 | 28 | BINARY(4) | Offset to path name for directory for files |
| 44 | 2C | BINARY(4) | Length of path name for directory for files |
| 48 | 30 | BINARY(4) | Offset to list of path names of attachments |
| 52 | 34 | BINARY(4) | Offset to PDF file name for storing as a file |
| 56 | 38 | BINARY(4) | Length of PDF file name for storing as a file |
| 60 | 3C | BINARY(4) | Offset to file name for PDF attachment for e-mail |
| 64 | 40 | BINARY(4) | Length of file name for PDF attachment for e-mail |
| 68 | 44 | BINARY(4) | Offset to PDF file public authority |
| 72 | 48 | BINARY(4) | Length of PDF file public authority |
| 76 | 4C | BINARY(4) | Offset to spooled file PDF distribution |
| 80 | 50 | BINARY(4) | Length of spooled file PDF distribution |
| 84 | 54 | BINARY(4) | Offset to spooled file AFP distribution |
| 88 | 58 | BINARY(4) | Length of spooled file AFP distribution |
| 92 | 5C | BINARY(4) | Offset to PDF encryption information |
| 96 | 60 | BINARY(4) | Length of PDF encryption information |
| 100 | 64 | CHAR(10) | Mail sender |
| 110 |
6E | CHAR(1) | Encrypt PDF stream file |
| 111 |
6F | CHAR(1) | Encrypt PDF spooled file |
Encrypt PDF spooled file. Use the e-mail encryption setting for a PDF spooled file. If you wish to encrypt the PDF spooled file you must indicate on the first call to the mapping exit program when a spooled file is being processed that an e-mail is to be sent and specify encryption settings, as well as setting the Encrypt PDF spooled file field to a value of '1'. If you do now wish to have the e-mail sent you must set the Disposition of PDF e-mail field in the Mapping Exit Program Output Information structure to a value of '0' on the second call to the mapping exit program.
| '0' | Do not encrypt the PDF spooled file. |
| '1' | Encrypt the PDF spooled file. |
Encrypt PDF stream file. Use the e-mail encryption setting for a PDF stream file. If you wish to encrypt the PDF stream file you must indicate on the first call to the mapping exit program when a spooled file is being processed that an e-mail is to be sent and specify encryption settings, as well as setting the Encrypt PDF stream file field to a value of '1'. If you do now wish to have the e-mail sent you must set the Disposition of PDF e-mail field in the Mapping Exit Program Output Information structure to a value of '0' on the second call to the mapping exit program.
| '0' | Do not encrypt the PDF stream file. |
| '1' | Encrypt the PDF stream file. |
Length of BCC e-mail addresses. The length of the BCC e-mail address data to be used in sending the PDF file. This field is used only when an SMTP mail server is specified in your PSF configuration object; otherwise, it must be set to zero.
Length of CC e-mail addresses. The length of the CC e-mail address data to be used in sending the PDF file. This field is used only when an SMTP mail server is specified in your PSF configuration object; otherwise, it must be set to zero.
Length of file name for PDF attachment for e-mail Length of the file name used to rename the PDF attachment for e-mail distribution. This field is only used when Disposition for PDF e-mail is set to '1'; otherwise, it must be set to zero.
Length of extension area format. The length of the extension area format. Specify one of the following values:
| 52 | This length is used by the oldest mapping programs. Fields after Offset to list of path names of attachments will not be recognized. |
| 100 | This length is used by some mapping programs. Fields after Length of PDF encrytpion information will not be recognized. |
| 110 | This length allows full use of the Extension Area Format. All fields will be recognized. |
Length of path name for directory for files. The length of the path name containing the directory for which files may be stored. This field is used only when an SMTP mail server is specified in your PSF configuration object; otherwise, it must be set to zero.
Length of PDF encryption information . The length of the PDF file encryption information. This field is used only when PDF encryption information is specified; otherwise, it must be set to zero.
Length of PDF file name for storing as a streamfile. The length of the PDF file name used when Disposition of PDF streamfile is set to 1. This field is used only when Disposition of PDF streamfile is set to '1'; otherwise, it must be set to zero.
Length of PDF file public authority The length of public authority to the PDF file. This field is used only when the PDF file is to be stored as a stream file and the PDF Streamfile Disposition is equal to '1'; otherwise, it must be set to zero.
Length of spooled file AFP distribution The length of the AFP spooled file distribution information. This field is used only when a additional spooled file information is specified; otherwise, it must be set to zero.
Length of spooled file PDF distribution The length of the PDF spooled file distribution information. This field is used only when additional spooled file information is specified; otherwise, it must be set to zero.
Length of ReplyTo e-mail address. The length of the ReplyTo e-mail address. This field is used only when an SMTP mail server is specified in your PSF configuration object; otherwise, it must be set to zero.
Length of subject The length of the character string to be used as the subject text. Maximum length is 255. Data longer than the maximum length will be truncated.
Offset to BCC e-mail addresses. Offset to BCC e-mail addresses. This area contains the BCC e-mail addresses that should be used for sending the PDF file. These addresses must be in the following form: ('e-mail address' 'e-mail address'...). Each e-mail address must be delimited by single quotes.
A value of 0 indicates that BCC e-mail addresses are not specified. This field is used only when an SMTP mail server is specified in your PSF configuration object; otherwise, it must be set to zero.
Mail sender. The name to be used for the sender of the electronic mail. Pad the field with blanks ('40'X), if necessary.
| Blanks ('40'X) | The mail sender specified on the PSF configuration object is used. |
| mail-sender-name | The name of the mail sender. This name must be a valid user profile enrolled in the System Distribution Directory. If your PSF configuration object specifies PDFMAILSVR(mail-server-name) or PDFMAILSVR(*LOCAL), the entry in the System Distribution Directory must have an SMTP user ID and SMTP domain specified. |
Offset to CC e-mail addresses. Offset to BCC e-mail addresses. This area contains the CC e-mail addresses that should be used for sending the PDF file. These addresses must be in the following form: ('e-mail address' 'e-mail address'...). Each e-mail address must be delimited by single quotes.
A value of 0 indicates that CC e-mail addresses are not specified. This field is used only when an SMTP mail server is specified in your PSF configuration object; otherwise, it must be set to zero.
Offset to file name for PDF attachment for e-mail The offset to the file name that will be used for the PDF output that is attached to the e-mail when Disposition of PDF e-mail is sequal to '1'. If Disposition of PDF e-mail is set to one, and this field is set to '0', PSF will determine a default file name to use. If Disposition of PDF e-mail is set to 0, this field must be set to zero as well.
Offset to list of path names of attachments. The offset to the list of path names listing the attachments. One or more attachments may be specified. The PDF file you are sending must not be listed here; otherwise, it will be attached again. A value of 0 indicates that no attachments are specified.
If you have specified a directory to be used for files (see Offset to path name for directory for files), then the path name specified for this field will be appended to the value specified for the directory. If you have not specified a directory to be used for files, the path name specified for each attachment must be fully resolved. These files must be in the Integrated File System. Please note the following:
See Stream File Format for information about the format to use when specifying this information. This field is used only when an SMTP mail server is specified in your PSF configuration object; otherwise, it must be set to zero.
Offset to list of path names for body of e-mail. Offset to list of path names listing the files to be used for the body of the e-mail. One or more files may be specified. The PDF file you are sending must not be listed here or it will be attached again. A value of 0 indicates that a stream file is not specified.
The order in which you list these files determines the order in which they are placed in the body (message portion) of the e-mail. Files are placed in the body in the order in which they are specified. If you have specified Message text data, this is placed in the body of the e-mail first. These files must be in the Integrated File System. Please note the following:
See Stream File Format for information about the format to use when specifying this information.
The CCSID of the file is used if a code page conversion is required.
If a file is not text, it will be placed as an attachment to the e-mail. For example, if you specify a sound file to be part of the body of the e-mail, it will actually be an attachment.
This field is used only when an SMTP mail server is specified in your PSF configuration object; otherwise, it must be set to zero.
Offset to path name for directory for files The offset to a path name containing the directory for which files may be stored. This path name must be fully resolved. If you use this field, then path names of specified attachments and body files will be appended to the path name specified at the offset for this field.
A value of 0 indicates that a path name is not specified. If a value of 0 is specified, you must specify the complete path name for all listed files used for the body of the e-mail and as attachments to the e-mail.
This directory is specified by using a value of 1 in the use-specified directory field in the Base format. This format is used when specifying files to be used as attachments or as part of the body of the e-mail. If you specify 0 for the Use specified directory field, then that particular file must have its full path specified.
This field is used only when an SMTP mail server is specified in your PSF configuration object; otherwise, it must be set to zero.
Offset PDF encryption information. The offset to the PDF file encryption information. See Spooled File PDF Distribution for information about the format to use when specifying this information. A value of 0 indicates that no encryption information is specified.
Offset to PDF file name for storing as a file. The offset to the file name the PDF will be stored as in the Integrated File System. Requires that the Disposition of PDF streamfile be set to 1. If Disposition of PDF streamfile is set to 1, a value of 0 in this field indicates that PSF/400 will determine a default file name to be used.
Offset to PDF file public authority. The offset to the public authorities specified for the PDF stream file.
Valid Authority Values
Offset to spooled file AFP distribution. The offset to the AFP spooled file information. See Spooled File AFPDS Distribution for information about the format to use when specifying this information. A value of 0 indicates that no spooled file information is specified.
Offset to spooled file PDF distribution. The offset to the PDF spooled file information. See Spooled File PDF Distribution for information about the format to use when specifying this information. A value of 0 indicates that no spooled file information is specified.
Offset to ReplyTo e-mail address. Offset to ReplyTo e-mail
address. Use this address if you wish to have replies to your e-mail be sent to
an e-mail address other than the one specified for the FROM e-mail address.
Some mail
clients may not support the ReplyTo, instead sending the reply to the FROM e-mail address.
The address must be in the following form: ('e-mail address').
A value of 0 indicates that ReplyTo e-mail addresses are not specified.
This field is used only when an SMTP mail server is specified in your PSF configuration object and must be set to zero otherwise.
Offset to subject The offset to the character string to be used as the subject text. A value of 0 indicates that a subject is not specified here. If you do not specify a subject, then the default subject is obtained from message PQT4133 in message file QPQMSGF.
If you have specified an SMTP mail server, the CCSID of message text data and subject will be used to convert the data to Unicode for inclusion within the e-mail. The receiver of the e-mail may have to have the receiving e-mail program configured for the appropriate character set to be able to view the e-mail correctly.
Use this format only when an SMTP mail server is specified in your PSF configuration object, and you are specifying the use of stream files for either the body of the e-mail or additional attachments.
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | BINARY(4) | Total length for stream file information |
| 4 | 4 | BINARY(4) | Number of stream files specified |
| 8 | 8 | CHAR(*) | Stream file information |
Number of stream files specified. The number of stream files specified within this format.
Stream file information. The initial offset at which information for each stream file is positioned.
See Individual Stream File Information Format for information about the format to use when specifying this information. Use one instance of the base format for each stream file. Each instance of this format must be contiguous to the previous one.
Total length for stream file information. The total length for all data used with this structure. This field is included within the length. The value specified for this entry must be a 4-byte multiple.
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | BINARY(4) | Total length of individual stream file format |
| 4 | 4 | BINARY(4) | Length of individual stream file format |
| 8 | 8 | BINARY(4) | Offset to path name |
| 12 | C | BINARY(4) | Length of path name |
| 16 | 10 | CHAR(1) | Use-specified directory |
| 17 | 11 | CHAR(3) | Reserved (set to X'00') |
Length of individual stream file format. The length of the structure used for the individual stream file format. This value must be 20.
Length of path name. The length of the path name that specifies the stream file.
Offset to path name. The offset to the path name that specifies the stream file. The offset is from the beginning of the base format in which this value is specified.
Use-specified directory. Whether the directory specified for stream files used as either attachments or in the body of the e-mail is to be prefixed to the name of the stream file. For example, if you have specified '/SpecialApp/customerOne/' for a directory of files in the extension area format, this value will be prefixed to stream file names when specified using this field. Valid values are:
| 0 | Do not prefix directory to this path name. |
| 1 | Prefix directory to this path name. |
Total length of individual stream file format. The total contiguous length used with this format, including this field. This value is used to determine the location of the next stream file information format. The value specified for this entry must be a 4-byte multiple.
Use this format when a PDF is to be spooled as a PDF Spoolfile.
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | CHAR(10) | Name of output queue to spool PDF |
| 10 | A | CHAR(10) | Output queue library |
| 20 | 14 | CHAR(10) | Spooled File Name |
| 30 | 1E | CHAR(10) | User Data |
| 40 | 28 | CHAR(255) | User Defined Data |
| 295 | 127 | CHAR(10) | Formtype |
Formtype The Form type to be used for the PDF spooled file.
| *SPLF | Specifies that the form type of the original spoolfile will be used. |
| Formtype | Specify the form type defined data. |
Name of output queue to spool PDF. The name of the output queue that the PDF will be spooled on.
The following special values are supported for the library name:
| *PSFCFG | Use value specified in the PSF Configuration object. |
| Output-queue | Specify the output queue name. |
Output queue library The library in which the output queue to spool PDF exists.
| Output-queue-library | Specify the output queue library name. |
Spooled File Name The name used for the new spooled file.
The following special values are supported for the spooled file name:
| *SPLF | Use the original spooled file name for the new spooled file. |
User Data The user data for the PDF spooled file. The possible values are:
| *SPLF | Specifies that the user data of the original spoolfile will be used. |
| User-data | Specify the user data. |
User Defined Data The user defined data for the PDF spooled file. The possible values are:
| *SPLF | Specifies that the user defined data of the original spoolfile will be used. |
| User-data | Specify the user defined data. |
Use this format when a Spoolfile segment is to be spooled as a AFP Spoolfile.
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | CHAR(10) | Name of output queue to spool AFPDS |
| 10 | A | CHAR(10) | Output queue library |
| 20 | 14 | CHAR(10) | Spooled File Name |
| 30 | 1E | CHAR(10) | User Data |
| 40 | 28 | CHAR(255) | User Defined Data |
| 295 | 127 | CHAR(10) | Formtype |
Formtype The Form type to be used for the ADPDS spooled file.
| *SPLF | Specifies that the form type of the original spoolfile will be used. |
| Formtype | Specify the form type defined data. |
Name of output queue to spool AFPDS The name of the output queue that the AFPDS will be spooled on.
The following special values are supported for the library name:
| *PSFCFG | Use value specified in the PSF Configuration object. |
| Output-queue | Specify the output queue name. |
Output queue library The library in which the output queue to spool AFPDS exists.
| Output-queue-library | Specify the output queue library name. |
Spooled File Name The name used for the new spooled file.
The following special values are supported for the spooled file name:
| *SPLF | Use the original spooled file name for the new spooled file. |
User Data The user data for the AFPDS spooled file. The possible values are:
| *SPLF | Specifies that the user data of the original spoolfile will be used. |
| User-data | Specify the user data. |
User Defined Data The user defined data for the AFPDS spooled file. The possible values are:
| *SPLF | Specifies that the user defined data of the original spoolfile will be used. |
| User-defined-data | Specify the user defined data. |
Use this format when a PDF is to be encrypted.
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | CHAR(32) | PDF Master Password |
| 32 | 20 | CHAR(32) | PDF User Password |
| 64 | 40 | CHAR(1) | PDF Printing |
| 65 | 41 | CHAR(1) | PDF Document Changing |
| 66 | 42 | CHAR(1) | PDF Copy Document |
| 67 | 43 | CHAR(1) | PDF Encryption Level |
| 68 | 44 | CHAR(1) | PDF Content Access Enablement |
| 69 | 45 | CHAR(1) | PDF Changing Comments |
| 70 | 46 | CHAR(1) | PDF Document Assembly |
PDF Content Access Enablement. Specify the PDF viewer's security settings for content access to the PDF document.(Only configurable with 128-bit encryption.For 40-bit, set to '0'.)
| '0' | Content Access not enabled. |
| '1' | Content Access enabled |
PDF Changing Comments. Specify the PDF viewer's security settings for adding or modifying text annotations in the PDF document.
| '0' | Comments not allowed |
| '1' | Comments allowed |
PDF Copy. Specify the PDF viewer's security settings for copying from the PDF document.
| '0' | Copy not allowed |
| '1' | Copy allowed |
PDF Document Assembly. Specify the PDF viewer's security settings for document assembly from the PDF document.(Only configurable with 128-bit encryption. For 40-bit, set to '0'.)
| '0' | Assembly not allowed |
| '1' | Assembly allowed |
PDF Document Changing. Specify the PDF viewer's security settings for changing the PDF document.
| '0' | Changing not allowed |
| '1' | Changing allowed |
PDF Encryption Level. Specify the encryption level the PDF document using PDF Viewer security settings.
| '1' | 40-bit |
| '2' | 128-bit |
PDF Master Password. A string of up to 32 alphanumeric letters and/or numbers. Acceptable characters are A-Z, a-z and 0-9. X'00' will indicate that there is no password on this document.
| *NONE | No master password specified. |
PDF Printing. Specify the PDF viewer's security settings for printing the PDF document
| '0' | Not Allowed |
| '1' | Allowed |
| '2' | Low Resolution Printing.(Only configurable with 128-bit encryption.). |
PDF User Password. A string of up to 32 alphanumeric letters and/or numbers. Acceptable characters are A-Z, a-z and 0-9. X'00' will indicate that there is no password on this document.
| *NONE | No user password specified. |
[ Back to top | Print APIs | APIs by category ]