Non-Zero Return Codes, Cc Bytes, Chars Bytes | IBM S544-5285-01

Non-Zero Return Codes

If ACIF receives a non-zero return code from any exit program, ACIF i message 0425-412 and terminates processing.

Attributes	of the	Input Print	File
	ACIF provides information about the attributes of the input print file
	structure available to ACIF’s user exits. Figure 18 shows the format of
	structure.

typedef struct _PFATTR		/\ Print File Attributes		\/
{
char	cc[3];	/\ Carriage controls? - "YES" or "NO "		\/
char	cctype[1];	/\ Carriage control type - A(ANSI), M(Machine), Z(ASCII) \/
char	chars[2ð];	/\ CHARS values, including commas (eg. GT12,GT15)		\/
char	formdef[8];	/\ Form Definition (FORMDEF)		\/
char	pagedef[8];	/\ Page Definition (PAGEDEF)		\/
char	prmode[8];	/\ Processing mode		\/
char	trc[3];	/\ Table Reference Characters - "YES" or "NO "		\/
} PFATTR;

Figure 18.	Sample Print File Attributes C Language Header
	The	address	of the control block	containing the following parameters is
	the user exits:

cc (Bytes 1–3)

The

value

ofcc

theparameter

as

specifiedacif

oncommandthe. ACIF uses

the

default

value

if this

parameter is not

explicitly

specified.

cctype

(Byte

4)

The

value ofcctypethe parameter

as specifiedacif oncommandthe. ACIF

uses

the

default

value

if

this

parameter is

not explicitly specifi

chars

(Bytes

5–24)

The

value ofcharsthe parameter as specifiedacif oncommand,the including

any

commas

that separate

multiple

font

specificationschars .

Because the

parameter has no default value, this field contains blanks if no valu specified.

formdef

(Bytes

25–32)

The

value

offormdefthe

parameter

as

specifiedacif

oncommandthe.

Because

theformdef

parameter,

has

no default

value,

this

field

contains

blanks

if

no

value is specified.

pagedef

(Bytes

33–40)

The

value

ofpagedefthe

parameter

as

specifiedacif

oncommandthe.

Because

thepagedef

parameter

has

no

default

value,

this

field

contains

if

no

value

is

specified.

prmode

(Bytes

41–48)

The

value

ofprmodethe

parameter

as

specifiedacif

oncommandthe.

Because

theprmode

parameter

has

no

default

value,

this

field

contains

if

no

value

is

specified.

74 ACIF User’s Guide

Image 94

IBM S544-5285-01 manual Non-Zero Return Codes, Cc Bytes, Chars Bytes, Sample Print File Attributes C Language Header

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 Disclaimer Programming InterfacesTrademarks SUN Unix Userlib InsertimmIOB APK343I Apar AparAPK252I Apar APK345I Apar Xiii Why Should I Read This Publication?What Do I Need To Know? MVS VSE AIX Acif MVS AsciiMVS VSE 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 Tasks You Can Do with Acif Content Architecture ReferenceBDT/EDT 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 Directory/usr/lpp/psf/reslib Fdeflib= pathlistField16 . 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 Respath Reslib= pathlistPseglib 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 Field2 Field1Field3 Must ValuesLiteral As axeb Oriconv Determining the Form Running the Acif JobAcif Output Definition Workstation Accessing the DocumentTransferring the Document Cd AIXdirectoryname WorkstationMounting 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 Ioca GocaIfMCF2REF=cf Chars Bytes Non-Zero Return CodesCc Bytes Sample Print File Attributes C Language Header ‘P1TEST’ Trc Bytes‘P1PROD’ Acif Acif User’s Guide Data FontsFor Thechars For Chars Type Size  Copyright IBM Corp Acif User’s Guide Explaining the JCL Statements MVS EnvironmentsAcif OS/390 Using Acif in the VM Environment Trace Explaining the VM CMS CommandsApkacif Using Acif in the VSE Environment Sample VSE JCL to Invoke Acif Prntout Explaining the VSE JCL StatementsAssgn Syslst 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 YES DCFPAGENAMES=YES noFDEFLIB= 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 FileINDEXDD INDXEXIT= module nameINPEXIT= module =FFBVVB 100RECFM=FFBVVB OVLYLIB= OUTPUTDD=OUTPUTDDname OS/390, MVS, and VMIfUSERLIB Pdefname Specifies Complete file name in OS/390, MVS OvlylibFollowing Example Jobparm Output JCL Linect OS/390 SOSI3 PdeflibSOSI2 PSEGLIB= Pseglib Module NameRESEXIT= That Appears Dlbl Specifies FileStat 108 ALL TRC=YES no FontOvly 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 FIELD1 INDEX1INDEX2 City, State, Zip, index attribute Field4 Field3Field5 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 Action NameWAS 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 140 Content ArchitectureMSU 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 Invalid MMCUnit Architecture Referencefor APK244IData Guide for ANY Content Architecture Referencefor moreNot Maps 150 Structured fieldDO not Match IPO MCFAEG 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 LND Printing Diagnosis ForGuide PresentationISparameter Value Identifier1 158Programming Guide Line Data Identifier2WAS IdentifierWAS Printing Diagnosis ForGuide Advanced 160 Size BMM Number, PresentationIdentifier Referencefor 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 Trigger Not Supported for Field IndexValues Specified 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 Index DocumentSpecifying the Imageout 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 Composed Text Output MODCA-P Data StreamDefinitions AFP Source Identifiers201 AIX 202 Formdef Goca PSF Tag SyntaxTypeface 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 AS/400 Systems Network ArchitectureInformation/System 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 Map Parameter LibrarySee file 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 Reslib ExitAIX VSE 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