Syntax for a Security Definitions Member

Figure 6 illustrates the syntax for a security definitions library member.

{PAPERNAM papername | PAPERSIZ width_value height_value}
     [ TOP { NARROW | WIDE } ]
	  [ UPAORG xorg_value yorg_value ]
     [ UPADIM xlength_value ylength_value ]
     [ SECOVLY name1 name2...name8 ]		

The parameters and values for a security definitions library member are:

{PAPERNAM papername | PAPERSIZ width_value height_value}

Specifies the size of the paper. You must use either PAPERNAM or PAPERSIZ.

PAPERNAM specifies the system-defined paper names for each paper size. See PAPERNAM Table for System-Defined Paper Names for a list of valid names and the dimensions for each system-defined paper name.

PAPERSIZ specifies the width and height of the paper and the units of measurement, either in inches (IN) or in millimeters (MM). The PAPERSIZ parameter should be used if the size of the paper loaded in the printer does not correspond to one of the PSF system-defined paper names.

The valid values for inches can be from 0 to 22.75. The valid values for millimeters can be from 0 to 577.97. The values do not need to be in the same units and are entered as follows (the decimal point is optional for integer values):

nnn.nn {IN | MM}

See Figure 7 for an example of this parameter.

Note:

Make sure you have a paper definition for every size of paper that might be installed on a printer.

[ TOP { NARROW | WIDE } ]

Specifies which edge of the paper is the top by identifying whether the media origin² is located at the top-left corner of a narrow or wide edge of the paper. The TOP parameter has two options:

• NARROW is the default and specifies that the security overlays and UPA in this security definition entry use the top-left corner of a narrow edge of the paper as the media origin.
• WIDE specifies that the security overlays and UPA in this security definition entry use the top-left corner of a wide edge of the paper as the media origin.

For continuous-forms printers, a security definitions member can contain both a NARROW and WIDE entry if:

• Both narrow and wide forms are used for the security label.³
• The form definition contains page-presentation and print-direction controls that change the default media origin.

For cut-sheet printers, only one entry (NARROW) is needed. Because the media origin for cut sheets is always the top-left corner of a narrow edge, the WIDE option is ignored for cut-sheet forms.

Determine whether to use the WIDE or NARROW entry for continuous-forms printers:

• WIDE for wide forms if the form definition contains LANDSCAPE ACROSS or PORTRAIT DOWN controls
• WIDE for narrow forms if the form definition contains PORTRAIT ACROSS or LANDSCAPE DOWN controls
• NARROW for narrow forms if the form definition contains PORTRAIT ACROSS or LANDSCAPE DOWN controls
• NARROW for wide forms if the form definition contains LANDSCAPE ACROSS or PORTRAIT DOWN controls

For more information about the page-presentation and print-direction controls in a form definition, see Page Printer Formatting Aid: User’s Guide.

See Figure 7 for an example of this parameter.

[ UPAORG xorg_value yorg_value ]

Specifies the origin, in inches (IN) or millimeters (MM), of the UPA.

The origin is expressed as horizontal offsets (xorg) and vertical offsets (yorg) from the media origin for a particular page size and origin.

The valid values for inches can be from 0 to 22.75. The valid values for millimeters can be from 0 to 577.97. The values do not need to be in the same units and are entered as follows (the decimal point is optional for integer values):

nnn.nn {IN | MM}

See Figure 7 for an example of this parameter.

Note:

This parameter is required if Restrict printable area=YES is specified (or is a default) in the Infoprint Server Printer Inventory, SYSAREA=YES is specified (or is a default) in the PRINTDEV statement for the data set, or UPADIM is specified.

[ UPADIM xlength_value ylength_value ]

Specifies the size, in inches (IN) or millimeters (MM), of the UPA.

The size of the UPA is expressed as horizontal (xlength) and vertical (ylength) dimensions of the UPA for a particular page size and origin.

The valid values for inches can be from 0 to 22.75. The valid values for millimeters can be from 0.1 to 577.97. The values do not need to be in the same units and are entered as follows (the decimal point is optional for integer values):

nnn.nn {IN | MM}

See Figure 7 for an example of this parameter.

Note:

This parameter is required if Restrict printable area=YES is specified (or is a default) in the Infoprint Server Printer Inventory, SYSAREA=YES is specified (or is a default) in the PRINTDEV statement for the data set, or UPAORG is specified.

[ SECOVLY name1 name2...name8 ]

Specifies the names of the overlays to be used for this security label on both the separator pages and the data pages.

One to eight overlays can be specified. These overlays must reside in a security overlay library.

See Figure 7 for an example of this parameter.

Notes:

1. Overlay names are restricted to six characters; PSF appends a two-character prefix (O1).
2. If fonts or page segments are used in any of these overlays, the fonts must reside in a security font library and the page segments must reside in a security page-segment library.
3. This parameter is required if Label data pages=YES or Label separator pages=YES is specified in the Infoprint Server Printer Inventory, or DPAGELBL=YES or SPAGELBL=YES is specified in the PRINTDEV statement.