Programming Interfaces, Disclaimer, Trademarks | IBM S544-5285-01

Notices

References in this publication to products, programs, or services of suggest or imply that IBM will make them available in all countries wh business, or that only products, programs, or services of IBM may be Noninfringing equivalents may be substituted, but the user must verify substitutes, unless expressly designated by IBM, work correctly. No expressed or implied, to patents or copyrights of IBM is granted b document. You can send license inquiries, in writing, to the IBM Dire Licensing, IBM Corporation, North Castle Drive, Armonk, NY 10504-1785, USA.

Programming Interfaces

This publication documents intended Programming Interfaces that allow th


customer		to	write		programs to			obtain	the services	of	ACIF.
ACIF	provides		no	macros			that	allow a	customer installation		to write pro
use	the	services			of	ACIF.
Attention:		Do	not	use		any	ACIF	macros	as programming	interfaces.

Disclaimer

All examples are for illustration only. Any references to existing busi individuals is unintentional and does not imply any connection or relatio kind between the businesses, individuals, and IBM.

Trademarks

	The	following terms appear in this		publication			and		are	trademarks of the IBM Corporat
	Ÿ	Advanced	Function Presentation		Ÿ	OS/390		
	Ÿ	AFP			Ÿ	OS/400		
	Ÿ	AIX			Ÿ	Personal System/2
	Ÿ	AIX/6000			Ÿ	Presentation Manager
	Ÿ	AT			Ÿ	Print		Services		Facility
	Ÿ	Bar Code Object Content Architecture			Ÿ	PrintManager
	Ÿ	BCOCA			Ÿ	Proprinter
	Ÿ	BookManager			Ÿ	PSF
	Ÿ	IBM			Ÿ	PSF	for		AIX
	Ÿ	InfoColor			Ÿ	Quietwriter
	Ÿ	InfoPrint			Ÿ	RACF
	Ÿ	Intelligent Printer data Stream			Ÿ	RS/6000
	Ÿ	IPDS			Ÿ	System/370
	Ÿ	MVS/DFP			Ÿ	System/390
	Ÿ	MVS/ESA			Ÿ	S/390
	Ÿ	MVS/SP			Ÿ	The IBM Printing Systems Company
	Ÿ	OnDemand	for AIX		Ÿ	VM/ESA
	Ÿ	Operating System/2			Ÿ	VM/XA
	Ÿ	Operating System/400			Ÿ	WIN-OS/2

ŸOS/2

 Copyright IBM Corp. 1993, 1999

ix

Image 11

IBM S544-5285-01 manual Programming Interfaces, Disclaimer, Trademarks

Contents

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 InterfacesDisclaimer Unix SUN IOB InsertimmUserlib APK345I Apar AparAPK252I Apar APK343I Apar MVS VSE AIX Acif Why Should I Read This Publication?What Do I Need To Know? Xiii MVS VSE AsciiMVS Library AIX What Terms Are Used In This Publication? Member Related InformationUnderstanding 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 BDT/EDT Content Architecture ReferenceTasks You Can Do with Acif ForIBM AIX,Page referPrinter to Formatting PresentationProgramming 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 ForSystem Limitations Considerations Thepagedef Installpsf.baseSystem Prerequisites Theformdef VSE Prerequisites Acif User’s Guide Part 2. Using Acif in the AIX Environment Acif User’s Guide Ovlylib=pathlist PurposeSyntax Acif Isnot Description Font Collection OvlylibFont For To specify Job Script Wit You can use Acif to prepare S/370 line Data UnformattedFiles Flag Keyword-value Pair With One Flags and Values IBM AFP Chars= fontname1, fontname2, fontname3, fontname4 TRC Fontname2 Objconlib Comsetup= name Field16 . Fdeflib= pathlistDirectory/usr/lpp/psf/reslib Isanything Other Error Condition Terminates ProcessingRecord Specifies Relative Literal valueX literal value RDW As the defaultRecord Record, n Fontlib= pathlist Print Services Facility for AIX Print . AdministrationStream, newline=X nn Ifnewline Index 35in Name,field n ,field n Index1Imageout=asis Asis Field Field Field nFilename Specifies Name Full Path Name for Index ob When Name For Index Object f Variable You Not Specify Indexobj=group all noneIndexstartby=1 nn Input. I fileyou specify Usr/lpp/psf/bin/asciinpe Inputdd= filenameInsertimm=yes 39in Not Spe Filename SpecifiesProgramname Specifies Output File Into your Current Directory Pagedef= pdefname Print referServices to Facility For AIX Administration Pdeflib= pathlist Parmdd= Theacif SOSI1Chars Pseglib= pathlist Pseglib Reslib= pathlistRespath Font FdefPseg Ovly Trigger1 Trc=yes noTrigger n = record Trigger Value X trigger value ‘PAGE Instructs Acif Scan Every RecordLooking ‘ACCOUNT’ Orpseglib Orfield nUserlib= pathlist Fontlib 370 Line IBM AFP Trc=yes Suggested Reading Implementation SpecificsFiles NLS Messages Acif User’s Guide AIX Example of a Customer’s Telephone Bill Line-Data Telephone Bill Input FileInput Specifying Acif Processing Example of a Parameter File for Ascii Input Data File WithData Parmdd To create the indexing tag for Specifying Acif Processing DataInput Data Parameters Trigger1 = \,1,XF1 Field3 Field1Field2 As axeb Oriconv ValuesLiteral Must Definition Running the Acif JobAcif Output Determining the Form Transferring the Document Accessing the DocumentWorkstation Mounting WorkstationCd AIXdirectoryname User Programming Exits Attributes Work Bytes For AIX Print AdministrationExit Input Record Reserved2 Bytes Record BytesReserved1 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 ExitResname Bytes Restype Byte IfMCF2REF=cf GocaIoca Sample Print File Attributes C Language Header Non-Zero Return CodesCc Bytes Chars Bytes ‘P1PROD’ Acif Trc Bytes‘P1TEST’ Acif User’s Guide Thechars FontsFor Data Size For Chars Type  Copyright IBM Corp Acif User’s Guide Acif OS/390 MVS EnvironmentsExplaining the JCL Statements Using Acif in the VM Environment Apkacif Explaining the VM CMS CommandsTrace Sample VSE JCL to Invoke Acif Using Acif in the VSE Environment Assgn Syslst Explaining the VSE JCL StatementsPrntout Acif User’s Guide MVS Syntax Rules for OS/390Parameters OS/390 and MVS Acif Parameters, Tasks, and Operating Systems CHARS=XðGT1ð CCTYPE=A /\ This is not allowed =TAPE Disk CC=YES TheCHARS AfterFontname1 ,fontname2 Fontname3 ,fontname4 Fontname Example COMSETUP= FDEFLIB= DCFPAGENAMES=YES noYES Facility/VSE System CustomizationFiletype1,filetype2,filetype ...VM Fdeflib Dummy ‘literalUnbounded Value IfUSERLIB ExampleFontlib Facility/VSE System Programming Guide Doesnot Require A library referenced in the // Libdef PHASE,SEARCH=... DlblFdefname Specifies the complete file name Member Also Specified INDEXnIMAGEOUT=ASIS Ioca Treats Group Uses this information to index Document 16FIELDn Field n ,FIELDnFIELDn Ddname INPEXIT= module INDXEXIT= module nameFileINDEXDD RECFM=FFBVVB 100=FFBVVB IfUSERLIB OUTPUTDD=OUTPUTDDname OS/390, MVS, and VMOVLYLIB= Following Example OvlylibPdefname Specifies Complete file name in OS/390, MVS Linect Jobparm Output JCL OS/390 PSEGLIB= PdeflibSOSI2 SOSI3 RESEXIT= Module NamePseglib Stat Specifies FileThat Appears Dlbl ALL 108 Ovly FontTRC=YES no Value value Value X valueTrigger Trigger Acif Trigg Racf 113 Example Acif Application in OS/390, MVS, VM, or VSE Example of a Customers Phone Bill Processing JCL, CMS CommandsParameters 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 INDEX2 INDEX1FIELD1 Field5 Field3City, State, Zip, index attribute Field4 File MVS or OS/390 VM CMS CommandsConcatenating 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 OrderAttributes Input Print File Non-Zero Return Bytes 33-40 Cctype ByteOfCCTYPEthe Bytes 25-32 Acif User’s Guide Severe For OS/390Multiple Message Scenarios 133 General Messages WAS NameAction Field 136 Guide Line Data Length Padding For Error MayLogic Error You Document To create the structured fields For For UserIgnored Explanation Advanced Function Printing DiagnosisforGuide Document ContentDocument Content Architecture Referencefor more Objectto MSU Content Architecture140 ProgrammerArchitecture Printing DiagnosisMMC MMO 142 ReferAdvancedto Function Printing Diagnosis SystemPresentation Programming Guide Line Data BIM Acif User’s Guide Error May be an Acif logic error Valid Issues Message IdentifyingMessage Identifying Positio Error Logic Error Response Identifier, is Unit MMCInvalid Guide for APK244IData Architecture Referencefor Maps Content Architecture Referencefor moreNot ANY Structured fieldDO not Match 150 AEG MCFIPO Function Printing Diagnosis Guide for 152Architecture RefeorAdvancedence Function Printing Diagnosis Presentation ToFunction Document Content Document Content Architecture ReferenceforProgramming Guide and Line Data Reference, PGP Structured Field Error Contained a Assistance Determining Source ProblemLogic Error You Structured Field Used Program Form Definition With Error Verify That Structured field numberISparameter Structured Field numberISLND Presentation Programming Guide and Line Data Referencefor IdentifierIS 156 ISparameter Value Printing Diagnosis ForGuide PresentationLND Identifier2WAS 158Programming Guide Line Data Identifier1 Printing Diagnosis ForGuide Advanced IdentifierWAS Size 160 Identifier Referencefor Number, PresentationBMM Structured field Advanced Function Presentation DirectionAre Guide be Set Issues Message Identifying Logic Error You UsedValue For Definition Correct Error Res With Error Verify That Inp System Programmer Response Module Name UsedStorage Request,requestsize Module Invalid Explanation OpenFile Have Processing WereRange Code = But ErrorAcif has Completed Processing During Token1 IndexXxxxxxxx Xxxxxxnn Values Specified Not Supported for Field IndexTrigger Function Specified Message APK476I Message Text not Available for Find APK905S Missing Font Metric Pointer CCMProgrammer Response DAT 174 Acif Messages for OS/390, MVS, VM, 175and VSE Acif User’s Guide 177 Acif User’s Guide Lines ThatPlacing TLEs in named 179 Ascii Working with file transfer and AIXVariable-length files Ebcdic Ansi carriage control characters Carriage controlsFixed-length files Understanding how Ansi IND$FILE SystemsPhysical media PC file transfer program NFS Invoke Medium Map IMM Structured FieldImage Binary Indexing Considerations Specifying the Imageout DocumentIndex Acif User’s Guide Tag Identifier Triplet 4-254 bytes Tag Logical Element187 Structured Field Introducer 8 bytes BPG Format of the Resources File Resource FieldStructured 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 TagLogical Element Field 195 Appendix D. Format of the Output Document File BDT BPG TLE INDEX1 EDT GroupsBegin Document BDT Begin Named Group BNG IsINDEX2 EDTStructured Fields Begin Page BPG Structured Definitions Output MODCA-P Data StreamComposed Text AIX Source Identifiers201 AFP 202 Goca Formdef PSF Typeface SyntaxTag 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 ArchitectureAS/400 API 215See AFP Acif JCL See acif AIX BDI Ascii AIXAIX Ascii Asciinp See End CommandsDefined, OS/390, MVS, VM, VSE See AIX Index Variables ExitsEPG ERG AIX JCL GTFAIX Imageout AIX IMM AIX Inpexit IndexobjIndxexit AIX Indexdd See file Parameter LibrarySee Map Userlib Index JCL IMAGEOUT, OS/390, MVS, VM, VSE COMSETUP, OS/390, MVS, VM, VSE OvlylibFORMDEF, OS/390, MVS, VM, VSE AIX 41 GROUPNAME, OS/390, MVS, VM, VSE Trigger AIX ResexitRESEXIT, OS/390, MVS, VM, VSE Reslib AIX AIX VSE ExitReslib AIX MVS TRC See TagTRC 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