Why Should I Read This Publication?, Xiii | IBM S544-5285-01

About This Publication

This publication describes Advanced Function Presentation Conversion and Indexing Facility (ACIF), which allows you to format and print System/3 and unformatted ASCII files with IBM Print Services Facility in the f environments:

ŸOS/390

ŸMVS

ŸVM

ŸVSE

ŸAIX

ACIF	also	provides indexing		and	resource	retrieval	capabilities	that
view,	archive,		and retrieve document files. ACIF				is supported	in the
MVS, VM,		and VSE	environments	by	IBM Print	Services	Facility (PSF).

This section identifies who should use this publication, how it is o formatting conventions used, and a list of publications related to the

Why Should I Read This Publication?

Application programmers should use this publication as a guide and ref when they are developing ACIF applications. ACIF is a batch applicati development utility enabling creation of documents that can be printed distributed, archived, and retrieved with fidelity across systems a Using ACIF, you can:

Ÿ Convert line-format print files to MO:DCA-P documents

ŸAdd indexing tags to documents; create a separate index object

indexing tags in a MO:DCA-P document

ŸRetrieve and package AFP resources needed for printing or viewing MO:DCA-P document

What Do I Need To	Know?
This	publication assumes that you are familiar with	Advanced	Function	P
(AFP)	concepts as well as the parameters that you	specify	when print
Services Facility (PSF). If you are not familiar with GuideAFP concepts,to				re
Advanced Function Presentation. If you are not familiar with the PSF print
parameters, refer toIBMeither:Print Services Facility for		AIX: Printor	Submissio
the	PSF user's guide for your operating system, as	listed in “Bibliog
page	207.

The publication also assumes that you are somewhat familiar with the architecture and structured fields. You mayMixedwantObjectto orderDocument Content Architecture ReferenceandAdvanced Function Presentation: Programming Guide and Line Data Referenceto read about these topics.

Note: This publication	provides	ACIF	messages	for the	OS/390, MVS,	VM, a
VSE environments, which contain instructions for the system programme
responsible for	maintaining	the	operating	system	and the PSF	progr

 Copyright IBM Corp. 1993, 1999

xiii

Image 15

IBM S544-5285-01 manual Why Should I Read This Publication?, What Do I Need To Know?, Xiii, MVS VSE AIX Acif, Mvs, Vm

Contents

IBM Page IBM 1999 Edition Contents MVS VSE File Helpful Hints Glossary Print Services Facility PSF for . OS/390 VSE Vii Viii Acif User’s Guide Programming Interfaces DisclaimerTrademarks Unix SUN Insertimm UserlibIOB APK345I Apar AparAPK252I Apar APK343I Apar MVS VSE AIX Acif Why Should I Read This Publication?What Do I Need To Know? Xiii Ascii MVSMVS VSE Library AIX What Terms Are Used In This Publication? Member Related InformationUnderstanding Syntax Notation Highlighting Notational Conventions Examples Part 1. Information Common to AIX, OS/390, MVS VSE Acif User’s Guide What Can I Do with ACIF? How Acif Fits into Advanced Function Presentation Using Acif for Different Tasks AFP Using Acif to Prepare Files for Viewing Transfer Using Acif to Prepare Files for Distributed Printing Acif PSF Content Architecture Reference Tasks You Can Do with AcifBDT/EDT ForIBM AIX,Page referPrinter to Formatting PresentationProgramming Guide and Line Data Reference Line Data Reference Literal Values Indexing With Data Values Example Bank Statement Input File With Literal Acif Processing Parameters to Index the Bank Statement PDS Goca, ioca Orrestype=all Workbench Viewer What Other IBM Products are Related to ACIF? Operating Systems AFP Toolbox for Multiple PSF ForSystem Limitations Considerations Thepagedef Installpsf.baseSystem Prerequisites Theformdef VSE Prerequisites Acif User’s Guide Part 2. Using Acif in the AIX Environment Acif User’s Guide Ovlylib=pathlist PurposeSyntax Acif Isnot Description Font Collection OvlylibFont For To specify Job Script Wit You can use Acif to prepare S/370 line Data UnformattedFiles Flag Keyword-value Pair With One Flags and Values IBM AFP Chars= fontname1, fontname2, fontname3, fontname4 TRC Fontname2 Objconlib Comsetup= name Fdeflib= pathlist Directory/usr/lpp/psf/reslibField16 . Isanything Other Error Condition Terminates ProcessingRecord Specifies Relative Literal valueX literal value RDW As the defaultRecord Record, n Fontlib= pathlist Print Services Facility for AIX Print . AdministrationStream, newline=X nn Ifnewline Index 35in Name,field n ,field n Index1Imageout=asis Asis Field Field Field nFilename Specifies Name Full Path Name for Index ob When Name For Index Object f Variable You Not Specify Indexobj=group all noneIndexstartby=1 nn Input. I fileyou specify Usr/lpp/psf/bin/asciinpe Inputdd= filenameInsertimm=yes 39in Not Spe Filename SpecifiesProgramname Specifies Output File Into your Current Directory Pagedef= pdefname Print referServices to Facility For AIX Administration Pdeflib= pathlist Parmdd= Theacif SOSI1Chars Pseglib= pathlist Reslib= pathlist RespathPseglib Font FdefPseg Ovly Trigger1 Trc=yes noTrigger n = record Trigger Value X trigger value ‘PAGE Instructs Acif Scan Every RecordLooking ‘ACCOUNT’ Orpseglib Orfield nUserlib= pathlist Fontlib 370 Line IBM AFP Trc=yes Suggested Reading Implementation SpecificsFiles NLS Messages Acif User’s Guide AIX Example of a Customer’s Telephone Bill Line-Data Telephone Bill Input FileInput Specifying Acif Processing Example of a Parameter File for Ascii Input Data File WithData Parmdd To create the indexing tag for Specifying Acif Processing DataInput Data Parameters Trigger1 = \,1,XF1 Field1 Field2Field3 As axeb Oriconv ValuesLiteral Must Definition Running the Acif JobAcif Output Determining the Form Accessing the Document WorkstationTransferring the Document Workstation Cd AIXdirectorynameMounting User Programming Exits Attributes Work Bytes For AIX Print AdministrationExit Input Record Reserved2 Bytes Record BytesReserved1 Bytes Recordln Bytes Theasciinp Ifasciinpe Sample Index Record Exit C Language Header Index Record Exit Sample Output Record Exit C Language Header Byte Inserted eof whenis Sample Resource Exit C Language Header Resource ExitResname Bytes Restype Byte Goca IocaIfMCF2REF=cf Sample Print File Attributes C Language Header Non-Zero Return CodesCc Bytes Chars Bytes Trc Bytes ‘P1TEST’‘P1PROD’ Acif Acif User’s Guide Thechars FontsFor Data Size For Chars Type  Copyright IBM Corp Acif User’s Guide MVS Environments Explaining the JCL StatementsAcif OS/390 Using Acif in the VM Environment Explaining the VM CMS Commands TraceApkacif Sample VSE JCL to Invoke Acif Using Acif in the VSE Environment Explaining the VSE JCL Statements PrntoutAssgn Syslst Acif User’s Guide MVS Syntax Rules for OS/390Parameters OS/390 and MVS Acif Parameters, Tasks, and Operating Systems CHARS=XðGT1ð CCTYPE=A /\ This is not allowed =TAPE Disk CC=YES TheCHARS AfterFontname1 ,fontname2 Fontname3 ,fontname4 Fontname Example COMSETUP= DCFPAGENAMES=YES no YESFDEFLIB= Facility/VSE System CustomizationFiletype1,filetype2,filetype ...VM Fdeflib Dummy ‘literalUnbounded Value IfUSERLIB ExampleFontlib Facility/VSE System Programming Guide Doesnot Require A library referenced in the // Libdef PHASE,SEARCH=... DlblFdefname Specifies the complete file name Member Also Specified INDEXnIMAGEOUT=ASIS Ioca Treats Group Uses this information to index Document 16FIELDn Field n ,FIELDnFIELDn Ddname INDXEXIT= module name FileINDEXDDINPEXIT= module 100 =FFBVVBRECFM=FFBVVB OUTPUTDD=OUTPUTDDname OS/390, MVS, and VM OVLYLIB=IfUSERLIB Ovlylib Pdefname Specifies Complete file name in OS/390, MVSFollowing Example Linect Jobparm Output JCL OS/390 PSEGLIB= PdeflibSOSI2 SOSI3 Module Name PseglibRESEXIT= Specifies File That Appears DlblStat ALL 108 Font TRC=YES noOvly Value value Value X valueTrigger Trigger Acif Trigg Racf 113 Example Acif Application in OS/390, MVS, VM, or VSE Example of a Customers Phone Bill Processing JCL, CMS CommandsParameters OS/390 or MVS JCL to Invoke Acif Space VSE JCL to Invoke Acif VM CMS Commands to Invoke Acif Exec PGM=APKACIF,SIZE=548K \ Data Characteristics CC = YES INDEX1 FIELD1INDEX2 Field3 City, State, Zip, index attribute Field4Field5 File MVS or OS/390 VM CMS CommandsConcatenating Files OS/390 or MVS JCL Acif User’s Guide 123 Input Record Exit Sample Input Record Exit Dsect PFATTR@ Bytes Sample Index Record Exit Dsect EOF Output Record Exit Sample Output Record Exit Dsect RECORD@ Bytes Sample Resource Exit Dsect Resexit Request Byte Or name.TEXTLIB User Exit Search OrderAttributes Input Print File Non-Zero Return Bytes 33-40 Cctype ByteOfCCTYPEthe Bytes 25-32 Acif User’s Guide Severe For OS/390Multiple Message Scenarios 133 General Messages Name ActionWAS Field 136 Guide Line Data Length Padding For Error MayLogic Error You Document To create the structured fields For For UserIgnored Explanation Advanced Function Printing DiagnosisforGuide Document ContentDocument Content Architecture Referencefor more Objectto Content Architecture 140MSU ProgrammerArchitecture Printing DiagnosisMMC MMO 142 ReferAdvancedto Function Printing Diagnosis SystemPresentation Programming Guide Line Data BIM Acif User’s Guide Error May be an Acif logic error Valid Issues Message IdentifyingMessage Identifying Positio Error Logic Error Response Identifier, is MMC InvalidUnit Guide for APK244IData Architecture Referencefor Maps Content Architecture Referencefor moreNot ANY Structured fieldDO not Match 150 MCF IPOAEG Function Printing Diagnosis Guide for 152Architecture RefeorAdvancedence Function Printing Diagnosis Presentation ToFunction Document Content Document Content Architecture ReferenceforProgramming Guide and Line Data Reference, PGP Structured Field Error Contained a Assistance Determining Source ProblemLogic Error You Structured Field Used Program Form Definition With Error Verify That Structured field numberISparameter Structured Field numberISLND Presentation Programming Guide and Line Data Referencefor IdentifierIS 156 Printing Diagnosis ForGuide Presentation LNDISparameter Value Identifier2WAS 158Programming Guide Line Data Identifier1 Printing Diagnosis ForGuide Advanced IdentifierWAS Size 160 Number, Presentation BMMIdentifier Referencefor Structured field Advanced Function Presentation DirectionAre Guide be Set Issues Message Identifying Logic Error You UsedValue For Definition Correct Error Res With Error Verify That Inp System Programmer Response Module Name UsedStorage Request,requestsize Module Invalid Explanation OpenFile Have Processing WereRange Code = But ErrorAcif has Completed Processing During Token1 IndexXxxxxxxx Xxxxxxnn Not Supported for Field Index TriggerValues Specified Function Specified Message APK476I Message Text not Available for Find APK905S Missing Font Metric Pointer CCMProgrammer Response DAT 174 Acif Messages for OS/390, MVS, VM, 175and VSE Acif User’s Guide 177 Acif User’s Guide Lines ThatPlacing TLEs in named 179 Ascii Working with file transfer and AIXVariable-length files Ebcdic Ansi carriage control characters Carriage controlsFixed-length files Understanding how Ansi IND$FILE SystemsPhysical media PC file transfer program NFS Invoke Medium Map IMM Structured FieldImage Binary Indexing Considerations Document IndexSpecifying the Imageout Acif User’s Guide Tag Identifier Triplet 4-254 bytes Tag Logical Element187 Structured Field Introducer 8 bytes BPG Format of the Resources File Resource FieldStructured Resource Group BRG Acif User’s Guide 191 Group-Level Index Element IEL Structured Field Page-Level Index Element IEL Structured Field Structured Field BDI TagLogical Element Field 195 Appendix D. Format of the Output Document File BDT BPG TLE INDEX1 EDT GroupsBegin Document BDT Begin Named Group BNG IsINDEX2 EDTStructured Fields Begin Page BPG Structured Output MODCA-P Data Stream Composed TextDefinitions AIX Source Identifiers201 AFP 202 Goca Formdef PSF Syntax TagTypeface Acif User’s Guide 207 Bibliography Fonts AFP Architecture InfoPrint Manager for AIX Text Processing Printers EDMSuite OnDemand OS/390 Version 2 Release ESA Vtam and NCP TCP/IP for MVS Systems Network Architecture AS/400Information/System API 215See AFP Acif JCL See acif AIX BDI Ascii AIXAIX Ascii Asciinp See End CommandsDefined, OS/390, MVS, VM, VSE See AIX Index Variables ExitsEPG ERG AIX JCL GTFAIX Imageout AIX IMM AIX Inpexit IndexobjIndxexit AIX Indexdd Parameter Library See MapSee file Userlib Index JCL IMAGEOUT, OS/390, MVS, VM, VSE COMSETUP, OS/390, MVS, VM, VSE OvlylibFORMDEF, OS/390, MVS, VM, VSE AIX 41 GROUPNAME, OS/390, MVS, VM, VSE Trigger AIX ResexitRESEXIT, OS/390, MVS, VM, VSE Reslib AIX Exit ReslibAIX VSE AIX MVS TRC See TagTRC AIX Sysin JCL AIX 65 Userappl Acif VSE Communicating Your Comments IBM Comments Readers Comments Wed Like to Hear from You IBMPage IBM AFP Conversion and Indexing Facility User’s Guide