Acif, OS/390 | IBM S544-5285-01 guide

Notes:

1. IfPAGEDEFthe

parameter

is

not

specified,

and the

print

file

con

line-mode data, ACIF

reports

an

error

condition

and

terminates

pro

2. If

you PAGEDEF=DUMMYspecify

,

and

you

do

not

include

an

inline

page

definition,

ACIF

reports

an

error

condition

and

terminates process

3. A page definition

is

required

for

processing

line-mode data. AC

error condition and terminates processing if it

encounters

a

line-

record, but no page definition wasPAGEDEFspecifiedparameterin .

PDEFLIB=

data

set

name1[,data

set

][,name2data

set

name]

...(OS/390

and

MVS)

Specifies the files that compose the page

definition

library.

A ma

files can be specified. The parameter also specifies the concate

sequence

when

ACIF

searches

for

a

particular

page definition.

ACIF

for the resourcedata inset name1. If ACIF

cannot find thedataresourceset

in

name1 , it continues the sedarchta

setwith name2, and so

on,

until

it

either

locates the requested resource or

exhausts

the

list

of

specified

EXAMPLE

PDEFLIB=SYS1.PDEFLIB,USER.PDEFLIB

IfUSERLIB

is also specified, ACIF searches for the resource in th

specifiedUSERLIBin

before searching

the

filesPDEFLIBidentified.

in

Notes:

1.The files must be specified as fully-qualified names without qu marks.

2.If the libraries PDEFLIBspecifiedarefornot specified in the same order used by the PSF start-up procedure, the printed and converted r differ. For information on how PSF selects resources,PSF for refer to OS/390: Customization .

3. For

systems

before

MVS/DFP Version

2.3,

files

must

be

concatenate

the

largest

block size

first.

4. This

is

a

required

parameter

if

the

file

contains

any

line-mode

USERLIB

is

not

specified.

If

this

parameter

is

not

specified,

contains any line-mode

data,

ACIF

reports

an

error

condition

and

terminates

processing.

PDEFLIB=

filetype1[,filetype2][,filetype] ...(VM)

Specifies

the

file

types

that

define

the

page-

definition

librarie

8

file

types

can be specified. The parameter also

specifies

the

when

ACIF

searches

for

a

particular

PAGEDEF

resource.

ACIF

first

looks

the

resource

with a filletype1. IfofACIF cannot find

the resource

wit

file typefiletype1of , it continues the searchfiletype2,withand so on,

until it

either

locates

the

requested

resource or

exhausts

the

list

of

sp

EXAMPLE

PDEFLIB=PDEF38PP,TESTPDEF

104 ACIF User’s Guide

Image 124

IBM S544-5285-01 manual Acif, OS/390

Contents

IBM Page IBM Edition 1999 Contents VSE MVS Helpful Hints File Print Services Facility PSF for . OS/390 Glossary Vii VSE Viii Acif User’s Guide Disclaimer Programming InterfacesTrademarks SUN Unix Userlib InsertimmIOB Apar APK252I AparAPK343I Apar APK345I Apar Why Should I Read This Publication? What Do I Need To Know?Xiii MVS VSE AIX Acif MVS AsciiMVS VSE What Terms Are Used In This Publication? Library AIX Related Information Understanding Syntax NotationHighlighting Member Notational Conventions Examples VSE Part 1. Information Common to AIX, OS/390, MVS Acif User’s Guide What Can I Do with ACIF? How Acif Fits into Advanced Function Presentation Using Acif for Different Tasks Using Acif to Prepare Files for Viewing AFP Using Acif to Prepare Files for Distributed Printing Transfer PSF Acif Tasks You Can Do with Acif Content Architecture ReferenceBDT/EDT Presentation Programming Guide and Line Data ReferenceLine Data Reference ForIBM AIX,Page referPrinter to Formatting Indexing With Data Values Literal Values With Literal Example Bank Statement Input File Acif Processing Parameters to Index the Bank Statement Goca, ioca Orrestype=all PDS What Other IBM Products are Related to ACIF? Workbench Viewer AFP Toolbox for Multiple Operating Systems For System LimitationsConsiderations PSF Installpsf.base System PrerequisitesTheformdef Thepagedef VSE Prerequisites Acif User’s Guide Part 2. Using Acif in the AIX Environment Acif User’s Guide Purpose SyntaxAcif Ovlylib=pathlist Description Isnot Ovlylib FontFor Font Collection You can use Acif to prepare S/370 line Data Unformatted FilesFlag Keyword-value Pair With One To specify Job Script Wit Flags and Values Chars= fontname1, fontname2, fontname3, fontname4 IBM AFP Fontname2 TRC Comsetup= name Objconlib Directory/usr/lpp/psf/reslib Fdeflib= pathlistField16 . Error Condition Terminates Processing Record Specifies RelativeLiteral valueX literal value Isanything Other As the default RecordRecord, n RDW Print Services Facility for AIX Print . Administration Stream, newline=X nnIfnewline Fontlib= pathlist 35in Index Index1 Imageout=asisAsis Name,field n ,field n Field Field n Filename Specifies Name Full Path Name for Index ob WhenName For Index Object f Field Indexobj=group all none Indexstartby=1 nnInput. I fileyou specify Variable You Not Specify Inputdd= filename Insertimm=yes39in Usr/lpp/psf/bin/asciinpe Filename Specifies Programname SpecifiesOutput File Into your Current Directory Not Spe Print referServices to Facility For AIX Administration Pagedef= pdefname Parmdd= Pdeflib= pathlist SOSI1 CharsPseglib= pathlist Theacif Respath Reslib= pathlistPseglib Fdef PsegOvly Font Trc=yes no Trigger n = recordTrigger Value X trigger value Trigger1 Instructs Acif Scan Every Record Looking‘ACCOUNT’ ‘PAGE Orfield n Userlib= pathlistFontlib Orpseglib 370 Line Trc=yes IBM AFP Implementation Specifics FilesNLS Messages Suggested Reading Acif User’s Guide AIX Example of a Customer’s Telephone Bill Input File InputSpecifying Acif Processing Line-Data Telephone Bill File With DataParmdd Example of a Parameter File for Ascii Input Data To create the indexing tag for Data Input DataParameters Specifying Acif Processing Trigger1 = \,1,XF1 Field2 Field1Field3 Values LiteralMust As axeb Oriconv Running the Acif Job Acif OutputDetermining the Form Definition Workstation Accessing the DocumentTransferring the Document Cd AIXdirectoryname WorkstationMounting Attributes User Programming Exits For AIX Print Administration ExitInput Record Work Bytes Record Bytes Reserved1 BytesRecordln Bytes Reserved2 Bytes Ifasciinpe Theasciinp Index Record Exit Sample Index Record Exit C Language Header Byte Sample Output Record Exit C Language Header Inserted eof whenis Resource Exit Resname BytesRestype Byte Sample Resource Exit C Language Header Ioca GocaIfMCF2REF=cf Non-Zero Return Codes Cc BytesChars Bytes Sample Print File Attributes C Language Header ‘P1TEST’ Trc Bytes‘P1PROD’ Acif Acif User’s Guide Fonts ForData Thechars For Chars Type Size  Copyright IBM Corp Acif User’s Guide Explaining the JCL Statements MVS EnvironmentsAcif OS/390 Using Acif in the VM Environment Trace Explaining the VM CMS CommandsApkacif Using Acif in the VSE Environment Sample VSE JCL to Invoke Acif Prntout Explaining the VSE JCL StatementsAssgn Syslst Acif User’s Guide Syntax Rules for OS/390 ParametersOS/390 and MVS MVS CHARS=XðGT1ð CCTYPE=A /\ This is not allowed Acif Parameters, Tasks, and Operating Systems CC=YES =TAPE Disk After Fontname1 ,fontname2 Fontname3 ,fontname4Fontname TheCHARS COMSETUP= Example YES DCFPAGENAMES=YES noFDEFLIB= Customization Filetype1,filetype2,filetype ...VMFdeflib Facility/VSE System ‘literal UnboundedValue Dummy Example FontlibFacility/VSE System Programming Guide IfUSERLIB A library referenced in the // Libdef PHASE,SEARCH=... Dlbl Fdefname Specifies the complete file nameMember Doesnot Require INDEXn IMAGEOUT=ASIS IocaTreats Group Uses this information to index Document Also Specified Field n ,FIELDn FIELDnDdname 16FIELDn FileINDEXDD INDXEXIT= module nameINPEXIT= module =FFBVVB 100RECFM=FFBVVB OVLYLIB= OUTPUTDD=OUTPUTDDname OS/390, MVS, and VMIfUSERLIB Pdefname Specifies Complete file name in OS/390, MVS OvlylibFollowing Example Jobparm Output JCL Linect OS/390 Pdeflib SOSI2SOSI3 PSEGLIB= Pseglib Module NameRESEXIT= That Appears Dlbl Specifies FileStat 108 ALL TRC=YES no FontOvly Value X value TriggerTrigger Acif Value value Trigg Racf Example Acif Application in OS/390, MVS, VM, or VSE 113 Example of a Customers Phone Bill JCL, CMS Commands ParametersOS/390 or MVS JCL to Invoke Acif Processing Space VM CMS Commands to Invoke Acif VSE JCL to Invoke Acif Exec PGM=APKACIF,SIZE=548K \ Data Characteristics CC = YES FIELD1 INDEX1INDEX2 City, State, Zip, index attribute Field4 Field3Field5 VM CMS Commands Concatenating FilesOS/390 or MVS JCL File MVS or OS/390 Acif User’s Guide Input Record Exit 123 PFATTR@ Bytes Sample Input Record Exit Dsect EOF Sample Index Record Exit Dsect Output Record Exit RECORD@ Bytes Sample Output Record Exit Dsect Resexit Sample Resource Exit Dsect Request Byte User Exit Search Order Attributes Input Print FileNon-Zero Return Or name.TEXTLIB Cctype Byte OfCCTYPEtheBytes 25-32 Bytes 33-40 Acif User’s Guide For OS/390 Multiple Message Scenarios133 Severe General Messages Action NameWAS 136 Field Length Padding For Error May Logic Error YouDocument To create the structured fields For Guide Line Data User IgnoredExplanation For Document Content Document Content Architecture Referencefor moreObjectto Advanced Function Printing DiagnosisforGuide 140 Content ArchitectureMSU Printing Diagnosis MMCMMO ProgrammerArchitecture 142 System Presentation Programming Guide Line DataBIM ReferAdvancedto Function Printing Diagnosis Acif User’s Guide Issues Message Identifying Message Identifying Positio ErrorLogic Error Error May be an Acif logic error Valid Identifier, is Response Invalid MMCUnit APK244I DataArchitecture Referencefor Guide for Content Architecture Referencefor more NotANY Maps 150 Structured fieldDO not Match IPO MCFAEG 152 Architecture RefeorAdvancedenceFunction Printing Diagnosis Presentation Function Printing Diagnosis Guide for Document Content Document Content Architecture Referencefor Programming Guide and Line Data Reference,PGP ToFunction Assistance Determining Source Problem Logic Error You Structured Field Used ProgramForm Definition With Error Verify That Structured Field Error Contained a Structured Field numberIS LNDPresentation Programming Guide and Line Data Referencefor Structured field numberISparameter 156 IdentifierIS LND Printing Diagnosis ForGuide PresentationISparameter Value 158 Programming Guide Line DataIdentifier1 Identifier2WAS IdentifierWAS Printing Diagnosis ForGuide Advanced 160 Size BMM Number, PresentationIdentifier Referencefor Structured field Direction AreGuide be Advanced Function Presentation Logic Error You Used Value For Definition Correct Error ResWith Error Verify That Inp Set Issues Message Identifying System Programmer Response Used Storage Request,requestsizeModule Module Name Open FileHave Invalid Explanation Were RangeCode = Processing Error Acif has Completed ProcessingDuring But Index XxxxxxxxXxxxxxnn Token1 Trigger Not Supported for Field IndexValues Specified APK476I Message Text not Available for Function Specified Message APK905S Missing Font Metric Pointer CCM Programmer ResponseDAT Find 174 Acif Messages for OS/390, MVS, VM, 175and VSE Acif User’s Guide 177 Acif User’s Guide That Placing TLEs in named179 Lines Working with file transfer and AIX Variable-length filesEbcdic Ascii Carriage controls Fixed-length filesUnderstanding how Ansi Ansi carriage control characters Systems Physical mediaPC file transfer program IND$FILE Invoke Medium Map IMM Structured Field ImageBinary NFS Indexing Considerations Index DocumentSpecifying the Imageout Acif User’s Guide Tag Logical Element 187Structured Field Introducer 8 bytes Tag Identifier Triplet 4-254 bytes Format of the Resources File BPG Field StructuredResource Group BRG Resource Acif User’s Guide Group-Level Index Element IEL Structured Field 191 Page-Level Index Element IEL Structured Field Field Structured Tag Logical ElementField BDI Appendix D. Format of the Output Document File 195 BDT BPG TLE INDEX1 Groups Begin Document BDTBegin Named Group BNG EDT EDT Structured FieldsBegin Page BPG Structured IsINDEX2 Composed Text Output MODCA-P Data StreamDefinitions Source Identifiers 201AFP AIX 202 Formdef Goca PSF Tag SyntaxTypeface Acif User’s Guide Bibliography 207 AFP Architecture Fonts Text Processing InfoPrint Manager for AIX EDMSuite OnDemand Printers OS/390 Version 2 Release ESA TCP/IP for MVS Vtam and NCP AS/400 Systems Network ArchitectureInformation/System 215 See AFPAcif JCL API AIX See acif Ascii AIX AIX AsciiAsciinp BDI Commands Defined, OS/390, MVS, VM, VSESee See End Variables Exits EPGERG AIX Index GTF AIX ImageoutAIX IMM AIX JCL Indexobj IndxexitAIX Indexdd AIX Inpexit See Map Parameter LibrarySee file Index JCL Userlib COMSETUP, OS/390, MVS, VM, VSE Ovlylib FORMDEF, OS/390, MVS, VM, VSEAIX 41 GROUPNAME, OS/390, MVS, VM, VSE IMAGEOUT, OS/390, MVS, VM, VSE Resexit RESEXIT, OS/390, MVS, VM, VSEReslib AIX Trigger AIX Reslib ExitAIX VSE See Tag TRCAIX Sysin JCL AIX MVS TRC AIX 65 Userappl Acif VSE Communicating Your Comments Comments IBM IBM Readers Comments Wed Like to Hear from YouPage IBM AFP Conversion and Indexing Facility User’s Guide