beautypg.com

IBM S544-5285-01 User Manual

Page 116

background image

FORMDEF=

fdefname

|

Specifies the complete file name (in OS/390, MVS and VSE, the member

|

name) of the form definition. The

fdefname can be from 1 to 8 alphanumeric or

|

national characters. Unlike PSF for OS/390, PSF/MVS, PSF/VM, and PSF/VSE,

|

ACIF does not require the name to begin with a F1 prefix, but if the name does

|

begin with F1, you cannot omit it.

|

A form definition defines how a page of data is placed on a form, the number of

|

copies of a page, any modifications to that group of copies, paper source, and

|

duplexing, as well as other functions. ACIF uses a form definition only to

|

retrieve resources; it does not use a form definition to convert data streams.

|

EXAMPLE

|

This example specifies

F1USER10 as the form definition:

|

FORMDEF=F1USER1

|

The form definition you ask ACIF to retrieve may be located:

|

Inline in the file

|

In a user library referenced in the USERLIB parameter (OS/390 and MVS

|

only)

|

In a library referenced in the FDEFLIB parameter (OS/390, MVS, and VM)

|

In a library referenced in the // LIBDEF PHASE,SEARCH=(...) DLBL JCL

|

statement (VSE)

|

Using Form Definitions from an OS/390 or MVS User Library:

|

You can instruct ACIF to retrieve a form definition from your user library instead

|

of from a library specified in the FDEFLIB parameter. To use a form definition

|

from a user library, you must:

|

Reference the user library containing the form definition in the USERLIB

|

parameter

|

Specify the name of the form definition in the FORMDEF parameter

|

Using Inline Form Definitions: To use an inline form definition, you must do

|

the following:

|

Include an inline form definition in the file.

|

If you specify the FORMDEF parameter, the name of the inline form

|

definition must match the name of the specified form definition, or you must

|

specify FORMDEF=DUMMY.

|

If a form definition resource is included inline with the data, the file must be

|

identified as containing carriage control characters. If the length of the

|

records in the form definition is less than or equal to the logical-record

|

length defined for the file, you can specify fixed-length records for the

|

record format. If the length of the records in the form definition is greater

|

than the logical-record length defined for the file, you must:

|

– In OS/390 and MVS, specify variable length records for the record

|

format (variable blocked with ANSI carriage control characters [VBA] or

|

variable blocked with machine carriage control characters [VBM]).

|

– In VM, specify variable length records for the record format.

96

ACIF User’s Guide