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