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
Disclaimer
Trademarks
Unix
SUN
Insertimm
Userlib
IOB
APK252I Apar
Apar
APK343I Apar
APK345I Apar
What Do I Need To Know?
Why Should I Read This Publication?
Xiii
MVS VSE AIX Acif
Ascii
MVS
MVS VSE
Library AIX
What Terms Are Used In This Publication?
Understanding Syntax Notation
Related Information
Highlighting
Member
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 Acif
BDT/EDT
Programming Guide and Line Data Reference
Presentation
Line Data Reference
ForIBM AIX,Page referPrinter to Formatting
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
System Limitations
For
Considerations
PSF
System Prerequisites
Installpsf.base
Theformdef
Thepagedef
VSE Prerequisites
Acif User’s Guide
Part 2. Using Acif in the AIX Environment
Acif User’s Guide
Syntax
Purpose
Acif
Ovlylib=pathlist
Isnot
Description
Font
Ovlylib
For
Font Collection
Files
You can use Acif to prepare S/370 line Data Unformatted
Flag Keyword-value Pair With One
To specify Job Script Wit
Flags and Values
IBM AFP
Chars= fontname1, fontname2, fontname3, fontname4
TRC
Fontname2
Objconlib
Comsetup= name
Fdeflib= pathlist
Directory/usr/lpp/psf/reslib
Field16 .
Record Specifies Relative
Error Condition Terminates Processing
Literal valueX literal value
Isanything Other
Record
As the default
Record, n
RDW
Stream, newline=X nn
Print Services Facility for AIX Print . Administration
Ifnewline
Fontlib= pathlist
Index
35in
Imageout=asis
Index1
Asis
Name,field n ,field n
Filename Specifies Name Full Path Name for Index ob When
Field Field n
Name For Index Object f
Field
Indexstartby=1 nn
Indexobj=group all none
Input. I fileyou specify
Variable You Not Specify
Insertimm=yes
Inputdd= filename
39in
Usr/lpp/psf/bin/asciinpe
Programname Specifies
Filename Specifies
Output File Into your Current Directory
Not Spe
Pagedef= pdefname
Print referServices to Facility For AIX Administration
Pdeflib= pathlist
Parmdd=
Chars
SOSI1
Pseglib= pathlist
Theacif
Reslib= pathlist
Respath
Pseglib
Pseg
Fdef
Ovly
Font
Trigger n = record
Trc=yes no
Trigger Value X trigger value
Trigger1
Looking
Instructs Acif Scan Every Record
‘ACCOUNT’
‘PAGE
Userlib= pathlist
Orfield n
Fontlib
Orpseglib
370 Line
IBM AFP
Trc=yes
Files
Implementation Specifics
NLS Messages
Suggested Reading
Acif User’s Guide
AIX
Example of a Customer’s Telephone Bill
Input
Input File
Specifying Acif Processing
Line-Data Telephone Bill
Data
File With
Parmdd
Example of a Parameter File for Ascii Input Data
To create the indexing tag for
Input Data
Data
Parameters
Specifying Acif Processing
Trigger1 = \,1,XF1
Field1
Field2
Field3
Literal
Values
Must
As axeb Oriconv
Acif Output
Running the Acif Job
Determining the Form
Definition
Accessing the Document
Workstation
Transferring the Document
Workstation
Cd AIXdirectoryname
Mounting
User Programming Exits
Attributes
Exit
For AIX Print Administration
Input Record
Work Bytes
Reserved1 Bytes
Record Bytes
Recordln Bytes
Reserved2 Bytes
Theasciinp
Ifasciinpe
Sample Index Record Exit C Language Header
Index Record Exit
Sample Output Record Exit C Language Header
Byte
Inserted eof whenis
Resname Bytes
Resource Exit
Restype Byte
Sample Resource Exit C Language Header
Goca
Ioca
IfMCF2REF=cf
Cc Bytes
Non-Zero Return Codes
Chars Bytes
Sample Print File Attributes C Language Header
Trc Bytes
‘P1TEST’
‘P1PROD’ Acif
Acif User’s Guide
For
Fonts
Data
Thechars
Size
For Chars Type
Copyright IBM Corp
Acif User’s Guide
MVS Environments
Explaining the JCL Statements
Acif OS/390
Using Acif in the VM Environment
Explaining the VM CMS Commands
Trace
Apkacif
Sample VSE JCL to Invoke Acif
Using Acif in the VSE Environment
Explaining the VSE JCL Statements
Prntout
Assgn Syslst
Acif User’s Guide
Parameters
Syntax Rules for OS/390
OS/390 and MVS
MVS
Acif Parameters, Tasks, and Operating Systems
CHARS=XðGT1ð CCTYPE=A /\ This is not allowed
=TAPE Disk
CC=YES
Fontname1 ,fontname2 Fontname3 ,fontname4
After
Fontname
TheCHARS
Example
COMSETUP=
DCFPAGENAMES=YES no
YES
FDEFLIB=
Filetype1,filetype2,filetype ...VM
Customization
Fdeflib
Facility/VSE System
Unbounded
‘literal
Value
Dummy
Fontlib
Example
Facility/VSE System Programming Guide
IfUSERLIB
Fdefname Specifies the complete file name
A library referenced in the // Libdef PHASE,SEARCH=... Dlbl
Member
Doesnot Require
IMAGEOUT=ASIS Ioca
INDEXn
Treats Group Uses this information to index Document
Also Specified
FIELDn
Field n ,FIELDn
Ddname
16FIELDn
INDXEXIT= module name
FileINDEXDD
INPEXIT= module
100
=FFBVVB
RECFM=FFBVVB
OUTPUTDD=OUTPUTDDname OS/390, MVS, and VM
OVLYLIB=
IfUSERLIB
Ovlylib
Pdefname Specifies Complete file name in OS/390, MVS
Following Example
Linect
Jobparm Output JCL
OS/390
SOSI2
Pdeflib
SOSI3
PSEGLIB=
Module Name
Pseglib
RESEXIT=
Specifies File
That Appears Dlbl
Stat
ALL
108
Font
TRC=YES no
Ovly
Trigger
Value X value
Trigger Acif
Value value
Trigg
Racf
113
Example Acif Application in OS/390, MVS, VM, or VSE
Example of a Customers Phone Bill
Parameters
JCL, CMS Commands
OS/390 or MVS JCL to Invoke Acif
Processing
Space
VSE JCL to Invoke Acif
VM CMS Commands to Invoke Acif
Exec PGM=APKACIF,SIZE=548K \ Data Characteristics CC = YES
INDEX1
FIELD1
INDEX2
Field3
City, State, Zip, index attribute Field4
Field5
Concatenating Files
VM CMS Commands
OS/390 or MVS JCL
File MVS or OS/390
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
Attributes Input Print File
User Exit Search Order
Non-Zero Return
Or name.TEXTLIB
OfCCTYPEthe
Cctype Byte
Bytes 25-32
Bytes 33-40
Acif User’s Guide
Multiple Message Scenarios
For OS/390
133
Severe
General Messages
Name
Action
WAS
Field
136
Logic Error You
Length Padding For Error May
Document To create the structured fields For
Guide Line Data
Ignored
User
Explanation
For
Document Content Architecture Referencefor more
Document Content
Objectto
Advanced Function Printing DiagnosisforGuide
Content Architecture
140
MSU
MMC
Printing Diagnosis
MMO
ProgrammerArchitecture
142
Presentation Programming Guide Line Data
System
BIM
ReferAdvancedto Function Printing Diagnosis
Acif User’s Guide
Message Identifying Positio Error
Issues Message Identifying
Logic Error
Error May be an Acif logic error Valid
Response
Identifier, is
MMC
Invalid
Unit
Data
APK244I
Architecture Referencefor
Guide for
Not
Content Architecture Referencefor more
ANY
Maps
Structured fieldDO not Match
150
MCF
IPO
AEG
Architecture RefeorAdvancedence
152
Function Printing Diagnosis Presentation
Function Printing Diagnosis Guide for
Programming Guide and Line Data Reference,
Document Content Document Content Architecture Referencefor
PGP
ToFunction
Logic Error You Structured Field Used Program
Assistance Determining Source Problem
Form Definition With Error Verify That
Structured Field Error Contained a
LND
Structured Field numberIS
Presentation Programming Guide and Line Data Referencefor
Structured field numberISparameter
IdentifierIS
156
Printing Diagnosis ForGuide Presentation
LND
ISparameter Value
Programming Guide Line Data
158
Identifier1
Identifier2WAS
Printing Diagnosis ForGuide Advanced
IdentifierWAS
Size
160
Number, Presentation
BMM
Identifier Referencefor
Structured field
Are
Direction
Guide be
Advanced Function Presentation
Value For Definition Correct Error Res
Logic Error You Used
With Error Verify That Inp
Set Issues Message Identifying
System Programmer Response
Storage Request,requestsize
Used
Module
Module Name
File
Open
Have
Invalid Explanation
Range
Were
Code =
Processing
Acif has Completed Processing
Error
During
But
Xxxxxxxx
Index
Xxxxxxnn
Token1
Not Supported for Field Index
Trigger
Values Specified
Function Specified Message
APK476I Message Text not Available for
Programmer Response
APK905S Missing Font Metric Pointer CCM
DAT
Find
174
Acif Messages for OS/390, MVS, VM, 175and VSE
Acif User’s Guide
177
Acif User’s Guide
Placing TLEs in named
That
179
Lines
Variable-length files
Working with file transfer and AIX
Ebcdic
Ascii
Fixed-length files
Carriage controls
Understanding how Ansi
Ansi carriage control characters
Physical media
Systems
PC file transfer program
IND$FILE
Image
Invoke Medium Map IMM Structured Field
Binary
NFS
Indexing Considerations
Document
Index
Specifying the Imageout
Acif User’s Guide
187
Tag Logical Element
Structured Field Introducer 8 bytes
Tag Identifier Triplet 4-254 bytes
BPG
Format of the Resources File
Structured
Field
Resource Group BRG
Resource
Acif User’s Guide
191
Group-Level Index Element IEL Structured Field
Page-Level Index Element IEL Structured Field
Structured
Field
Logical Element
Tag
Field
BDI
195
Appendix D. Format of the Output Document File
BDT
BPG TLE INDEX1
Begin Document BDT
Groups
Begin Named Group BNG
EDT
Structured Fields
EDT
Begin Page BPG Structured
IsINDEX2
Output MODCA-P Data Stream
Composed Text
Definitions
201
Source Identifiers
AFP
AIX
202
Goca
Formdef
PSF
Syntax
Tag
Typeface
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/400
Information/System
See AFP
215
Acif JCL
API
See acif
AIX
AIX Ascii
Ascii AIX
Asciinp
BDI
Defined, OS/390, MVS, VM, VSE
Commands
See
See End
EPG
Variables Exits
ERG
AIX Index
AIX Imageout
GTF
AIX IMM
AIX JCL
Indxexit
Indexobj
AIX Indexdd
AIX Inpexit
Parameter Library
See Map
See file
Userlib
Index JCL
FORMDEF, OS/390, MVS, VM, VSE
COMSETUP, OS/390, MVS, VM, VSE Ovlylib
AIX 41 GROUPNAME, OS/390, MVS, VM, VSE
IMAGEOUT, OS/390, MVS, VM, VSE
RESEXIT, OS/390, MVS, VM, VSE
Resexit
Reslib AIX
Trigger AIX
Exit
Reslib
AIX VSE
TRC
See Tag
AIX Sysin JCL
AIX MVS TRC
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