*INFO (PRTPAGE)

9.6A, PLBCMP GUI Only

*INFO={svarslit}

This advanced print control takes a comma separated list of fields as provided in the {svarslit} data string to include additional user information in the PDF output file. Each field is composed of a field identifier assigned using a '=' character followed by field data. The data field data can be specified with or without double quote characters. Each *INFO data field is optional and is not required when generating a PDF output file.

The following *INFO fields are supported:

Where:

a user specified string that may or may not include double quote characters.

a date string is specified as a YYYMMDDhhmmss format.

Fields:

A= //Optional Author

Include an Author description in the PDF output file.

P= //Optional Producer

Include a Producer description in the PDF output file.

S= //Optional Subject

Include a Subject string in the PDF output file. (9.6B)

T= //Optional Title

Include a Title description in the PDF output file.

K= //Optional Keywords

Include Keyword data in the PDF output file. Keywords are provided as simple associations in a PDF file as applied by a PDF reader. In this case, the data can be specified a one or more keywords separated by a white space (blank) character.

 C= or C //Optional CreationDate & ModDate

Include the CreationDate and ModDate field data in the PDF output file. If the 'C' syntax format is used without a '=' character, a default timestamp is included in the PDF output file.

Note:

1. Only one PRTPAGE *INFO can be executed for inclusion in a PDF output file. If a second PRTPAGE *INFO is executed a S30 subcode 106 error is generated.

2. All of the expected *INFO field information MUST be included in the first and only PRTPAGE *INFO when executed.

 

Examples:

 

xInfo      INIT      "A=Bill,C,K=#"Test Sample Plbwin#",","P=Plbwin,T=Test"

.

           PrtPage      Prt;*Info="A=Bill,C,K=Plbwin"

           PrtPage      Prt;*Info=xInfo

 

3. By default the *INFO command data is always included in PDF output. An end-user program can used the PRTPAGE *INFO control to make changes of the information included in the PDF output. However, if the PRTPAGE *INFO control is not used the following information is output to the PDF with the following defaults:

 

• The Title is the file name of the PDF file.

• The Author is the user name

• The Creator is always set to the runtime and version information.

• The Producer defaults to the runtime and version information.

• The dates default to the current date/time.

See Also: List Controls (PRTPAGE), PRTPAGE