Indexobj=group all none, Indexstartby=1 nn | IBM S544-5285-01

filename A character string containing only those alphanumeric characters supported in AIX file names.

indexobj={group all none}

Specifies the type of information ACIF puts in the index obj

Values are:

group Places only group-level entries into the index object fi which saves space.

all Places both page-level and group-level entries into the i object file. allSelectif you are indexing a file for use the Workbench Viewer.

none Suppresses the collection of all index-level information. Choose none if you do not require an external index f Choosing none will also reduce ACIF storage requirements.

indexstartby={1 nn}

Specifies the output page number by which ACIF must find an indexing field, if ACIF is indexing the file. Values are:

1 ACIF must find an index on the first page.

nnSpecifies the output page number by which ACIF must find index criteria specified.

This parameter is helpful if, for example, your file contains pages. If your file contains two header pages, you can spe number one greater than the number of header pages (indexstartby=3 ).

If ACIF does not find an indexing field before the page n

specified indexstartbythe parameter, it issues a message and stops processing.

indxexit=

programname

Specifies the name or the full

path name of the index reco

program. This is the program ACIF

calls for every record (str

field)

it

writes

in

the

indexdd

object). If fileyou

(specify the fil

name without a path, ACIF searches for the exit program in

specified byPATH theenvironment variable. If this parameter is n

specified,

ACIF

will

not

use

an

index

record

exit

program. T

is:

programname

Any valid index record exit program name. The exit

program

name is case-sensitive.

inpexit=

programname

Specifies the name or the full

path name of the input recor

program. Theacif

command

calls

this

program for

every

record

(every line) it reads from

inputddthe

input). Ifileyou( specify the

file name without a acifpath,commandthe

searches

for

the

exit

program

in

the

paths

specifiedPATH

byenvironmentthe

variable.

If

you

do

not

specify

this parameter,acif commandthewill

not

use

an

input

record

exit program.

The

value

is:

38 ACIF User’s Guide

Image 58

IBM S544-5285-01 manual Indexobj=group all none, Indexstartby=1 nn, Input. I fileyou specify, Variable You Not Specify

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 APK343I Apar AparAPK252I Apar APK345I Apar Xiii Why Should I Read This Publication?What Do I Need To Know? MVS VSE AIX Acif MVS AsciiMVS VSE What Terms Are Used In This Publication? Library AIX Highlighting Related InformationUnderstanding Syntax Notation 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 Line Data Reference PresentationProgramming Guide and Line 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 Considerations ForSystem Limitations PSF Theformdef Installpsf.baseSystem Prerequisites Thepagedef VSE Prerequisites Acif User’s Guide Part 2. Using Acif in the AIX Environment Acif User’s Guide Acif PurposeSyntax Ovlylib=pathlist Description Isnot For OvlylibFont Font Collection Flag Keyword-value Pair With One You can use Acif to prepare S/370 line Data UnformattedFiles 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 . Literal valueX literal value Error Condition Terminates ProcessingRecord Specifies Relative Isanything Other Record, n As the defaultRecord RDW Ifnewline Print Services Facility for AIX Print . AdministrationStream, newline=X nn Fontlib= pathlist 35in Index Asis Index1Imageout=asis Name,field n ,field n Name For Index Object f Field Field nFilename Specifies Name Full Path Name for Index ob When Field Input. I fileyou specify Indexobj=group all noneIndexstartby=1 nn Variable You Not Specify 39in Inputdd= filenameInsertimm=yes Usr/lpp/psf/bin/asciinpe Output File Into your Current Directory Filename SpecifiesProgramname Specifies Not Spe Print referServices to Facility For AIX Administration Pagedef= pdefname Parmdd= Pdeflib= pathlist Pseglib= pathlist SOSI1Chars Theacif Respath Reslib= pathlistPseglib Ovly FdefPseg Font Trigger Value X trigger value Trc=yes noTrigger n = record Trigger1 ‘ACCOUNT’ Instructs Acif Scan Every RecordLooking ‘PAGE Fontlib Orfield nUserlib= pathlist Orpseglib 370 Line Trc=yes IBM AFP NLS Messages Implementation SpecificsFiles Suggested Reading Acif User’s Guide AIX Example of a Customer’s Telephone Bill Specifying Acif Processing Input FileInput Line-Data Telephone Bill Parmdd File WithData Example of a Parameter File for Ascii Input Data To create the indexing tag for Parameters DataInput Data Specifying Acif Processing Trigger1 = \,1,XF1 Field2 Field1Field3 Must ValuesLiteral As axeb Oriconv Determining the Form Running the Acif JobAcif Output Definition Workstation Accessing the DocumentTransferring the Document Cd AIXdirectoryname WorkstationMounting Attributes User Programming Exits Input Record For AIX Print AdministrationExit Work Bytes Recordln Bytes Record BytesReserved1 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 Restype Byte Resource ExitResname Bytes Sample Resource Exit C Language Header Ioca GocaIfMCF2REF=cf Chars Bytes Non-Zero Return CodesCc Bytes Sample Print File Attributes C Language Header ‘P1TEST’ Trc Bytes‘P1PROD’ Acif Acif User’s Guide Data FontsFor 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 OS/390 and MVS Syntax Rules for OS/390Parameters MVS CHARS=XðGT1ð CCTYPE=A /\ This is not allowed Acif Parameters, Tasks, and Operating Systems CC=YES =TAPE Disk Fontname AfterFontname1 ,fontname2 Fontname3 ,fontname4 TheCHARS COMSETUP= Example YES DCFPAGENAMES=YES noFDEFLIB= Fdeflib CustomizationFiletype1,filetype2,filetype ...VM Facility/VSE System Value ‘literalUnbounded Dummy Facility/VSE System Programming Guide ExampleFontlib IfUSERLIB Member A library referenced in the // Libdef PHASE,SEARCH=... DlblFdefname Specifies the complete file name Doesnot Require Treats Group Uses this information to index Document INDEXnIMAGEOUT=ASIS Ioca Also Specified Ddname Field n ,FIELDnFIELDn 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 SOSI3 PdeflibSOSI2 PSEGLIB= Pseglib Module NameRESEXIT= That Appears Dlbl Specifies FileStat 108 ALL TRC=YES no FontOvly Trigger Acif Value X valueTrigger Value value Trigg Racf Example Acif Application in OS/390, MVS, VM, or VSE 113 Example of a Customers Phone Bill OS/390 or MVS JCL to Invoke Acif JCL, CMS CommandsParameters 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 OS/390 or MVS JCL VM CMS CommandsConcatenating Files 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 Non-Zero Return User Exit Search OrderAttributes Input Print File Or name.TEXTLIB Bytes 25-32 Cctype ByteOfCCTYPEthe Bytes 33-40 Acif User’s Guide 133 For OS/390Multiple Message Scenarios Severe General Messages Action NameWAS 136 Field Document To create the structured fields For Length Padding For Error MayLogic Error You Guide Line Data Explanation UserIgnored For Objectto Document ContentDocument Content Architecture Referencefor more Advanced Function Printing DiagnosisforGuide 140 Content ArchitectureMSU MMO Printing DiagnosisMMC ProgrammerArchitecture 142 BIM SystemPresentation Programming Guide Line Data ReferAdvancedto Function Printing Diagnosis Acif User’s Guide Logic Error Issues Message IdentifyingMessage Identifying Positio Error Error May be an Acif logic error Valid Identifier, is Response Invalid MMCUnit Architecture Referencefor APK244IData Guide for ANY Content Architecture Referencefor moreNot Maps 150 Structured fieldDO not Match IPO MCFAEG Function Printing Diagnosis Presentation 152Architecture RefeorAdvancedence Function Printing Diagnosis Guide for PGP Document Content Document Content Architecture ReferenceforProgramming Guide and Line Data Reference, ToFunction Form Definition With Error Verify That Assistance Determining Source ProblemLogic Error You Structured Field Used Program Structured Field Error Contained a Presentation Programming Guide and Line Data Referencefor Structured Field numberISLND Structured field numberISparameter 156 IdentifierIS LND Printing Diagnosis ForGuide PresentationISparameter Value Identifier1 158Programming Guide Line Data Identifier2WAS IdentifierWAS Printing Diagnosis ForGuide Advanced 160 Size BMM Number, PresentationIdentifier Referencefor Structured field Guide be DirectionAre Advanced Function Presentation With Error Verify That Inp Logic Error You UsedValue For Definition Correct Error Res Set Issues Message Identifying System Programmer Response Module UsedStorage Request,requestsize Module Name Have OpenFile Invalid Explanation Code = WereRange Processing During ErrorAcif has Completed Processing But Xxxxxxnn IndexXxxxxxxx Token1 Trigger Not Supported for Field IndexValues Specified APK476I Message Text not Available for Function Specified Message DAT APK905S Missing Font Metric Pointer CCMProgrammer Response Find 174 Acif Messages for OS/390, MVS, VM, 175and VSE Acif User’s Guide 177 Acif User’s Guide 179 ThatPlacing TLEs in named Lines Ebcdic Working with file transfer and AIXVariable-length files Ascii Understanding how Ansi Carriage controlsFixed-length files Ansi carriage control characters PC file transfer program SystemsPhysical media IND$FILE Binary Invoke Medium Map IMM Structured FieldImage NFS Indexing Considerations Index DocumentSpecifying the Imageout Acif User’s Guide Structured Field Introducer 8 bytes Tag Logical Element187 Tag Identifier Triplet 4-254 bytes Format of the Resources File BPG Resource Group BRG FieldStructured Resource Acif User’s Guide Group-Level Index Element IEL Structured Field 191 Page-Level Index Element IEL Structured Field Field Structured Field TagLogical Element BDI Appendix D. Format of the Output Document File 195 BDT BPG TLE INDEX1 Begin Named Group BNG GroupsBegin Document BDT EDT Begin Page BPG Structured EDTStructured Fields IsINDEX2 Composed Text Output MODCA-P Data StreamDefinitions AFP Source Identifiers201 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 Acif JCL 215See AFP API AIX See acif Asciinp Ascii AIXAIX Ascii BDI See CommandsDefined, OS/390, MVS, VM, VSE See End ERG Variables ExitsEPG AIX Index AIX IMM GTFAIX Imageout AIX JCL AIX Indexdd IndexobjIndxexit AIX Inpexit See Map Parameter LibrarySee file Index JCL Userlib AIX 41 GROUPNAME, OS/390, MVS, VM, VSE COMSETUP, OS/390, MVS, VM, VSE OvlylibFORMDEF, OS/390, MVS, VM, VSE IMAGEOUT, OS/390, MVS, VM, VSE Reslib AIX ResexitRESEXIT, OS/390, MVS, VM, VSE Trigger AIX Reslib ExitAIX VSE AIX Sysin JCL See TagTRC 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