Attributes for the fsa object class

z/OS Infoprint Server Operation and Administration

Attributes for the fsa object class

z/OS Infoprint Server Operation and Administration
SA38-0693-00

Attributes for the fsa object class

This topic lists attributes that are valid when you create FSA definitions, which are in object class fsa. You can create FSA definitions for PSF (or the AFP Download Plus feature of PSF) or IP PrintWay™ basic mode.

Tip: In this topic, PSF refers to PSF for z/OS®, the AFP Download Plus feature of PSF, or both.

When you create an FSA definition for PSF, all attributes are valid. However, only a subset of the attributes apply for each type of FSA: PSF channel, PSF TCP/IP, PSF SNA, and PSF AFP Download Plus. For information about which attributes PSF uses, see:

When you create an FSA definition for IP PrintWay basic mode, only these attributes are valid:

description
fsa-type
trace-mode

Required attributes

For Infoprint Server to display the correct ISPF panel for an FSA definition, you must specify the fsa-type attribute. In addition, PSF requires these attributes:

applid (when fsa-type=psf-sna)
form-definition
luname (when fsa-type=psf-sna)
page-definition
printer-ip-address (when fsa-type=psf-tcpip or fsa-type=afp-download-plus)

IP PrintWay does not require any attributes in an FSA definition.

acknowledgement-level

This single-valued attribute specifies whether PSF requests an acknowledgement every sheet or every page.

ISPF field name

Acknowledgement level

Allowed values

You can enter one of these fixed values:

page: An acknowledgement is requested for every page that is printed (default).
sheet: An acknowledgement is requested for every sheet that is printed.

afpdp-dataset-grouping

This single-valued attribute indicates whether output data sets in the same job are grouped together when sending them to the AFP Download Plus receiver.

ISPF field name

Data set grouping

Allowed values

You can enter one of these fixed values:

yes: PSF groups output data sets into jobs. The AFP Download Plus receiver prints the data sets in the same job in sequence with one set of separator pages for the job.
no: PSF does not group output data sets into jobs (default). The AFP Download Plus receiver treats each data set as a separate job.

afpdp-working-directory

This single-valued attribute specifies the name of the UNIX directory that AFP Download Plus uses as its working directory.

ISPF field name

Working directory

Allowed values

You can enter a directory name of up to 255 characters. PSF adds the beginning and ending forward slashes if they are missing from the directory name. If the value contains special characters other than slashes or periods, enclose the value in double quotation marks. This attribute is case-sensitive.

Default value

PSF uses directory /var/psf/.

Usage guidelines

The directory must exist before you start AFP Download Plus.

applid

This single-valued attribute specifies the name of the VTAM® application-program node for an FSA when PSF is printing to an SNA-attached printer in deferred-printing mode.

ISPF field name

Applid

Allowed values

You can enter a valid combination of 1–8 letters (a-z, A-Z), numbers (0–9), and special characters (# $ @). The first character cannot be numeric. Blanks and other special characters are not allowed. If a value contains special characters, enclose the value in quotation marks.

blank-compression

This single-valued attribute specifies whether PSF compresses blanks in line data. Blank compression is a data-compression function in PSF that reduces the amount of data sent through the attachment. PSF compresses blanks in line data that contains more than five contiguous blanks.

ISPF field name

Blank compression

Allowed values

You can enter one of these fixed values:

yes: PSF compresses blanks.
no: PSF does not compress blanks (default).

Usage guidelines

Blank compression for host-connected, channel-attached printers most likely does not improve data transmission.

capture-inline-resources

This single-valued attribute specifies whether PSF tells a connected DPF to capture and store inline resources.

ISPF field name

Capture inline resources

Allowed values

You can enter one of these fixed values:

yes: DPF captures inline resources.
no: DPF does not capture inline resources (default).

channel-buffer-count

This single-valued attribute specifies the number of 32 KB (32768 bytes) buffers that are needed for processing jobs on a channel-attached printer.

ISPF field name

Channel buffer count

Allowed values

You can enter an integer from 1 to 10000. This value is multiplied by 32 KB (32768 bytes) to determine the total amount of reserved storage.

chars

This multi-valued, list attribute specifies the names of the coded fonts that are used to print a data set on a printer.

ISPF field name

Character sets

Allowed values

You can enter 1–4 coded font names. Each name can be any combination of 1–4 letters (a-z, A-Z), numbers (0–9), and special characters (# $ @). Blanks and other special characters are not allowed. If a value contains special characters, enclose the value in quotation marks. Lowercase letters are converted to uppercase. For valid coded font names, see IBM® AFP Fonts: Font Summary for AFP Font Collection.

If you specify more than one value, separate the values by spaces and enclose the list of values in braces. For example:

chars={GT12 GB12 GI12}

close-libraries-when-idle

This single-valued attribute specifies whether PSF closes the resource libraries when there is no print activity for 60 seconds.

ISPF field name

Close libraries when idle

Allowed values

You can enter one of these fixed values:

yes: PSF closes resource libraries.
no: PSF does not close resource libraries (default).

Usage guidelines

Closing the resource libraries causes the operating system to free the fixed storage below the 16 MB line that is required for I/O to the resource libraries. However, this function adds the overhead of closing and reopening the libraries between print activity.

color-map

This single-valued attribute specifies the name of the object container for the color mapping table resource that PSF uses to print a data set containing color translation information. This attribute is only used when the printer supports color mapping table resources.

ISPF field name

Color map

Allowed values

Default value

If a color map is not specified for the print job or printer, PSF uses an internal color mapping table.

com-setup-member

This single-valued attribute specifies the name of the object container for the microfilm setup resource that PSF uses to print data on a microfilm device. This attribute is only used when sending output to a microfilm device.

ISPF field name

Com setup member

Allowed values

compression

This single-valued attribute indicates whether PSF compresses data before sending it to the AFP Download Plus receiver.

ISPF field name

Compression

Allowed values

You can enter one of these fixed values:

lzw: PSF uses the LZW compression algorithm to compress data.
none: PSF does not compress data (default).

consolidate-im1-images

This single-valued attribute specifies whether PSF consolidates a multiple-celled IM1 image into a single Image Object Content Architecture (IOCA) image.

ISPF field name

Consolidate IM1 images

Allowed values

You can enter one of these fixed values:

yes: PSF consolidates a multiple-celled IM1 image into a single IOCA image.
no: PSF converts a multiple-celled IM1 image to multiple IOCA images (default).

cse-check-fit

This single-valued attribute specifies how PSF checks the pages for cut-sheet emulation (CSE) mode.

ISPF field name

Check CSE fit

Allowed values

You can enter one of these fixed values:

no: PSF does not check to see whether the page fits 2 up on the sheet (default).
first: PSF only checks the first page printed for a new copy group to see if it fits 2 up on the sheet.
all: PSF checks front side of all pages to see if they fit 2 up on the sheet.

cse-orientation

This single-valued attribute specifies whether PSF generates portrait or landscape pages for printing in cut-sheet emulation (CSE) mode.

ISPF field name

CSE orientation

Allowed values

You can enter one of these fixed values:

portrait: PSF generates portrait pages (default).
landscape: PSF generates landscape pages.

cse-preserve-page-position

This single-valued attribute indicates whether PSF preserves page placement when it repositions because of error recovery or an operator command. This attribute applies only when PSF is printing in cut-sheet emulation (CSE) mode.

If you specify yes, you must also specify cse-sheet-eject=yes.

ISPF field name

CSE preserve page position

Allowed values

You can enter one of these fixed values:

yes: Page placement is preserved.
no: Page placement is not preserved (default).

cse-sheet-eject

This single-valued attribute indicates whether PSF starts printing each data set and each copy of a data set on a new sheet of paper when PSF is printing in cut-sheet emulation (CSE) mode.

ISPF field name

CSE sheet eject

Allowed values

You can enter one of these fixed values:

yes: PSF starts printing on a new sheet. PSF also starts printing on a new sheet whenever it does offset stacking. For example, when the form definition requests separation for a new copy group.
no: PSF starts printing on the next sheet or, in N_UP printing, on the next front-side partition. The next front-side partition might occur on the same sheet. This is the default.

default-process-mode

This single-valued attribute specifies the default processing mode PSF uses to print data sets containing both single-byte and double-byte fonts.

ISPF field name

Default process mode

Allowed values

PSF ignores all values but these fixed values:

SOSI1: Each shift-out, shift-in code is converted to a blank and a Set Coded Font Local text control (default).
SOSI2: Each shift-out, shift-in code is converted to a Set Coded Font Local text control.
SOSI3: The shift-out code is converted to a Set Coded Font Local text control. The shift-in code is converted to a Set Coded Font Local text control and two blanks.
SOSI4: Each shift-out, shift-in code is skipped and not counted when calculating offsets for the print data set. SOSI4 is used when double-byte character set (DBCS) text is converted from ASCII to EBCDIC.

description

This single-valued attribute describes the FSA definition. The description can help you select an FSA definition from a list.

ISPF field name

Description

Allowed values

You can enter any combination of 1–256 letters (a-z, A-Z), numbers (0–9), blanks, and special characters (such as # $ @ ! = / -). If the value contains blanks or special characters, enclose the value in quotation marks.

direct-download

This single-valued attribute indicates whether PSF sends MO:DCA-P data directly to the AFP Download Plus receiver without first storing the data in a temporary file on the z/OS system.

ISPF field name

Direct download

Allowed values

You can enter one of these fixed values:

none: PSF does not send MO:DCA-P data directly to the AFP Download Plus receiver (default).
modca-p: PSF sends MO:DCA-P data directly to the AFP Download Plus receiver.

Usage guidelines

The modca-p value can improve performance.
If direct-download=modca-p, the AFP Download Plus receiver must support the direct download method of receiving MO:DCA-P data.
This attribute applies to PSF V4R4 or later. Earlier releases ignore it.

disconnect-action

This single-valued attribute specifies the action that PSF takes when the time specified by the printer-disconnect-interval attribute expires and no output is available from JES. This attribute is only for SNA-attached and TCP/IP-attached printers.

ISPF field name

Disconnect action

Allowed values

You can enter one of these fixed values:

stop: PSF stops the printer FSA, which can then be restarted only by an operator command.
redrive: PSF redrives the printer FSA according to the value specified by the printer-management-mode attribute (default).

display-afpdp-status

This single-valued attribute specifies whether PSF displays the processing and transmission status of AFP Download Plus on the console.

ISPF field name

Display status

Allowed values

You can enter one of these fixed values:

yes: PSF displays the status.
no: PSF does not display the status (default).

Usage guidelines

This attribute applies to PSF V4R4 or later. Earlier releases ignore it.

dump-code

This single-valued attribute specifies a PSF reason code or a restartable abend reason code that causes a conditional dump of the PSF address space when the reason code occurs.

ISPF field name

Dump: Code

Allowed values

You can enter an integer from 0 to 2147483647 or a 7–8 character hexadecimal value. A PSF reason code is an 8-character hexadecimal value. An abend reason code is a 7-character hexadecimal value. The first three characters are always ABD. When you enter a hexadecimal value (which is suggested), you can enter the hexadecimal characters only or the hexadecimal characters with a prefix of 0x. For example, enter the dump-code attribute in one of these ways:

dump-code=09600c00
dump-code=0x09600c00
dump-code=157289480

dump-message-id

This single-valued attribute specifies a PSF message that causes a conditional dump of the PSF address space when the message occurs.

ISPF field name

Dump: Message ID

Allowed values

You can enter a value in the format APSnnnnt:

nnnn

Three to four digit message number

t

One of these type codes:

A: Message requiring operator action
I: Information message

eject-to-front-facing

This single-valued attribute specifies whether PSF is to tell your continuous-forms printer to do an eject to front facing before the job-header page, before the start of a new document, or both.

ISPF field name

Eject to front facing

Allowed values

You can enter one of these fixed values:

none: Eject to front facing is not done (default).
job: Eject to front facing is done before the job-header page.
document: Eject to front facing is done between documents in a data set.
both: Eject to front facing is done before the job-header page and between documents.

end-sna-conversation

This single-valued attribute specifies whether PSF ends the SNA LU1 conversation between print jobs while maintaining the SNA session with the printer when the NPRO timer expires or after no job is available for one minute and the last page printed has been stacked.

ISPF field name

End SNA conversation

Allowed values

You can enter one of these fixed values:

yes: PSF ends the SNA LU1 conversation with the printer.
no: PSF maintains the SNA LU1 conversation between print jobs (default).

error-disposition-supported

This single-valued attribute specifies whether PSF honors the error disposition requested for a data set when PSF ends a data set because an error occurs during processing.

ISPF field name

Error disposition supported

Allowed values

You can enter one of these fixed values:

yes: PSF honors the requested error disposition.
no: PSF does not honor the requested error disposition (default).

failure-action

This single-valued attribute specifies the PSF action after a printer failure, an SNA session failure, or a TCP/IP network failure.

ISPF field name

Failure action

Allowed values

You can enter one of these fixed values:

stop: PSF must be restarted by an operator command.
connect: PSF establishes a connection or waits for the printer (default).

form-definition

This single-valued attribute specifies the name of the default form definition that defines how a data set is printed. This attribute is required; however, if the job submitter specifies a form definition, it overrides the form definition in this attribute.

ISPF field name

Form definition

Allowed values

You can enter a valid combination of 1–8 letters (a-z, A-Z), numbers (0–9), and special characters (# $ @). Blanks and other special characters are not allowed. If a value contains special characters, enclose the value in quotation marks. Lowercase letters are converted to uppercase.

You can specify the form definition name with or without the F1 prefix. However, if the name of the form definition, without the F1 prefix, starts with F1, specify the full name. For example, F1F1USER.

fsa-trace-dsname

This single-valued attribute specifies the data set to which PSF directs an FSA trace when trace-mode=full, trace-mode=ipds, trace-mode=limit, or trace-mode=sync.

ISPF field name

FSA trace dsname

Allowed values

You can enter a valid data set name that is allocated before the PSF FSA is started.

fsa-type

This single-valued attribute specifies the type of FSA.

Allowed values

You can enter one of these fixed values:

afp-download-plus: An FSA for the AFP Download Plus feature of PSF.
ip-printway: An FSA for IP PrintWay basic mode.
psf-channel: An FSA for a channel-attached printer controlled by PSF.
psf-sna: An FSA for an SNA-attached printer controlled by PSF.
psf-tcpip: An FSA for a TCP/IP-attached printer controlled by PSF.

global-overlay

This single-valued attribute specifies the member name of a medium overlay that the printer places on every sheet of output, including separator pages and message pages.

ISPF field name

Overlay

Allowed values

You can enter a combination of 1–8 letters (a-z, A-Z), numbers (0–9), and special characters (# $ @). The first character cannot be numeric. Blanks and other special characters are not allowed. If a value contains special characters, enclose the value in quotation marks. Lowercase letters are converted to uppercase.

goca-box-supported

This single-valued attribute indicates whether the printer supports Graphics Object Content Architecture (GOCA) Box drawing orders.

ISPF field name

GOCA Box orders

Allowed values

You can enter one of these fixed values:

yes: The printer supports the orders.
no: The printer does not support the orders (default).

Usage guidelines

This attribute affects how line data is transformed to MO:DCA-P before it is sent to the AFP Download Plus receiver.

goca-fractional-line-supported

This single-valued attribute indicates whether the printer supports Graphics Object Content Architecture (GOCA) Set Fractional Line Width drawing orders.

ISPF field name

GOCA Set Fractional Line Width orders

Allowed values

You can enter one of these fixed values:

yes: The printer supports the orders.
no: The printer does not support the orders (default).

Usage guidelines

This attribute affects how line data is transformed to MO:DCA-P before it is sent to the AFP Download Plus receiver.

goca-process-color-supported

This single-valued attribute indicates whether the printer supports Graphics Object Content Architecture (GOCA) Set Process Color drawing orders.

ISPF field name

GOCA Set Process Color orders

Allowed values

You can enter one of these fixed values:

yes: The printer supports the orders.
no: The printer does not support the orders (default).

Usage guidelines

This attribute affects how line data is transformed to MO:DCA-P before it is sent to the AFP Download Plus receiver.

highlight-communications-failure-message

This single-valued attribute specifies whether PSF highlights the message that it writes to the z/OS console when a communications failure occurs with the printer (message APS6501A). Highlighting the communications failure message can help you detect a problem that requires attention because the message remains on the console until the operator deletes it. This attribute applies to TCP/IP-attached printers.

ISPF field name

Highlight communications failure message

Allowed values

You can enter one of these fixed values:

yes: PSF highlights the communications failure message.
no: PSF does not highlight the communications failure message (default).

image-output-format

This single-valued attribute indicates the format that PSF uses for all image data that it sends to the AFP Download Plus receiver.

ISPF field name

Image output format

Allowed values

You can enter one of these fixed values:

ioca: Image data is in uncompressed Image Object Content Architecture (IOCA) format (default).
unchanged: Image data is in the same format as in the input document.

Usage guidelines

This attribute affects how line data is transformed to MO:DCA-P before it is sent to the AFP Download Plus receiver.

inhibit-recovery

This single-valued attribute indicates whether PSF inhibits error recovery for a job so that data is only resent to the printer if it has not already printed.

ISPF field name

Inhibit recovery

Allowed values

You can enter one of these fixed values:

yes: Error recovery is inhibited and data is only resent if it has not printed.
no: Recovery is not inhibited and data is resent from the point of the error (default).

inline-bcoca-objects

This single-valued attribute indicates whether PSF includes Bar Code Object Content Architecture (BCOCA) objects inline with the documents it send to the AFP Download Plus receiver.

ISPF field name

Bar code objects (BCOCA)

Allowed values

You can enter one of these fixed values:

yes: PSF includes BCOCA objects inline (default).
no: PSF does not include BCOCA objects inline.

inline-color-management-resources

This single-valued attribute indicates whether PSF includes color management resources (CMRs) inline with the documents it sends to the AFP Download Plus receiver.

ISPF field name

Color management resources

Allowed values

You can enter one of these fixed values:

all: PSF includes all CMRs that are on the sending system. If you specify this value, transmission time is longer because CMRs can be quite large. Specify this value if the receiving system does not contain CMRs.
generic: PSF includes all generic CMRs and all CMRs that the data stream references. Specify this value if any documents use CMRs that are not on the receiving system. Device-specific CMRs must reside on the receiving system or in the printer. This value is the default.
none: PSF does not include any CMRs inline. Specify this value if the CMRs reside on the receiving system.

inline-foca-objects

This single-valued attribute indicates whether PSF includes Font Object Content Architecture (FOCA) objects inline with the documents it sends to the AFP Download Plus receiver.

ISPF field name

Font objects (FOCA)

Allowed values

You can enter one of these fixed values:

yes: PSF includes FOCA objects inline (default).
no: PSF does not include FOCA objects inline.

inline-form-definitions

This single-valued attribute indicates whether PSF includes form definitions inline with the documents it sends to the AFP Download Plus receiver.

ISPF field name

Form definitions

Allowed values

You can enter one of these fixed values:

yes: PSF includes form definitions inline (default).
no: PSF does not include form definitions inline.

inline-goca-objects

This single-valued attribute indicates whether PSF includes Graphics Object Content Architecture (GOCA) objects inline with the documents it sends to the AFP Download Plus receiver.

ISPF field name

Graphics objects (GOCA)

Allowed values

You can enter one of these fixed values:

yes: PSF includes GOCA objects inline (default).
no: PSF does not include GOCA objects inline.

inline-ioca-objects

This single-valued attribute indicates whether PSF includes Image Object Content Architecture (IOCA) objects inline with the documents it sends to the AFP Download Plus receiver.

ISPF field name

Image objects (IOCA)

Allowed values

You can enter one of these fixed values:

yes: PSF includes IOCA objects inline (default).
no: PSF does not include IOCA objects inline.

inline-object-containers

This single-valued attribute indicates whether PSF includes object containers inline with the documents it sends to the AFP Download Plus receiver.

ISPF field name

Object containers

Allowed values

You can enter one of these fixed values:

yes: PSF includes object containers inline (default).
no: PSF does not include object containers inline.

inline-overlays

This single-valued attribute indicates whether PSF includes overlays inline with the documents it sends to the AFP Download Plus receiver.

ISPF field name

Overlays

Allowed values

You can enter one of these fixed values:

yes: PSF includes overlays inline (default).
no: PSF does not include overlays inline.

inline-page-segments

This single-valued attribute indicates whether PSF includes page segments inline with the documents it sends to the AFP Download Plus receiver.

ISPF field name

Page segments

Allowed values

You can enter one of these fixed values:

yes: PSF includes page segments inline (default).
no: PSF does not include page segments inline.

inline-ptoca-objects

This single-valued attribute indicates whether PSF includes Presentation Text Object Content Architecture (PTOCA) objects inline with the documents it sends to the AFP Download Plus receiver.

ISPF field name

Presentation text objects (PTOCA)

Allowed values

You can enter one of these fixed values:

yes: PSF includes PTOCA objects inline (default).
no: PSF does not include PTOCA objects inline.

Usage guidelines

This attribute applies to PSF V4R4 or later. Earlier releases ignore it.

inline-truetype-fonts

This single-valued attribute indicates whether PSF includes TrueType and OpenType fonts inline with the documents it sends to the AFP Download Plus receiver.

ISPF field name

TrueType fonts

Allowed values

You can enter one of these fixed values:

yes: PSF includes TrueType and OpenType fonts fonts inline (default).
no: PSF does not include TrueType and OpenType fonts fonts inline.

input-tray-substitutions

This multi-valued, value-map attribute associates one input tray number with two substitute tray numbers: one tray number for jobs that print on a single side of the paper and another tray number for jobs that print on both sides of the paper.

ISPF field name

Input Tray Substitutions

Allowed values

One to four sets of values in the format: input_tray -> {simplex_tray duplex_tray}:

input_tray: An integer from 1–255 that identifies the tray specified for the job in the INTRAY JCL parameter, the input-tray-number job attribute, or the form definition PSF uses to print the job.
simplex_tray: An integer from 1–255 that identifies the tray PSF is to use for jobs printed on a single side of the paper.
duplex_tray: An integer from 1–255 that identifies the tray PSF is to use for jobs printed on both sides of the paper.

To determine the tray numbers for your printer, see the printer documentation.

Enclose the entire values in braces. For example:

input-tray-substitutions = { 1 ->{1 3} 2 -> {2 4} }

In this example:

When the job submitter specifies tray 1, PSF uses tray 1 for jobs that print on a single side of the paper and tray 3 for jobs that print on both sides of the paper.
When the job submitter specifies tray 2, PSF uses tray 2 for jobs that print on a single side of the paper and tray 4 for jobs that print on both sides of the paper.

Default value

PSF does not use substitute tray numbers.

Usage guidelines

Specify this attribute when the same side-sensitive or edge-sensitive paper is loaded in different trays in two different directions. That is, in one direction for printing on a single side of the paper and in another direction for printing on both sides of the paper.

interrupt-message-page

This single-valued attribute specifies whether the interrupt message page that PSF inserts in your printed output is printed.

ISPF field name

Interrupt message page

Allowed values

You can enter one of these fixed values:

print: An interrupt message page is printed (default).
suppress: An interrupt message page is not printed.

interrupt-message-page-copies

This single-valued attribute specifies the number of copies PSF produces of the interrupt message page when the mark-interrupt-message-page attribute is specified.

ISPF field name

Interrupt message page: Copies

Allowed values

You can enter an integer from 1 (default) to 10.

ioca-replicate-trim-supported

This single-valued attribute indicates whether the printer supports the Image Object Content Architecture (IOCA) Replicate and Trim function.

ISPF field name

IOCA replicate and trim function

Allowed values

You can enter one of these fixed values:

yes: The printer supports the function.
no: The printer does not support the function (default).

Usage guidelines

This attribute affects how line data is transformed to MO:DCA-P before it is sent to the AFP Download Plus receiver.

issue-intervention-messages

This single-valued attribute specifies whether PSF displays intervention messages on the z/OS system console. An intervention message means that a printer has a physical problem, such as a paper jam or an open paper tray. After an operator fixes the problem, the printer starts printing again. This attribute applies to SNA-attached and TCP/IP-attached printers.

ISPF field name

Issue intervention messages

Allowed values

You can enter one of these fixed values:

yes: Intervention messages are displayed.
no: Intervention messages are not displayed.

Default value

Intervention messages are not displayed.

issue-setup-messages

This single-valued attribute specifies the setup parameters for which JES should display setup messages on the z/OS system console when an SNA-attached or TCP/IP-attached printer is initialized and at the start of any job that specifies a change in a setup parameter from what is active for the printer.

ISPF field name

Issue setup messages

Allowed values

You can enter one of these fixed values:

none: Do not display setup messages (default).
burst: Display setup messages for the BURST setup parameter.
forms: Display setup messages for the FORMS setup parameter.
all: Display setup messages for both BURST and FORMS setup parameters.

label-data-pages

This single-valued attribute specifies whether the security label is printed on each page of printed output. The security label is determined by the SECLABEL parameter of the JOB JCL statement.

ISPF field name

Label data pages

Allowed values

You can enter one of these fixed values:

yes: The security label determined by SECLABEL is printed.
no: The security label is not printed.

Default value

If this attribute is not specified, PSF sets the value to yes if PSFMPL is active (default) or to no if PSFMPL is not active. For more information, see PSF for z/OS: Security Guide.

label-separator-pages

This single-valued attribute specifies whether the security label is printed on a separator page. The security label is determined by the SECLABEL parameter of the JOB JCL statement.

ISPF field name

Label separator pages

Allowed values

You can enter one of these fixed values:

yes: The security label determined by SECLABEL is printed.
no: The security label is not printed.

Default value

If this attribute is not specified, PSF sets the value to yes if PSFMPL is active (default) or to no if PSFMPL is not active. For more information, see PSF for z/OS: Security Guide.

location

This single-valued attribute lets you specify the location of the printer or the AFP Download Plus receiver. The location can help users find printers or AFP Download Plus receivers.

ISPF field name

Location

Allowed values

Any combination of 1–256 letters (a-z, A-Z), numbers (0-9), blanks, and special characters (such as # $ @ ! = / -). If a value contains blanks or special characters, enclose the value in quotation marks.

Default value

None.

Usage guidelines

If you use the same format to specify the location in all FSA definitions (for example: Bldg 3/Col 2), users can find all printers or AFP Download Plus receivers with similar locations, such as all printers in building 3.

logmode

This single-valued attribute specifies the name of the VTAM logon-mode table entry, which defines the session parameters for an SNA-attached printer.

ISPF field name

Logmode

Allowed values

luname

This single-valued attribute specifies the unique, logical-unit name of an SNA-attached printer.

ISPF field name

LU name

Allowed values

map-to-outline-fonts

This single-valued attribute specifies whether PSF maps fonts to outline fonts.

ISPF field name

Map to outline fonts

Allowed values

You can enter one of these fixed values:

yes: PSF uses system and user mapping tables to map fonts to corresponding outline fonts.
no: PSF does not map fonts to outline fonts (default).

Usage guidelines

Specify map-to-outline-fonts=yes if your printer supports outline fonts, you have existing applications that use raster fonts, and you want to use outline fonts without changing the applications.

mark-interrupt-message-page

This single-valued attribute specifies whether PSF marks the interrupt message page with form marks.

ISPF field name

Interrupt message page: Mark page

Allowed values

You can enter one of these fixed values:

yes: PSF marks the interrupt message page with form marks.
no: PSF does not mark the interrupt message page (default).

mcf-name

This single-valued attribute specifies how PSF builds the Map Coded Font (MCF) Format 2 structured field in the data it sends to the AFP Download Plus receiver.

ISPF field name

Map Coded Font (MCF) Format 2 Name

Allowed values

You can enter one of these fixed values:

coded-font: PSF uses the name of the coded font to build the MCF structured field. Specify this value for documents that contain double-byte character set (DBCS) fonts.
codepage-character-set: PSF uses the names of the code page and character set to build the MCF structured field (default).

Usage guidelines

This attribute affects how line data is transformed to MO:DCA-P before it is sent to the AFP Download Plus receiver.

message-count-before-dump

This single-valued attribute specifies the number of times the message specified by the dump-message-id attribute is sent before PSF produces a conditional dump.

ISPF field name

Dump: Count

Allowed values

You can enter an integer from 1 (default) to 99.

name

This single-valued attribute specifies the name of the FSA. This name must be a unique name in the Printer Inventory and it must match the name on the JES initialization statement.

Note:

This is a non-settable attribute. Do not specify the name attribute on the PIDU create, force-create, or modify command. Instead, specify the name as an operand on the command. However, you can specify the name attribute when you construct a condition for the where predicate on the list and export commands.

ISPF field name

FSA name

Allowed values

None.

no-response-action

This single-valued attribute specifies what action PSF takes when the time specified by the response-timeout attribute expires and a response has not been received from the printer or from the AFP Download Plus receiver.

ISPF field name

No response action

Allowed values

You can enter one of these fixed values:

notify-jes: PSF notifies JES that an expected response was not received (default).
notify-user: PSF sends a message to the user ID specified by the no-response-notify attribute and to JES indicating that an expected response was not received.
notify-operator: PSF sends a message to the system operator and to JES indicating that an expected response was not received.
terminate: PSF stops the printer FSA or the AFP Download Plus FSA. The system operator must issue a command to restart the FSA. The active data set is restarted from the last checkpoint.

Usage guidelines

This attribute applies to AFP Download Plus V4R4 or later. Earlier releases ignore it.

no-response-notify

This single-valued attribute specifies the user ID to which PSF sends a message when an expected response is not received from the printer or from the AFP Download Plus receiver before time expires. This attribute is used when no-response-action=notify-user.

ISPF field name

No response action: Notify

Allowed values

Specify the value in the format node.userid:

node: The node associated with the user ID. Specify from 1–8 alphanumeric or national ($, #, @) characters. Lowercase letters are converted to uppercase.
The node is required.
userid: The user ID. Specify from 1–8 alphanumeric or national ($, #, @) characters. The first character must be alphabetic or national. Lowercase letters are converted to uppercase.

Usage guidelines

This attribute applies to AFP Download Plus V4R4 or later. Earlier releases ignore it.

offset-interrupt-message-page

This single-valued attribute specifies whether offset stacking is required for the interrupt message page.

ISPF field name

Interrupt message page: Offset page

Allowed values

You can enter one of these fixed values:

yes: The printed output is offset stacked, beginning at the interrupt message page.
no: No offset stacking is done for the interrupt message page (default).

offset-stacking

This single-valued attribute controls when PSF does offset stacking. You can use offset stacking to separate printed output on cut-sheet printers and on continuous-forms printers that support offset stacking.

ISPF field name

Offset stacking

Allowed values

You can enter one of these fixed values:

dataset: PSF does offset stacking at the start of a new data set or copy of a data set.
job: PSF does offset stacking at the start of a new job.
none: PSF does not do offset stacking.

Usage guidelines

This attribute lets you control offset stacking separately from copy marking. If you select a value in this attribute for a printer that supports offset stacking, the COPYMARK parameter (in the JES initialization statement) and the suppress-copy-marks attribute control only copy marking and not offset stacking.
If you do not specify this attribute, the COPYMARK parameter and the suppress-copy-marks attribute control both copy marking and offset stacking.
PSF uses the value in this attribute for all jobs unless you override the value in a PSF Exit 7 Begin Data Set (BDS) call.

oid-format-supported

This single-valued attribute indicates whether the printer supports the Object Identifier (OID) format for TrueType and OpenType fonts.

ISPF field name

Object identifier (OID) format

Allowed values

You can enter one of these fixed values:

yes: The printer supports the OID format.
no: The printer does not support the OID format (default).

Usage guidelines

This attribute affects how line data is transformed to MO:DCA-P before it is sent to the AFP Download Plus receiver.

operator-security-profile

This single-valued attribute specifies the name of the RACF® resource profile in the PRINTSRV class that controls who can work with this PSF printer or AFP Download Plus sender using Infoprint Central.

ISPF field name

Operator security profile

Allowed values

A combination of letters, numbers, and special characters except for commas, semicolons, parentheses, and blanks. If the value contains special characters, enclose it in single or double quotation marks. Lowercase letters are converted to uppercase. Do not start names with AOP. For example:

operator-security-profile = "DENVER.001"

Usage guidelines

To authorize users to a group of printers, specify the same profile name in the PSF FSA definitions and IP PrintWay printer definitions for all the printers in the group.
If you have defined profiles in the OPERCMDS class that protect operator commands, users must have the appropriate level of access to those profiles to work with the printer. This is true whether or not you specify a profile in this attribute.
For information about the PRINTSRV class, see z/OS Infoprint Server Customization.

Default value

None.

override-3800-default-font

This single-valued attribute specifies whether PSF tells the 3800 to replace the hardware default font with the first font in the current font list.

ISPF field name

3800 compatibility: Override default font

Allowed values

You can enter one of these fixed values:

yes: PSF lets the printer replace the hardware default font.
no: The printer uses the hardware default font (default).

page-accounting-supported

This single-valued attribute indicates whether PSF sends information, such as the number of pages and sheets in a data set, to the AFP Download Plus receiver. The AFP Download Plus receiver can use the information to provide more accurate accounting information.

ISPF field name

Page accounting supported

Allowed values

You can enter one of these fixed values:

yes: PSF sends accounting information to the AFP Download Plus receiver.
no: PSF does not send accounting information (default).

Usage guidelines

Select this option if the AFP Download Plus receiver supports the -opagecount and -osheetcount parameters.

page-definition

This single-valued attribute specifies the name of the default page definition that defines how a data set is printed. This attribute is required; however, if the job submitter specifies a page definition, it overrides the page definition in this attribute.

ISPF field name

Page definition

Allowed values

You can specify the page definition name with or without the P1 prefix. However, if the name of the page definition, without the P1 prefix, starts with P1, specify the full name. For example, P1P1USER.

paper-length

This single-valued attribute specifies the length of the paper that is loaded in the printer. The 3800 Line-Mode Conversion and Line-Mode Migration functions in AFP Download Plus can use this value to format line data.

ISPF field name

Paper length

Allowed values

A value in the format nnnn.mmmuu:

nnnn

A number from 0 to 9999. You must specify at least one digit to the left of the decimal point.

mmm

A number from 0 to 999. The decimal point and the digits after it are optional.

uu

One of these fixed values:

IN: Inches
CM: Centimeters
MM: Millimeters
PELS: Picture elements (1/240 inch)
POINTS: Points (1/72 inch)

The default is 14IN.

Usage guidelines

If you specify the unit as PELS or POINTS, specify the value as a whole number with no decimal point.
This attribute applies to PSF V4R4 or later. Earlier releases ignore it.

paper-width

This single-valued attribute specifies the width of the paper that is loaded in the printer. The 3800 Line-Mode Conversion and Line-Mode Migration functions in AFP Download Plus can use this value to format line data.

ISPF field name

Paper width

Allowed values

A value in the format nnnn.mmmuu:

nnnn

A number from 0 to 9999. You must specify at least one digit to the left of the decimal point.

mmm

A number from 0 to 999. The decimal point and the digits after it are optional.

uu

One of these fixed values:

IN: Inches
CM: Centimeters
MM: Millimeters
PELS: Picture elements (1/240 inch)
POINTS: Points (1/72 inch)

The default is 13.2IN.

Usage guidelines

If you specify the unit as PELS or POINTS, specify the value as a whole number with no decimal point.
This attribute applies to PSF V4R4 or later. Earlier releases ignore it.

port-number

This single-valued attribute specifies the port number with which PSF is to establish a connection to a TCP/IP-attached printer or to an AFP Download Plus receiver. The value in this attribute must match the TCP/IP port number in the printer or the AFP Download Plus receiver.

ISPF field name

Port number

Allowed values

You can enter an integer from 1 to 65535. The default is 5001.

print-error-messages

This single-valued attribute specifies whether PSF should print error messages at the end of a data set. If fsa-type=afp-download-plus, PSF saves all messages in a file on the z/OS system instead of printing them.

ISPF field name

Print error messages

Allowed values

You can enter one of these fixed values:

yes: PSF prints or saves error messages until an error occurs that ends processing (default).
no: PSF does not print or save error messages unless an error occurs that ends processing. If that happens, only the message group describing the last error is printed or saved.

print-error-messages-maximum

This single-valued attribute specifies the maximum number of message groups that PSF generates when print-error-messages=yes. When the maximum number is reached, PSF stops processing the data set and deletes it from the JES spool.

ISPF field name

Print error messages: Maximum messages

Allowed values

You can enter an integer from 0 to 999. A value of 0 means the data set is processed until it completes or an error occurs that ends processing of the data set. The default is 16.

print-error-reporting

This single-valued attribute specifies whether the printer reports character and position errors to PSF. Character errors are caused by trying to use a code point that is not assigned to a character in a font. Position errors are caused by trying to print outside the printable area.

ISPF field name

Print error reporting

Allowed values

You can enter one of these fixed values:

none: Do not report any character or position errors (default).
all: Report all character and position errors.
character: Report only character errors.
position: Report only position errors.

printer-acquire-interval

This single-valued attribute specifies the number of seconds between the time PSF releases a printer and when PSF tries to acquire it again. This attribute is only used when printer-release-mode=time.

ISPF field name

Acquire interval

Allowed values

You can enter an integer from 0 (default) to 86400.

printer-connect-interval

This single-valued attribute specifies the number of seconds during which PSF attempts to connect to a printer or to an AFP Download Plus receiver. When the connect interval expires and the connection is not complete, PSF ends the FSA.

ISPF field name

Connect interval

Allowed values

You can enter an integer from 0 to 86400. 0 means PSF attempts to connect for an unlimited time.

Default value

For channel-attached and SNA-attached printers, if this attribute is not specified blank, PSF attempts to connect for an unlimited time. For TCP/IP-attached printers and for AFP Download Plus receivers, PSF attempts to connect for 600 seconds (10 minutes).

printer-disconnect-interval

This single-valued attribute specifies the number of seconds until PSF ends the session with an SNA-attached or TCP/IP-attached printer.

ISPF field name

Disconnect interval

Allowed values

You can enter an integer from 0 (default) to 86400.

printer-ip-address

This single-valued attribute specifies the Internet Protocol (IP) address or host name of the TCP/IP-attached printer or the AFP Download Plus receiver.

ISPF field name

Printer IP address

Allowed values

Specify a valid IP address or host name. You can specify the IP address in dotted-decimal or colon-hexadecimal format. Blanks are not allowed. If the value contains special characters, enclose it in quotation marks. Examples of printer IP addresses are:

printer-ip-address = 9.99.176.133
printer-ip-address = prt009.net.xyz.com
printer-ip-address = PRT009
printer-ip-address = 2001:0db8:85a3:0000:0000:8a2e:0370:7334

Usage guidelines

If you specify a colon-hexadecimal IP address:

PSF V4R4 or later is required.
You can omit leading zeroes in each hexadecimal value.
You can omit one sequence of repeat zero values.
You can specify the last two hexadecimal values in dotted-decimal notation.

printer-management-mode

This single-valued attribute specifies how PSF controls an SNA-attached or TCP/IP-attached printer in deferred-printing mode.

ISPF field name

Management mode

Allowed values

You can enter one of these fixed values:

immediate: PSF starts a communication session with the printer immediately and then looks for output available on the JES spool.
dialin: PSF starts a session with the printer when the switched line is connected.
outavail: PSF starts a communication session with the printer only when output is available on the JES spool (default).

printer-release-interval

This single-valued attribute specifies the number of seconds after which PSF responds to a request to release a printer in the method specified by the printer-release-mode attribute.

ISPF field name

Release interval

Allowed values

You can enter an integer from 0 (default) to 86400.

printer-release-mode

This single-valued attribute specifies how PSF is to respond to a request to release the printer.

ISPF field name

Release mode

Allowed values

You can enter one of these fixed values:

idle: PSF releases the printer when a request to release has been received and the time specified by the printer-release-interval attribute has expired with no output on the spool for the printer.
time: PSF starts the timer for the release interval when a release request is received, even when there is more output on the spool.
none: PSF does not release the printer (default).

prune-double-byte-fonts

This single-valued attribute specifies whether PSF prunes double-byte raster fonts to reduce the amount of font data sent to the printer.

ISPF field name

Prune double-byte fonts

Allowed values

You can enter one of these fixed values:

yes: PSF prunes double-byte raster fonts (default).
no: PSF does not prune double-byte fonts.

prune-single-byte-fonts

This single-valued attribute specifies whether PSF prunes single-byte raster fonts to reduce the amount of font data sent to the printer.

ISPF field name

Prune single-byte fonts

Allowed values

You can enter one of these fixed values:

yes: PSF prunes single-byte raster fonts (default).
no: PSF does not prune single-byte fonts.

psf-send-default-character

This single-valued attribute specifies whether PSF passes the default character information to the printer by fully populating the outline single-byte code page.

ISPF field name

Send default character

Allowed values

You can enter one of these fixed values:

yes: PSF passes the default character information to the printer.
no: PSF does not pass the default character information to the printer (default).

recover-from-font-not-found

This single-valued attribute specifies whether PSF should make sure the outline font derived from the mapped font exists before proceeding.

ISPF field name

Recover from font not found

Allowed values

You can enter one of these fixed values:

yes: PSF should do library queries to make sure the mapped font exists before loading it.
no: PSF does not need to make sure that the mapped font exists (default).

Usage guidelines

Specify recover-from-font-not-found=yes if your printer supports outline fonts, you have requested that PSF map to outline fonts, and you do not want pages in your job ended because the outline font identified through the mapped font did not exist on the host.
When you specify recover-from-font-not-found=yes, the performance of PSF is degraded because of additional library queries for every mapped font resource.

release-ds-when-repositioning

This single-valued attribute specifies whether PSF should release data sets to JES when PSF repositions.

ISPF field name

Release data set when repositioning

Allowed values

You can enter one of these fixed values:

yes: PSF releases the data sets when repositioning. The data sets might be reselected in a different order.
no: PSF retains data sets during repositioning (default).

report-line-mode-conversion-paper-length-errors

This single-valued attribute indicates whether the 3800 Line-Mode Conversion function in AFP Download Plus reports an error when the paper length in the FCB does not match the value in the paper-length attribute.

ISPF field name

Report Line-Mode Conversion paper length errors

Allowed values

You can enter one of these fixed values:

yes: The Line-Mode Conversion function reports an error. It puts the print job on the hold queue and issues message APS973I.
no: The Line-Mode Conversion function does not report an error. It uses the value in the paper-length attribute (default).

Usage guidelines

This attribute applies to PSF V4R4 or later. Earlier releases ignore it.

resolution

This single-valued attribute specifies the resolution at which the output was formatted. PSF uses this value to choose the associated resolution system library that has previously been defined by the system programmer.

ISPF field name

Resolution

Allowed values

You can enter one of these fixed values:

240: The data was formatted with resources at 240 pels per inch.
300: The data was formatted with resources at 300 pels per inch.

Default value

PSF uses the default system library.

Usage guidelines

The resolution in this attribute is used for all jobs unless the Exit 7 BDSC call overrides it.

response-timeout

This single-valued attribute specifies maximum number of seconds PSF waits for a response from the printer or from the AFP Download Plus receiver.

ISPF field name

Response timeout

Allowed values

You can enter an integer from 0 (default) to 86400.

Usage guidelines

This attribute applies to AFP Download Plus V4R4 or later. Earlier releases ignore it.

restrict-printable-area

This single-valued attribute specifies whether an area on each page of printed output is reserved for the security label.

ISPF field name

Restrict printable area

Allowed values

You can enter one of these fixed values:

yes: An area on each page is reserved for the security label.
no: An area is not reserved for the security label.

Default value

If this attribute is not specified, PSF sets the value to yes if PSFMPL is active (default) or to no if PSFMPL is not active. For more information, see PSF for z/OS: Security Guide.

retained-fonts

This single-valued attribute specifies the maximum number of fonts that PSF retains in printer storage between print jobs.

ISPF field name

Retained fonts

Allowed values

You can enter a value from 0 to 32767. The default value depends on the type of printer and the amount of storage available in the printer.

Usage guidelines

When PSF retains fonts, PSF does not need to reload the same fonts for subsequent jobs. However, retaining fonts requires additional printer storage.
This value overrides the reasonable resource loading value (RRLV) for fonts that you can specify in the PSF Exit 7 initialization call.
For information about RRLVs, see PSF for z/OS: Customization.

retained-form-definitions

This single-valued attribute specifies the maximum number of form definitions that PSF retains in virtual storage between print jobs.

ISPF field name

Retained form definitions

Allowed values

You can enter a value from 0 to 32767. The default value is 6.

Usage guidelines

When PSF retains form definitions, PSF does not need to reload the same form definitions for subsequent jobs. However, retaining form definitions requires additional virtual storage.
This value overrides the reasonable resource loading value (RRLV) for form definitions that you can specify in the PSF Exit 7 initialization call.
For information about RRLVs, see PSF for z/OS: Customization.

retained-object-containers

This single-valued attribute specifies the maximum number of object containers that PSF retains in printer storage between print jobs.

ISPF field name

Retained object containers

Allowed values

You can enter a value from 0 to 32767.

Default value

The default value is 0 for 3800 and 3820 printers. The default value is 200 for all other printers.

Usage guidelines

When PSF retains object containers, PSF does not need to reload the same object containers for subsequent jobs. However, retaining object containers requires additional virtual storage.
This value overrides the reasonable resource loading value (RRLV) for object containers that you can specify in the PSF Exit 7 initialization call.
For information about RRLVs, see PSF for z/OS: Customization.

retained-page-definitions

This single-valued attribute specifies the maximum number of page definitions that PSF retains in virtual storage between print jobs.

ISPF field name

Retained page definitions

Allowed values

You can enter a value from 0 to 32767. The default value is 6.

Usage guidelines

When PSF retains page definitions, PSF does not need to reload the same page definitions for subsequent jobs. However, retaining page definitions requires additional virtual storage.
This value overrides the reasonable resource loading value (RRLV) for page definitions that you can specify in the PSF Exit 7 initialization call.
For information about RRLVs, see PSF for z/OS: Customization.

retained-page-segments

This single-valued attribute specifies the maximum number of page segments that PSF retains in printer storage between print jobs.

ISPF field name

Retained page segments

Allowed values

You can enter a value from 0 (default) to 32767.

Usage guidelines

When PSF retains page segments, PSF does not need to reload the same page segments for subsequent jobs. However, retaining page segments requires additional printer storage.
This value overrides the reasonable resource loading value (RRLV) for page segments that you can specify in the PSF Exit 7 initialization call.
For information about RRLVs, see PSF for z/OS: Customization.

secure-transmission

This single-valued attribute indicates whether PSF encodes data before sending it to the AFP Download Plus receiver.

ISPF field name

Secure transmission

Allowed values

You can enter one of these fixed values:

yes: PSF encodes data (default).
no: PSF does not encode data.

send-messages-on-failure

This single-valued attribute indicates whether PSF sends all messages to the AFP Download Plus receiver when it cannot send an output data set because of an error or because the operator canceled processing of the data set. The receiver can print the messages to help diagnose errors detected on the sending system, such as data stream errors.

ISPF field name

Send messages on failure

Allowed values

You can enter one of these fixed values:

all: PSF sends all messages to the receiver in a message data set in MO:DCA-P format (default).
generic-only: PSF sends a generic message in line data format to the receiver to indicate that the output data was not sent.

send-messages-to-sysout

This single-valued attribute specifies whether PSF sends a message data set to a SYSOUT data set for redirection to another CLASS or DEST for viewing or printing.

ISPF field name

Send msgs to SYSOUT

Allowed values

You can enter one of these fixed values:

yes: PSF sends the message data set to a SYSOUT data set.
no: PSF does not send the message data set to a SYSOUT data set.

send-separator-pages

This single-valued attribute indicates whether PSF sends the job and data set separator pages for each output data set to the AFP Download Plus receiver.

ISPF field name

Send separator pages

Allowed values

You can enter one of these fixed values:

yes: PSF sends separator pages to the receiver.
no: PSF does not send separator pages to the receiver (default).

set-3800-dataset-header-origin

This single-valued attribute specifies whether PSF sets the data set header media origin on continuous-forms printers to the top left corner.

ISPF field name

Set media origin to 3800 origin for: Data set header

Allowed values

You can enter one of these fixed values:

yes: PSF sets the data set header media origin to the top left corner.
no: PSF does not set the data set header media origin to the top left corner (default).

set-3800-dataset-origin

This single-valued attribute specifies whether PSF sets the data set media origin on continuous-forms printers to the top left corner.

ISPF field name

Set media origin to 3800 origin for: Data set

Allowed values

You can enter one of these fixed values:

yes: PSF sets the data set media origin to the top left corner.
no: PSF does not set the data set media origin to the top left corner (default).

set-3800-job-header-origin

This single-valued attribute specifies whether PSF sets the job header media origin on continuous-forms printers to the top left corner.

ISPF field name

Set media origin to 3800 origin for: Job header

Allowed values

You can enter one of these fixed values:

yes: PSF sets the job header media origin to the top left corner.
no: PSF does not set the job header media origin to the top left corner (default).

set-3800-job-trailer-origin

This single-valued attribute specifies whether PSF sets the job trailer media origin on continuous-forms printers to the top left corner.

ISPF field name

Set media origin to 3800 origin for: Job trailer

Allowed values

You can enter one of these fixed values:

yes: PSF sets the job trailer media origin to the top left corner.
no: PSF does not set the job trailer media origin to the top left corner (default).

set-3800-messages-origin

This single-valued attribute specifies whether PSF sets the message data set media origin on continuous-forms printers to the top left corner.

ISPF field name

Set media origin to 3800 origin for: Message data set

Allowed values

You can enter one of these fixed values:

yes: PSF sets the message data set media origin to the top left corner.
no: PSF does not set the message data set media origin to the top left corner (default).

snmp-reporting

This single-valued attribute specifies whether PSF supplies printer status information to the z/OS Simple Network Management Protocol (SNMP) agent.

ISPF field name

SNMP reporting

Allowed values

You can enter one of these fixed values:

yes: SNMP reporting is done (default when Infoprint Central is customized).
no: SNMP reporting is not done (default).

suppress-copy-marks

This single-valued attribute specifies whether PSF should not print copy marks or do offset stacking. This attribute overrides the COPYMARK parameter of the JES initialization statement for the printer.

ISPF field name

Suppress copy marks

Allowed values

You can enter one of these fixed values:

yes: Copy marks are not printed and offset stacking is not done.
no: Copy marks are printed and offset stacking is done if requested in the COPYMARK parameter (default).

Usage guidelines

If you specify suppress-copy-marks=yes and also specify any value in the offset-stacking attribute, PSF suppresses only the printing of copy marks, while the offset-stacking attribute controls when PSF does offset stacking.

trace-mode

This single-valued attribute specifies the type of tracing that is started during FSA initialization. If the FSA has already started, a new trace mode takes effect the next time the FSA starts.

ISPF field name

Trace mode

Allowed values

You can enter one of these fixed values:

none

PSF: No tracing is started during PSF initialization.

IP PrintWay: The tracing mode in the IP PrintWay FSS definition is used for the FSA (default).

internal

PSF: An internal trace is started (default).

IP PrintWay: Only internal tracing is started.

ipds

PSF: An external trace containing only IPDS data is started. An internal trace is also started.

IP PrintWay: IP PrintWay ignores this value.

limit

PSF: An external trace like the full trace is started. However, information in some data buffers is truncated. An internal trace is also started.

IP PrintWay: IP PrintWay ignores this value.

sync

#not PSFONLYPSF: An FSA SYNC external trace is started. An internal trace is also started.

IP PrintWay: IP PrintWay ignores this value.

no-printing

PSF: PSF ignores this value and starts only an internal trace.

IP PrintWay: Internal and external tracing is started, without tracing of record processing. Input records and TCP/IP commands are not traced.

full

PSF and IP PrintWay: An FSA full external trace is started. An internal trace is also started.

Usage guidelines for IP PrintWay only

If you specify full or no-printing, you must start a GTF trace before starting the FSA.
You can use the MODIFY operator command to stop the trace or to start tracing after an FSA has started.
You might not want to start a full trace during peak processor usage.

trace-table-size

This single-valued attribute specifies a number that indicates how many 4 KB pages of storage are allocated for the FSA trace table.

ISPF field name

Trace table size

Allowed values

You can enter an integer from 1 to 999. The default is 32.

transmit-recovery-pages

This single-valued attribute specifies how often PSF synchronizes with the AFP Download Plus receiver to determine if the transmitted data has been received and, if necessary, retransmit data from the recovery point. The recovery point is the last time that PSF successfully synchronized with the AFP Download receiver.

ISPF field name

Recovery pages

Allowed values

A value from 0 to 65535; the default is 1000. When 0 is specified, PSF does not synchronize the transmitted data with the receiver until the end of a file.

Usage guidelines

This attribute applies to PSF V4R4 or later. Earlier releases ignore it.

use-line-mode-migration-linect

This single-valued attribute indicates whether the PSF Line-Mode Migration function uses the number of lines specified in the LINECT parameter when the LINECT value is smaller than the number of lines specified in the FCB.

ISPF field name

Use Line-Mode Migration LINECT

Allowed values

You can enter one of these fixed values:

yes: The Line-Mode Migration function uses the LINECT parameter.
no: The Line-Mode Migration function does not use the LINECT parameter. It uses the FCB value (default).

Usage guidelines

If the LINECT value is larger than the FCB value, the Line-Mode Migration function uses the FCB value whether or not this attribute is specified.
This attribute applies to PSF V4R4 or later. Earlier releases ignore it.

Notices | Terms of use | Support | Contact z/OS | zFavorites