title-text

This single-valued attribute describes the contents of the file. This value can be printed on a separator page created by your installation. It can also be printed on a separator page (banner page) printed by the printer's LPD. If the file is sent to an email destination, this value is the subject of the email.

Allowed values

You can enter a text string of up to 60 characters. If the text string you specify contains spaces, enclose the text string in single or double quotation marks. For example:

-o "title-text='Meeting Agenda'"

If the string contains double quotation marks, enclose the string in single quotation marks. For example:

-o "title-text='A New Interpretation of "Finnegans Wake"'"

Default value

• For a separator page created by an IP PrintWay™ or PSF exit: The default value is the title your administrator specified in the Allocation section of the printer definition. If none is specified, there is no default value.
• For the LPD's separator page: The default value is the title your administrator specified in the Allocation section of the printer definition. If none is specified, the default value is the title or filename your administrator specified in the Protocol section of the printer definition. If none is specified, the default value is the data set name.
• For the subject of an email: The default value is the title specified in the Allocation section of the printer definition. If none is specified, the default value is the job name. Depending on how the print request was submitted, the job name might be the ID of the user who submitted the print request.

Usage guidelines

• Whether the text specified by this attribute is printed depends on how your administrator configures the printer’s separator sheet or how the LPD is implemented.
• This attribute is equivalent to the TITLE parameter of the OUTPUT JCL statement.