System Prerequisites, Theformdef, Thepagedef | IBM S544-5285-01

System Prerequisites

The following section describes system prerequisites necessary to use AIX, OS/390, MVS, VM, and VSE environments.

AIX Prerequisites

Either

one

of the following AIX software

products

is

required

to

use

Ÿ PSF

for

AIX Version 2.1 (program number

5765-505) with, minimally, the

psf.acif option installed. This version of PSF for AIX requires IBM

AI

System/6000 Version 3.2.5 (program number

5756-030)

or

higher.

Notes:

1. Installationonly ofpsf.acif

will

provide

you

with

the

abilityacif

to

run

the

command.

Theformdef

parameter

is

required

for

running

ACIF.

For

AIX,

see

For OS/390, MVS, VM, or VSE, see page

96. Though you may use form

definitions from other sources,psf.acif installthe option provides a form

definition

named F1ACIF.

(See

the

description

for

form

definition

inIBM

Print Services Facility for AIX:

Printfor Submissiondetails

regarding

form

definition

F1ACIF.)

Thepagedef

parameter

is

required

for

running ACIF if the input f

contains S/370 line data, mixed-mode data,

or

unformatted ASCII

da

Though you may use page definitions from other sources, several

definitions are provided with PSF for AIX. The PSF-supplied page

definitions are installed/usr/lpp/psf/reslibinto the

directory

with

the

psf.acif

option. These

page definitions

are listedIBMand described

Print

Services Facility for AIX: Print.

Submission

2. In

order

to

print

and

to

use

the

other

resources

that

are

you

mustalso

installpsf.base .

Ÿ InfoPrint Manager for AIX 3.1.0. This version of

InfoPrint

Manager

re

version

4.2.1 and

higher.

OS/390 or MVS Prerequisites

The following OS/390 or MVS software products are required to use ACIF:

	Ÿ	MVS/ESA	Version	5.2.0	or OS/390
	Ÿ	PSF/MVS	2.2.0	or PSF/MVS	3.1.0 for OS/390.

VM Prerequisites

The following VM software products are required to use ACIF:

Ÿ	VM/SP	5 or	above
Ÿ	VM/SP	HPO	5 or	above
Ÿ	VM/XA	1.2.1		or above

ŸVM/ESA 1.1.0 or above

PSF/VM	2.1.0 (with PTF# UN37799 for printing files that contain indexing tag
PSF/VM	2.1.1

18 ACIF User’s Guide

Image 38

IBM S544-5285-01 manual System Prerequisites, Theformdef, Thepagedef, Installpsf.base

Contents

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