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
 Trademarks
Programming Interfaces
Disclaimer
 Unix
SUN
 IOB
Insertimm
Userlib
 APK252I Apar
Apar
APK343I Apar
APK345I Apar
 What Do I Need To Know?
Why Should I Read This Publication?
Xiii
MVS VSE AIX Acif
 MVS VSE
Ascii
MVS
 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
 BDT/EDT
Content Architecture Reference
Tasks You Can Do with Acif
 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
 Field16 .
Fdeflib= pathlist
Directory/usr/lpp/psf/reslib
 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
 Pseglib
Reslib= pathlist
Respath
 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
 Field3
Field1
Field2
 Literal
Values
Must
As axeb Oriconv
 Acif Output
Running the Acif Job
Determining the Form
Definition
 Transferring the Document
Accessing the Document
Workstation
 Mounting
Workstation
Cd AIXdirectoryname
 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
 IfMCF2REF=cf
Goca
Ioca
 Cc Bytes
Non-Zero Return Codes
Chars Bytes
Sample Print File Attributes C Language Header
 ‘P1PROD’ Acif
Trc Bytes
‘P1TEST’
 Acif User’s Guide
 For
Fonts
Data
Thechars
 Size
For Chars Type
  Copyright IBM Corp
 Acif User’s Guide
 Acif OS/390
MVS Environments
Explaining the JCL Statements
 Using Acif in the VM Environment
 Apkacif
Explaining the VM CMS Commands
Trace
 Sample VSE JCL to Invoke Acif
Using Acif in the VSE Environment
 Assgn Syslst
Explaining the VSE JCL Statements
Prntout
 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=
 FDEFLIB=
DCFPAGENAMES=YES no
YES
 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
 INPEXIT= module
INDXEXIT= module name
FileINDEXDD
 RECFM=FFBVVB
100
=FFBVVB
 IfUSERLIB
OUTPUTDD=OUTPUTDDname OS/390, MVS, and VM
OVLYLIB=
 Following Example
Ovlylib
Pdefname Specifies Complete file name in OS/390, MVS
 Linect
Jobparm Output JCL
 OS/390
 SOSI2
Pdeflib
SOSI3
PSEGLIB=
 RESEXIT=
Module Name
Pseglib
 Stat
Specifies File
That Appears Dlbl
 ALL
108
 Ovly
Font
TRC=YES no
 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
 INDEX2
INDEX1
FIELD1
 Field5
Field3
City, State, Zip, index attribute Field4
 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
 WAS
Name
Action
 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
 MSU
Content Architecture
140
 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
 Unit
MMC
Invalid
 Data
APK244I
Architecture Referencefor
Guide for
 Not
Content Architecture Referencefor more
ANY
Maps
 Structured fieldDO not Match
150
 AEG
MCF
IPO
 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
 ISparameter Value
Printing Diagnosis ForGuide Presentation
LND
 Programming Guide Line Data
158
Identifier1
Identifier2WAS
 Printing Diagnosis ForGuide Advanced
IdentifierWAS
 Size
160
 Identifier Referencefor
Number, Presentation
BMM
 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
 Values Specified
Not Supported for Field Index
Trigger
 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
 Specifying the Imageout
Document
Index
 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
 Definitions
Output MODCA-P Data Stream
Composed Text
 201
Source Identifiers
AFP
AIX
 202
 Goca
Formdef
 PSF
 Typeface
Syntax
Tag
 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
 Information/System
Systems Network Architecture
AS/400
 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
 See file
Parameter Library
See Map
 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
 AIX VSE
Exit
Reslib
 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