IBM S544-5285-01 R, S

processing parameter

(continued)

ASCII input data, AIX 55

EBCDIC input data, AIX 58, 59

example, AIX 56

programming interface information

AFP Toolbox C Library 16

AFP Toolbox C++ Object Library 16

overview ix

PSEG resource

requirements for resource file 108

PSEGLIB parameter

AIX 43, 48

defined, AIX 43

defined, OS/390 or MVS 105

defined, VM 106

defined, VSE equivalent 106

OS/390 or MVS 105

VM 106

VSE equivalent 106

PSF/VSE

limitations 17

PSFPATH environment variable, AIX 29

publications, related 207

R

REGION size for ACIF 81

related products 15

related publications 207

reserved prefix

AFP resources 112

RESEXIT parameter

AIX 43

defined 14, 106

defined, AIX 43

RESFILE parameter

defined 107

RESLIB parameter

AIX 44

defined, AIX 44

RESOBJ VSE statement 85

RESOBJDD parameter

AIX 44

defined 107

defined, AIX 44

OS/390 or MVS 107

VM 107

VSE 107

RESOBJDD statement

VM 83

resource directory

example of locating, AIX 50

resource exit

filtering resources 14

provided with ACIF, AIX 72

RESEXIT parameter 14, 106

resource exit

(continued)

resexit parameter, AIX 43

RESTYPE parameter 128

resource file

AFP data-stream resource group 14

contents set with RESTYPE parameter 108

contents set with restype parameter, AIX 44

DCB characteristics 107

DD statement for, MVS 82

DD statement for, OS/390 82

DD statement for, VM 83

DLBL statement for, VSE 85

format 107, 188

output format

AFP data-stream resource group 14

partitioned data set, MVS or OS/390 14

partitioned data set, MVS or OS/390 14

structured fields 189

resource retrieval

description 14

example, AIX 49

exit 106

exit, AIX 43

file format 107, 188

RESEXIT parameter 106

RESFILE parameter 107

resource exit, AIX 72

RESTYPE parameter

AIX 44

defined 14, 108

defined, AIX 44

specifying all resources for viewing or printing 14

retrieving, ACIF

how to prepare files 8

return code, not zero

AIX 74

S

sample code

See

examples

sample VSE JCL to invoke ACIF 85

search order for resources, AIX

by file extension 25

fonts, AIX 34

form definitions, AIX 31

objconlib, AIX 40

OBJCONLIB, OS/390, MVS 100

overlays, AIX 40

page definitions, AIX 42

page segments, AIX 43

resource directory, AIX 44

resource library, AIX 44

setup files, AIX 40

setup files, OS/390 and MVS 100

user directory, AIX 48

226 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