IBM S544-5285-01 , 38

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 object file.

Values are:

group Places only group-level entries into the index object file,

which saves space.

all Places both page-level and group-level entries into the index

object file. Select all if you are indexing a file for use with

the Workbench Viewer.

none Suppresses the collection of all index-level information.

Choose none if you do not require an external index file.

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:

1ACIF must find an index on the first page.

nn

Specifies the output page number by which ACIF must find the

index criteria specified.

This parameter is helpful if, for example, your file contains header

pages. If your file contains two header pages, you can specify a page

number one greater than the number of header pages

(indexstartby=3).

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

specified in the indexstartby parameter, it issues a message and

stops processing.

indxexit=

programname

Specifies the name or the full path name of the index record exit

program. This is the program ACIF calls for every record (structured

field) it writes in the index object file ( indexdd). If you specify the file

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

specified by the PATH environment variable. If this parameter is not

specified, ACIF will not use an index record exit program. The value

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 record exit

program. The acif command calls this program for every record

(every line) it reads from the input file ( inputdd). If you specify the

file name without a path, the acif command searches for the exit

program in the paths specified by the PATH environment variable. If

you do not specify this parameter, the acif command will not use an

input record exit program. The value is:

38 ACIF User’s Guide

Contents

Main Page Page Page Contents Part 1. Information Common to AIX, OS/390, MVS, VM, and VSE Environments Part 2. Using ACIF in the AIX Environment Part 3. Using ACIF in the OS/390, MVS, VM, and VSE Environments iv Part 4. Appendixes vi Figures Page Notices Programming Interfaces Disclaimer Page unbounded only xii About This Publication Why Should I Read This Publication? What Do I Need To Know? Guide to Advanced Function Presentation Mixed Object Document Content Architecture Reference How This Publication Is Organized xiv S544-5285 What Terms Are Used In This Publication? xvi Italic Related Information Understanding Syntax Notation Notational Conventions code page identifier Page Page Page Chapter 1. Planning Your AFP Conversion and Indexing Facility (ACIF) Application What Can I Do with ACIF? index object file 4 Using ACIF for Different Tasks 6 Page 8 Tasks You Can Do with ACIF Converting Data Streams S/370 Line-Mode Data: Mixed Object Document Content Architecture Data: Mixed Object Document Content Architecture Reference Indexing Documents indexing with data values. indexing with literal values. Indexing with Data Values: Indexing with Literal Values: 12 An Indexing Example Using Data Values: without triggers anchor point Indexing Limitations: Retrieving Resources 14 What Other IBM Products are Related to ACIF? The Workbench Viewer AFP Toolbox for Multiple Operating Systems 16 Document Composition Facility (DCF) Document Composition Facility Script/VS Language Reference (SH35-0070) What are the Systems Considerations for ACIF? System Limitations System Prerequisites 18 also Print Services Facility for AIX: Print Submission only VSE Prerequisites Page Page Page Chapter 2. Using ACIF Parameters in AIX Purpose Syntax 24 are Description IBM AFP Fonts: Font Summary for AFP Font Collection automatically 26 IBM Print Services Facility for AIX: Print Submission conversion Flags and Values after 28 fontname fontname1, fontname2, fontname3, fontname4 Page 30 Mixed Object Document Content Architecture Reference Print Services Facility for AIX: Print Administration literal value record,column,length 32 (newline= (newline= 34 Print Services Facility for AIX: Print Administration Page 36 anything other than must filename not 38 Page 40 IBM Print Services Facility for AIX: Print Administration 42 IBM Print Services Facility for AIX: Print Submission 44 Page 46 Page 48 Examples IBM Print Services Facility for AIX: Print Submission 50 Implementation Specifics InfoPrint Manager for AIX: Administrator's Guide IBM Page Printer Formatting Aid/6000: User's Guide Version 2.1 Files NLS Messages Suggested Reading IBM Print Services Facility for AIX: Print Submission Page Chapter 3. Example of an ACIF Application in AIX Page The Input File Figure 11 shows the line data file currently used to print the telephone bills. Figure 11. Line-Data Telephone Bill Specifying ACIF Processing Parameters for ASCII Input Data Using a Parameter File with ASCII Input Data 56 Page Specifying ACIF Processing Parameters for EBCDIC Input Data 58 Using a Parameter File with EBCDIC Input Data Page 60 Using the Shell with EBCDIC Literal Values must not AIX for RISC System/6000 Commands Reference Identifying the Locations of the Resources Determining the Form Definition and the Page Definition 62 Running the ACIF Job IBM Print Services Facility for AIX: AIX for Users of Print Services Facility Accessing the Document File from the Workstation transfer mount transfer Transfer Mounting the AIX Directory on the Workstation Chapter 4. User Exits and Attributes of the Input Print File in AIX User Programming Exits IBM Print Services Facility for AIX: Print Administration 66 Input Record Exit Page Using the ACIF User Input Record Exits 68 Index Record Exit Output Record Exit 70 Page 72 Resource Exit Page Non-Zero Return Codes 74 Attributes of the Input Print File Page Page Chapter 5. IBM AFP Fonts for ASCII Data without 78 Page Page Chapter 6. Using ACIF in OS/390, MVS, VM, and VSE Using ACIF in the OS/390 and MVS Environments USERAPPL OS/390 MVS JCL Reference Explaining the JCL Statements Using ACIF in the VM Environment 82 Explaining the VM CMS Commands Print Services Facility/VM: Application Programming Guide Using ACIF in the VSE Environment 84 Explaining the VSE JCL Statements Print Services Facility/VSE: Application Programming Guide user print file Page Page 88 Page after 90 fontname4 fontname3 Page 92 Page length 94 data set name1 literal value Page F1USER10 96 Using Inline Form Definitions: Using Form Definitions from an OS/390 or MVS User Library: attribute name attribute name 98 Page 100 DDname data set name1. data set name2 PSF for 102 P1USER10 filetype2 Using Page Definitions from an OS/390 or MVS User Library: Using Inline Page Definitions: 104 data set name2 106 Page 108 Page 110 file name... 112 Chapter 8. Example: ACIF Application in OS/390, MVS, VM, or VSE Page Input File JCL, CMS Commands, and ACIF Processing Parameters OS/390 or MVS JCL to Invoke ACIF Figure 26. Example of a Telephone Bill for an OS/390 or MVSACIF Application 116 VM CMS Commands to Invoke ACIF VSE JCL to Invoke ACIF 118 Page 120 ACIF Output Concatenating Files OS/390 or MVS JCL VM CMS Commands Page Chapter 9. User Exits and Attributes of the Input Print File in OS/390, MVS, VM, and VSE User Programming Exits Input Record Exit 124 Index Record Exit Output Record Exit 126 Page Resource Exit 128 Page User Exit Search Order 130 OS/390 or MVS VM VSE Page Page Chapter 10. ACIF Messages for OS/390, MVS, VM, and VSE Multiple Message Scenarios 134 Structured field name1 name1 General Messages record number sequence token End-type structured field token name resource 136 structured field MVS/Extended Architecture Data Administration Guide structured field name 138 Page 140 identifier value medium map 142 form definition name data map page definition 144 Page 146 id name 148 Page | | | | | | | | | 150 structured field overlay name Mixed Object Document Content Architecture Advanced Function Presentation: Programming Guide and Line Data Reference 152 Mixed Object Document Content Architecture Advanced Function Presentation: Programming Guide and Line Data Reference | | | 154 field name | | | | | | | | | | | number structured field number 156 field number token name number identifier1 158 identifier2 data map CCP identifier number data map name number 160 Function Printing: Diagnosis Guide number Page value1 162 number value2 Advanced Function Presentation: Programming Guide and Line Data Reference channel Advanced Function Presentation: Programming Guide and Line Data Reference record 164 indexn 'xxxxxxxx' storage request size xxxx return code request type 166 module name return code 'ddname' 'member name' program library name parameter = value. 'resource' 168 'value' ddname nn. nn nnn xxxxxxxxnn parameter name xxxxxxxx 170 token2 token1 token offset hex string length 172 rc error text MVS/Extended Architecture Service Aids Logic rc MVS/ESA Component Diagnosis and Logic: Service Aids 174 Page Page Page Page Appendix A. Helpful Hints Working with control statements that contain numbered lines Placing TLEs in named groups Working with file transfer and AIX 180 Understanding how ANSI and machine carriage controls are used Understanding common methods of transferring files to AIX from other systems 182 Physical media PC file transfer program FTP Other Considerations for Transferring Files to AIX Invoke Medium Map (IMM) Structured Field 184 Indexing Considerations Concatenating the Resource Group to the Document Specifying the IMAGEOUT Parameter Page Appendix B. Data Stream Information Mixed Object Document Content Architecture Reference Format of the Resources File 188 Begin Resource Group (BRG) Structured Field Begin Resource (BR) Structured Field End Resource (ER) and End Resource Group (ERG) Structured Fields Page Appendix C. Format of the Index Object File Group-Level Index Element (IEL) Structured Field Page-Level Index Element (IEL) Structured Field 192 Begin Document Index (BDI) Structured Field Index Element (IEL) Structured Field End Document Index (EDI) Structured Field 194 Appendix D. Format of the Output Document File 196 Page 198 Page Groups Begin Document (BDT) Structured Field Begin Named Group (BNG) Structured Field Begin Page (BPG) Structured Field End Named Group (ENG), End Document (EDT), and End Page (EPG) Structured Fields Page Glossary VocabularyInformation Processing Source Identifiers B 202 C D E F G H I J O 204 Adobe Type 1 Font Format P R S T anchor point V W Page Bibliography Print Services Facility (PSF) for OS/390 Advanced Function Presentation (AFP) Advanced Function Presentation (AFP) Architecture 208 Advanced Function Presentation for Microfilm To order any of the following microfilm publications, see your representative for Anacomp, Inc. Text Processing InfoPrint Manager for AIX Print Services Facility (PSF) for AIX Print Services Facility for OS/2 (PSF/2) 210 EDMSuite OnDemand Printers i-data OS/390 Version 2 Release 6 eNetwork Communications Server 212 MVS/Enterprise Systems Architecture (ESA) Version 5 TCP/IP TCP/IP for MVS VTAM and NCP Systems Network Architecture 214 AS/400 Information/System Index A 216 B C D 218 E F G 220 H I Page J 222 L M N O P 224 Page R 226 S T U 228 V W Communicating Your Comments to IBM Readers' Comments We'd Like to Hear from You BUSINESS REPLY MAIL Page IBM