Page 3 - IBM Print Services Facility; IBM
IBM Print Services Facility IBM AFP Conversion and Indexing Facility:User’s Guide S544-5285-01
Page 5 - Contents; Part 2. Using ACIF in the AIX Environment; iii
Contents Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix Programming Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix Disclaimer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix Trademar...
Page 6 - iv
Using a Parameter File with ASCII Input Data . . . . . . . . . . . . . . . . . 56 Specifying ACIF Processing Parameters for EBCDIC Input Data . . . . . . . . 58 Using a Parameter File with EBCDIC Input Data . . . . . . . . . . . . . . . . 58 Using the Shell with EBCDIC Literal Values . . . . . . . ....
Page 9 - Figures; vii
Figures 1. How ACIF Fits into Advanced Function Presentation . . . . . . . . . . . . . 4 2. Using ACIF to Prepare Files for Viewing . . . . . . . . . . . . . . . . . . . . 6 3. Using ACIF to Prepare Files for Distributed Printing . . . . . . . . . . . . . 7 4. Using ACIF to Prepare Files for Archivi...
Page 10 - viii
Page 11 - Notices; Programming Interfaces; Attention: Do not use any ACIF macros as programming interfaces.; Disclaimer; ix
Notices References in this publication to products, programs, or services of IBM do notsuggest or imply that IBM will make them available in all countries where IBM doesbusiness, or that only products, programs, or services of IBM may be used.Noninfringing equivalents may be substituted, but the use...
Page 13 - Summary Of Changes; xi
| Summary Of Changes | This publication contains additions and changes to the previous edition, | S544-5285-00. The technical additions and changes are marked with a revision bar | to the left of the changes. | The following new function has been added: | INSERTIMM = YES|NO (see APAR PN92597) | ...
Page 14 - xii
| a Set Coded Font Local Text control. Each shift in character is converted to a | Set Coded Font Local Text control and two blanks. | New or changed messages include: | APK246S (APAR PQ02350) | APK247S (APAR PQ02350) | APK248S (APAR PQ02350) | APK252I (APAR PN77694) | APK255S (APAR PQ0945...
Page 15 - About This Publication; Why Should I Read This Publication?; xiii
About This Publication This publication describes Advanced Function Presentation Conversion andIndexing Facility (ACIF), which allows you to format and print System/390 line dataand unformatted ASCII files with IBM Print Services Facility in the followingenvironments: OS/390 MVS VM VSE AIX...
Page 16 - How This Publication Is Organized; xiv
running on it. You may need to show these messages to your systemprogrammer for assistance from time to time. How This Publication Is Organized This publication contains information pertaining to ACIF support for AIX, OS/390,MVS, VM, and VSE operating environments supported by PSF. However, becauseA...
Page 17 - What Terms Are Used In This Publication?; Document In all systems:; xv
To order additional printed copies of this publication, use order number S544-5285 Note: Publications that are referred to in this book or that contain additional information about AFP, the OS/390 or MVS operating systems, PSF, andrelated products are listed in “Bibliography” on page 207. What Terms...
Page 18 - Related Information; Understanding Syntax Notation; This publication uses consistent conventions for the following:; Highlighting; This publication uses the following highlighting conventions:; Bold; Italic; xvi
Related Information Publications that are referred to in this book or that contain additional informationabout Advanced Function Presentation (AFP), the MVS operating system, PSF, andrelated products are listed in the “Bibliography” on page 207. For additional information about OS/390 and PSF for OS...
Page 19 - Notational Conventions; xvii
Notational Conventions This publication uses the following notational conventions: Italics within a command represent variables for which you must supply a value.For example: cpgid= code page identifier means that you enter cpgid= as shown and then replace the variable code page identifier with a ...
Page 20 - Examples; xviii
Examples PSF for AIX must be installed if you want to use examples documented in thispublication that contain pathnames indicating PSF; for example:“inpexit=/usr/lpp/psf/bin/asciinpe” xviii ACIF User’s Guide
Page 21 - VSE Environments
Part 1. Information Common to AIX, OS/390, MVS, VM, and VSE Environments Copyright IBM Corp. 1993, 1999 1
Page 23 - What Can I Do with ACIF?
Chapter 1. Planning Your AFP Conversion and IndexingFacility (ACIF) Application This chapter provides: A description of ACIF and the tasks you can perform with it A brief description of related products you can use with ACIF A list of system prerequisites for using ACIF What Can I Do with ACIF...
Page 24 - ACIF accepts data from your application in the following formats:
Figure 1. How ACIF Fits into Advanced Function Presentation The figure shows the resources and the text data, which can be provided and usedby various AFP and AFP-compatible products. With ACIF, data and resources canfeed into ACIF for processing and can be sent to a customer-supplied archival andre...
Page 25 - Using ACIF for Different Tasks
With the files that ACIF creates, you can do the following: Use PSF to print the AFP document file. If you have specified resources in theAFP document file, PSF for AIX references the AFP resource file for the namesand locations of the resources. The AFP document file must be concatenatedto the en...
Page 26 - processes your print data.
Figure 2. Using ACIF to Prepare Files for Viewing Figure 2 shows the path your data takes when you are preparing files for viewingwith the Workbench Viewer. 1. The process begins with your application (1), which is the program that processes your print data. 2. Your application creates your print da...
Page 27 - Transfer the needed files in binary format to the workstation.; the document from the Workbench Viewer.
document are not present on the workstation where the Workbench Viewer isinstalled, you concatenate the resource file (3c) to the AFP document file. Theorder of concatenation must be as shown in Figure 2, with the document fileconcatenated last. 5. Transfer the needed files in binary format to the w...
Page 28 - Figure 4 shows numbered steps you can use to archive your files:
1. Run ACIF, specifying that the resource file (1b) be created along with the AFP document file (1a). If you are using ACIF on AIX and your resources reside on another operatingsystem, you can use the AIX Network File System (NFS) to mount them to theAIX system where you are running ACIF. 2. If the ...
Page 29 - Tasks You Can Do with ACIF; Converting Data Streams
Tasks You Can Do with ACIF This section describes the three tasks for which you can use ACIF. The tasks arelisted in the order in which they are described, not in any order in which theyshould be done. Converting data streams Indexing documents Retrieving resources Converting Data Streams ACIF...
Page 30 - Indexing Documents
using a page-definition (PAGEDEF) resource, in the same way as does PSF. Formore information about line data, refer to Advanced Function Presentation: Programming Guide and Line Data Reference. Mixed-Mode Data: Mixed-mode data is a mixture of line-mode data, with theinclusion of some AFP structured ...
Page 31 - Figure 5 shows the; Unformatted ASCII data
file in structured-field format. ACIF inserts these same structured fields in the indexobject file. (The tags are contained in Tagged Logical Element [TLE] structuredfields, which are described in Appendix A, Helpful Hints and 36) You can use theindexing-tag structured fields to identify a group of ...
Page 32 - without specifying any indexing parameters.
account number, and you can retrieve and view the same statement using theaccount number. If the data value you want to use in an indexing tag is consistentlylocated in the same place for each statement, you can specify ACIF parametersthat create a separate group of pages for each statement. The ACI...
Page 33 - triggers to determine an anchor point from which it can locate the; The information in Figure 7 defines two trigger values:
Because ACIF can process different data streams with various file formats (carriagecontrol characters, no carriage control characters, table-reference characters, andso on), it requires triggers to determine an anchor point from which it can locate the necessary index values. You may require multipl...
Page 34 - Retrieving Resources
location is the record containing the new-page carriage control character (forexample, a skip-to-channel 1). The application would need to add the indexingtrigger and attribute value to this record at a specified location on each statement inthe print file. This allows ACIF to retrieve this informat...
Page 35 - What Other IBM Products are Related to ACIF?; The Workbench Viewer
specific typeface be included in the resource file. The only way to accomplishthis is by using the resource exit. Includes the name of the output document in the resource file and the name ofthe resource file in the output document, which provides a method ofcorrelating resource files with the app...
Page 36 - AFP Toolbox for Multiple Operating Systems
| Workbench Viewer uses Adobe Type 1 or true type outline fonts when displaying | documents. If the document references a font for which no Type 1 font is available | at the workstation, Workbench Viewer can substitute an outline font for the | requested font. Workbench Viewer matches the requested ...
Page 37 - What are the Systems Considerations for ACIF?; You must consider the following when using ACIF:; System Limitations; PSF for OS/390 or PSF/MVS Limitations
Document Composition Facility (DCF) Document Composition Facility (DCF) is a program used primarily to prepare andformat documents for printing. It is another product that can be used with ACIF toindex your data in the OS/390, MVS, VM, or VSE environments. Along with itsmany other features, DCF prov...
Page 38 - System Prerequisites; AIX Prerequisites
System Prerequisites The following section describes system prerequisites necessary to use ACIF in theAIX, OS/390, MVS, VM, and VSE environments. AIX Prerequisites Either one of the following AIX software products is required to use ACIF: | PSF for AIX Version 2.1 (program number 5765-505) with, m...
Page 39 - VSE Prerequisites; The following VSE software products are required to use ACIF:
VSE Prerequisites The following VSE software products are required to use ACIF: VSE/SP 4.1.2 or above VSE/ESA 1.1.0 or above PSF/VSE 2.2.0 (with APAR DY42845 for printing files that contain indexing tags) orPSF/VSE 2.2.1 or above. Note: You can use later versions or releases of these products. E...
Page 43 - Chapter 2. Using ACIF Parameters in AIX; Purpose; literal value
Chapter 2. Using ACIF Parameters in AIX This section describes the acif command for AIX, including syntax rules,parameters, and values. Purpose Transforms S/370 line data and unformatted ASCII files into MO:DCA-P files forprinting, viewing, archiving, and retrieving. Syntax | acif [ cc= value] [ cct...
Page 44 - Description
When the acif command processes any unrecognized or unsupportedparameter, acif issues a message, ignores the parameter, and continuesprocessing any remaining parameters. The acif command then stopsprocessing. Though the parameters themselves are not case-sensitive, associated values,such as file...
Page 45 - ovlylib parameters for specific types of resources
Note: If the page definition does not specify fonts, and you have not specified any TRCs, your job will print, although the output may not be formattedcorrectly. If the page definition does not name any fonts, and you want the whole file to printwith only one font, then you must: Specify trc=no. ...
Page 46 - automatically invoke the acif command for the purpose of
You can use ACIF to prepare S/370 line data or unformatted ASCII files. At printsubmission time, to automatically invoke the acif command for the purpose of preparing S/370 line data or unformatted ASCII files for printing with PSF for AIX,use the -odatatype=line flag and keyword-value pair with one...
Page 47 - Flags and Values; yes
functions for viewing. The line2afp command is described in IBM Print Services Facility for AIX: Print Submission. The following parameters are used for just the conversion function of ACIF, with either the acif command or the line2afp command: cc, cctype, chars, fdeflib,fileformat, fontlib, formdef...
Page 49 - – Use the apka2e or asciinpe input record exit programs to; or
with more than one font, then the input file must contain tablereference characters, and you must: Specify trc=yes. Use chars to indicate the fonts to be associated with each TableReference Character (TRC). fontname1 is associated with TRC 0, fontname2 is associated with TRC 1, and so on. If the...
Page 50 - Note: If the file name of the COM setup file includes a file
If you do not specify a chars parameter, and if no fonts arecontained in the page definition you specified, the acif commanduses the default font that is set in the printer’s hardware. comsetup= name Specifies the name of a COM setup file. A COM setup file is an AFPresource that contains instructi...
Page 53 - n bytes long. The value of n is a number; stream
The first field in the example is located in the indexing anchorrecord (trigger1). The field is 20 bytes in length starting at thesecond byte of the record. The second field is located five records down from the indexinganchor record. The field is 10 bytes in length starting at the fifthbyte of ...
Page 54 - nn
The acif command examines the first six bytes of the firstline data record of the input file, to determine whether theinput file is ASCII or EBCDIC. If ACIF determines that theinput file is ASCII, ACIF looks for the ASCII newlinecharacter (X ' 0A ' ) to delimit the end of a record. If ACIF determine...
Page 55 - Note: If the file name of the form definition includes a file
fdefname Any valid form definition file name. The fdefname can be one to eight alphanumeric or national characters,including the two-character prefix, if there is one. Thefdefname is case-sensitive. Note: If the file name of the form definition includes a file extension, do not use the file extensio...
Page 61 - Note: If the file name of the page definition includes a
You should specify the same value for the ovlylib parameter to theacif command as specified to PSF for AIX. In this way, the searchpaths and resources used at transform time are identical to the searchpaths and resources used at print time. For information on how PSFfor AIX selects resources, refer ...
Page 62 - not
If you use pagedef to specify an inline page definition that isdifferent than the actual page definition used inline, the acifcommand looks for the page definition in the page definitionsearch path instead of the inline page definition. An input file can contain multiple page definitions, but only o...
Page 69 - MYFILE
Examples The examples contained in this section show how to use ACIF processingparameters for conversion, resource retrieval, specifying fonts, and identifying thelocation of resource directories. For indexing examples, see Chapter 3, “Exampleof an ACIF Application in AIX” on page 53. For examples o...
Page 71 - The executable program (the acif command); C language header file for the ACIF user exits; NLS Messages; country of choice; Suggested Reading; “Transforming Line Data for Printing with PSF” in
Implementation Specifics The acif command is part of PSF for AIX, and is installed with the psf.acif option. Files /usr/lpp/psf/bin/acif The executable program (the acif command) /usr/lpp/psf/acif/apkinp.c, apkind.c, apkres.c, apkout.c, apka2e.c, asciinp.c, asciinpe.cSample ACIF user exits /usr/lpp/...
Page 73 - Chapter 3. Example of an ACIF Application in AIX; Note: This example is hypothetical an input file is
Chapter 3. Example of an ACIF Application in AIX The line-data application used as the example in this section is shown in Figure 10on page 54. The application generates telephone bills. The objective is to make thebilling application output available on customer service representatives’workstations...
Page 75 - Create and specify a parameter file
The Input File Figure 11 shows the line data file currently used to print the telephone bills. Carriage Control ¦ Line ----+----1----+----2----+----3----+----4----+----5----+----6----+----7----+----8 ð 1 WILLIAM R. SMITH528ð SUNSHINE CANYON DRBOULDER CO 8ðððð-ðððð - TOTAL AMOUNT DUE: $56.97DATE DUE:...
Page 76 - Using a Parameter File with ASCII Input Data; PARMFILE; Account Number
Using a Parameter File with ASCII Input Data A parameter file created for use with ASCII input data is shown in Figure 12. Touse a parameter file, you specify the parameter file name with the acif commandparmdd parameter. For example, to use a parameter file named PARMFILE , specify: acif parmdd=PAR...
Page 81 - fdeflib
index5=X'C481A3854ðC4A485',field5 – X'C481A3854ðC4A485' is ‘Date Due’, the 5th index attribute – field5 maps to the field5 index value, which is: - 4 lines down from the indexing anchor record, 60 columns across, 12 bytes in length The result of using these indexing parameters is that the first pa...
Page 82 - Determining the Form Definition and the Page Definition; formdef; Running the ACIF Job; ACIF Output; OUTDOC; Concatenating ACIF Output Files
Determining the Form Definition and the Page Definition To format and print the job, you need to specify page definition and form definitionresources. In the example, the following resources are used: formdef F1A10110, a standard form definition, provided with PSF for AIX pagedef P1A08682, a standar...
Page 83 - Accessing the Document File from the Workstation; ftp
In the following example, the index object file, the resource file, and thedocument file are combined to create a new file that contains all three files: cat INDXOBJ RESDATA OUTDOC > NEWFILE In the following example, the resource file and the document file are added onto the end of the existi...
Page 84 - Mounting the AIX Directory on the Workstation; You can
Access the AIX directory where the concatenated document file currentlyresides. Enter: cd AIXdirectoryname The file must be transferred in binary format, so you must now enter: bin To transfer a concatenated document file named NEWFILE, enter: get NEWFILE The file will now be copied to the w...
Page 85 - User Programming Exits
Chapter 4. User Exits and Attributes of the Input Print File inAIX | This chapter contains programming interface information. A user exit is a point during ACIF processing that enables you to run a user-writtenprogram and return control of processing to ACIF after your user-written programends. ACIF...
Page 86 - IBM Print Services Facility; Input Record Exit
For more information about compiling user exit programs, refer to IBM InfoPrintManager for AIX Administrator's Guide, S544-5595, or IBM Print Services Facility for AIX: Print Administration. Input Record Exit ACIF provides an exit that enables you to add, delete, or modify records in theinput file. ...
Page 87 - Note: Only one record can reside in the buffer at any time.
record (Bytes 9–12) A pointer to the first byte of the input record including the carriage controlcharacter. The record resides in a buffer that resides in storage allocated byACIF, but the exit program is allowed to modify the input record. reserved1 (Bytes 13–16) These bytes are reserved for futur...
Page 88 - Using the ACIF User Input Record Exits; transformed into an ASCII space (X
Using the ACIF User Input Record Exits The apka2e input record exit program translates data that is encoded in ASCII(code set IBM-850) into EBCDIC (code set IBM-037) encoded data. You shoulduse this exit when your print job requires fonts such as GT12, which has onlyEBCDIC code points defined. To ex...
Page 89 - Index Record Exit
For more information on using and modifying these programs, refer to the prolog ofthe asciinp.c source file that is provided with PSF for AIX in the /usr/lpp/psf/acifdirectory. Index Record Exit ACIF provides an exit that allows you to modify or ignore the records that ACIFwrites in the index object...
Page 90 - Output Record Exit
request (Byte 15) Specifies how the record is to be processed by ACIF. On entry to the exitprogram, this parameter is X ' 00 ' . When the exit program returns control to ACIF, this parameter must have the value X ' 00 ' or X ' 01 ' where: X ' 00 ' Specifies that the record be processed by ACIF. X ' ...
Page 92 - Resource Exit
Resource Exit ACIF provides an exit that enables you to “filter” resources from being included inthe resource file. If you want to exclude a specific type of resource (for example, anoverlay), you can control this with the restype parameter. This exit is useful incontrolling resources at the file na...
Page 97 - Chapter 5. IBM AFP Fonts for ASCII Data; without; the chars parameter.
Chapter 5. IBM AFP Fonts for ASCII Data When you specify a coded font name with the chars parameter of the acifcommand or the line2afp command, the font name is limited to four characters,excluding the two-character prefix. | Figure 19 provides a list of the IBM Core Interchange Fonts for use with |...
Page 99 - Environments
Part 3. Using ACIF in the OS/390, MVS, VM, and VSE Environments Copyright IBM Corp. 1993, 1999 79
Page 101 - Using ACIF in the OS/390 and MVS Environments; Explaining the JCL Statements; USERAPPL; USERAPPL or user application is the name of the program that; PRINTOUT; print; ACIF
Chapter 6. Using ACIF in OS/390, MVS, VM, and VSE This chapter describes how to invoke ACIF in the OS/390, MVS, VM, and VSEenvironments. Using ACIF in the OS/390 and MVS Environments Figure 20 contains sample JCL to invoke ACIF to process print output from anapplication. // USERAPPL EXEC PGM= user a...
Page 102 - parameters are allocated to system-generated DDnames.; Using ACIF in the VM Environment
MSGDD Defines the DDname for the message data set. When ACIF processes aprint data set, it can issue a variety of informational or error messages. IfMSGDD is not specified as an invocation parameter, ACIF uses SYSPRINTas the default DDname and stops processing if SYSPRINT is not defined. Although th...
Page 103 - Explaining the VM CMS Commands; Print Services Facility/VM: Application
USERAPPL FILEDEF INPUT DISK filename filetype filemode FILEDEF OUTPUT DISK filename filetype filemode (LRECL 32756 BLKSIZE 3276ð FILEDEF RESOBJ DISK filename filetype filemode (LRECL 32756 BLKSIZE 3276ð FILEDEF INDEX DISK filename filetype filemode (LRECL 32756 BLKSIZE 3276ð FILEDEF SYSIN DISK filen...
Page 104 - Using ACIF in the VSE Environment; user print file; INPUT; your input file; OUTPUT; your output file; RESOBJ; your resource output file; INDEX; your index output file
PARMDD Defines the DDname for the file containing the ACIF processingparameters. If PARMDD is not specified, ACIF uses SYSIN as the defaultDDname and terminates processing if SYSIN is not defined. MSGDD Defines the DDname type for the message file. When ACIF processes aprint file, it can issue a var...
Page 105 - Explaining the VSE JCL Statements; Application Programming Guide.; PRNTOUT; user print file is the name of the print data set created by your; Defines the control statement and error message listing file.
Explaining the VSE JCL Statements The statements in Figure 22 on page 84 are explained as follows. For moreinformation about programming JCL for VSE, refer to Print Services Facility/VSE: Application Programming Guide. PRNTOUT Defines the output file produced from the application. The application ou...
Page 107 - resource files used to convert and print your job.; VM; TEMPFDEF; VSE; filename
| Chapter 7. Using ACIF Parameters in OS/390, MVS, VM, and | VSE This chapter describes ACIF syntax rules and parameters for OS/390, MVS, VM,and VSE. Many of the parameters specified to ACIF are the same as the parametersspecified to PSF when you print a job. For those parameters that are common tob...
Page 108 - ACIF uses code page 395.
When ACIF processes any unrecognized or unsupported parameter, it issues amessage, ignores the parameter, and continues processing any remainingparameters until the end of the file, at which time it terminates processing. If the same parameter is specified more than one time, ACIF uses the lastv...
Page 109 - The processing parameters are optional unless noted otherwise.
| Figure 23 (Page 2 of 2). ACIF Parameters, Tasks, and Operating Systems | ACIF Parameters | Task | Usage Key | Operating System | MCF2REF={CPCS | CF} | C,R | OS/390, MVS, VM, VSE | OBJCONLIB= data set name1[,data set name2][,data set name...] | R | OS/390, MVS | OUTEXIT= module name | G | OS/390, M...
Page 111 - EXAMPLE
| EXAMPLE | In the following example, two fonts are specified: X0GT10 (Gothic 10 pitch) | and X0GT12 (Gothic 12 pitch): | CHARS=GT1ð,GT12 | Notes: | 1. You can specify fonts in the CHARS parameter only if you want the | entire file printed in a single printing direction. ACIF uses the fonts that | h...
Page 117 - printing jobs to test different form definitions.; FORMDEF search path.; A valid set of index parameters comprises:
| – In VSE, specify variable length records for the record format (variable | blocked with ANSI carriage control characters [VBA] or variable blocked | with machine carriage control characters [VBM]). | You can include more than one inline form definition in an input file, and you | can change the f...
Page 118 - ‘attribute name’; FIELD; A maximum record length of 32 756
Note: If one or more TRIGGERn parameters is specified (that is, ACIF will index the file), at least one INDEXn parameter must be specified, andthat index must be comprised of at least one FIELDn parameter valuethat is not a literal. ACIF reports an error condition and terminatesprocessing if this ru...
Page 123 - Using Page Definitions from an OS/390 or MVS User Library: You can
| ACIF does not support a parameter equivalent to the LINECT parameter on the | /*JOBPARM, /*OUTPUT, and OUTPUT JCL statements. The maximum number | of lines processed on a page is defined in the page definition. The page | definition can be located: | Inline in the file | In a user library refe...
Page 131 - in the first byte. After ACIF locates a record; ACIF requires that at least one TRIGGERn or FIELDn value appear; the input file contains indexing tags.; YES
length of the record, ACIF considers the comparison “false” and continuesprocessing. EXAMPLE The following example illustrates the use of a carriage control character asa trigger. TRIGGER1=\,1,X'F1' /\ Look for Skip-to-Channel 1 TRIGGER2=ð,5ð,'ACCOUNT:' /\ Find account number TRIGGER3=3,75,'PAGE 1' ...
Page 132 - naming conflicts should not occur.
libraries defined for that resource type (for example, PDEFLIB for pagedefinitions). The libraries you specify can contain any AFP resources (fonts,page segments, overlays, page definitions, or form definitions). If ResourceAccess Control Facility (RACF) is installed on your system, RACF checks thea...
Page 135 - Input File; Figure 25 shows the file currently used to print the bills.; JCL, CMS Commands, and ACIF Processing Parameters; OS/390 or MVS JCL to Invoke ACIF
Input File Figure 25 shows the file currently used to print the bills. Carriage Control ¦ Line ----+----1----+----2----+----3----+----4----+----5----+----6----+----7----+----8 ð 1 WILLIAM R. SMITH528ð SUNSHINE CANYON DRBOULDER CO 8ðððð-ðððð - TOTAL AMOUNT DUE: $56.97DATE DUE: JAN 29, 1993 5 - - ð 1 ...
Page 137 - VM CMS Commands to Invoke ACIF; Where file ACIFEX2 SYSIN A contains the following:; VSE JCL to Invoke ACIF
VM CMS Commands to Invoke ACIF FILEDEF INPUT DISK ACIFEX2 SYSIN AFILEDEF OUTPUT DISK APKACIF OUTPUT A (LRECL 32756 BLKSIZE 3276ð RECFM VBFILEDEF INDEX DISK APKACIF INDEX A (LRECL 32756 BLKSIZE 3276ð RECFM VBFILEDEF RESLIB DISK APKACIF RESLIB A (LRECL 32756 BLKSIZE 3276ð RECFM VBFILEDEF SYSPRINT DISK...
Page 138 - The following data values are used as the indexing attributes:
// JOB// LIBDEF PHASE,SEARCH=(PRD2.AFP)// ASSGN SYSLST,X'FEE' // ASSGN SYSðð6,2ð1 // DLBL INPUT,'APKACIF.INPUT',ð,SD // EXTENT SYSðð6,SYSWK1,1,1,92ðð,13// ASSGN SYSðð7,2ð1 // DLBL OUTPUT,'APKACIF.OUTPUT',ð,SD // EXTENT SYSðð7,SYSWK1,1,1,9213,45// ASSGN SYSðð8,2ð1 // DLBL RESOBJ,'APKACIF.RESLIB',ð,SD...
Page 139 - Date due; INDEX2; index attribute
Date due The task is to specify the ACIF indexing parameters so that the first page of eachbill includes group-level indexing tags containing the values of all five of theseattributes. To generate these indexing attributes, specify the TRIGGER1 parameter first,because ACIF always scans for the dat...
Page 140 - The examples defined the following libraries:; FORMDEF
FIELD2 0 lines down (in indexing anchor record),50 columns across, 30 bytes in length INDEX3 'Address', field3'Address' index attributefield3 maps to FIELD3 index valueFIELD3 1 line down from indexing anchor record,50 columns across, 30 bytes in length INDEX4 'City, State, Zip', field4'City, State, ...
Page 141 - The ACIF job creates the following output files:; Concatenating Files; DD DUMMY; VM CMS Commands
ACIF Output The ACIF job creates the following output files: Type of File MVS or OS/390 VM VSE Document file,including indexingstructured fields APKACIF.OUTPUT APKACIF OUTPUT APKACIF.OUTPUT Index object file APKACIF.INDEX APKACIF INDEX APKACIF.INDEX Resource file APKACIF.RESLIB APKACIF RESLIB APKACI...
Page 143 - User Exits and Attributes of the Input Print File in; ACIF provides the following four exits:
Chapter 9. User Exits and Attributes of the Input Print File in OS/390, MVS, VM, and VSE This appendix contains Product-sensitive Programming Interface and AssociatedGuidance Information. The appendix describes the four user exits provided with ACIF and describes theinformation ACIF provides to the ...
Page 145 - Specifies that EOF has been encountered
Note: Only one record can reside in the buffer at any time. EOF (Byte 22) Specifies an end-of-file (EOF) indicator. This indicator is a 1-byte charactercode that specifies whether an EOF condition has been encountered. WhenEOF is signalled (EOF value = “Y”), the last record has already been presente...
Page 150 - User Exit Search Order; Non-Zero Return Codes
EOF (Byte 19) An end-of-file (EOF) indicator. This indicator is a 1-byte character code thatsignals when ACIF has finished writing the resource file. When EOF is signalled (EOF value = “Y”), the last record has already beenpresented to the resource exit. The pointer RECORD@ is no longer valid.Record...
Page 153 - messages on-line, the AIX messages have not been duplicated in this; Severe; Multiple Message Scenarios
Chapter 10. ACIF Messages for OS/390, MVS, VM, and VSE ACIF prints a message list at the end of each compilation. A return code of 0means that ACIF completed processing without any errors. ACIF supports thestandard return codes. Notes: 1. ACIF messages contain instructions for the PSF system program...
Page 154 - General Messages
provide additional information. Additional error messages may not always beaccurate. Message 101 may occur after many error conditions, because ACIF attempts tolocate the end of the resource containing the error as part of its recoveryprocedure. General Messages General error messages are not limite...
Page 199 - Appendix A. Helpful Hints; Working with control statements that contain numbered lines
Appendix A. Helpful Hints When using ACIF, the following topics may prove to be helpful to you: Working with control statements that contain numbered lines (OS/390 or MVS,VM, VSE environments only) Understanding how ACIF processes fonts Placing TLEs in named groups Working with file transfer...
Page 200 - Working with file transfer and AIX; Variable-length files
Working with file transfer and AIX (If you work outside the AIX environment, you may skip this section, as theinformation about working with file transfer does not pertain to the OS/390 or MVS,VM, or VSE environments.) ACIF needs to know two things about a file in order to print it: How long is ea...
Page 201 - Understanding how ANSI and machine carriage controls are used; ANSI carriage control characters
Note 1: These combinations are possible only if a file contains a prefix with a string that indicates a different code set than actually exists.For EBCDIC data with ASCII newlines, use X ' 0320202020200A ' . For ASCII data with EBCDIC newlines, use X ' 03404040404025 ' . Fixed-length files Fixed-l...
Page 202 - PC file transfer program; Physical media; For CICS and VSE, binary is recommended.
Note that machine controls print before performing any required spacing.There are many more machine control commands than ANSI. Carriagecontrols may be present in a print file or not, but every record in the filemust contain a carriage control if the controls are to be used. If the filecontains carr...
Page 203 - For VSE files, additional file transfer parameters are available.; FTP
For VSE files, additional file transfer parameters are available. For files with machine carriage control, you can specify BINARY, CRLF andCC. This provides an EBCDIC file with correct carriage controls separated byASCII newlines and carriage returns. You must, however, “trick” ACIF by usinga pr...
Page 204 - Indexing Considerations
Indexing Considerations The index object file contains Index Element (IEL) structured fields that identify thelocation of the tagged groups in the print file. The tags are contained in theTagged Logical Element (TLE) structured fields. The structured field offset and byte offset values are accurate ...
Page 207 - Appendix B. Data Stream Information; Tag Logical Element (TLE) Structured Field; Carriage Control Character (X; ) with a type value of X; denotes hexadecimal data, and; denotes EBCDIC or
Appendix B. Data Stream Information General-use Programming Interface and Associated Guidance Information iscontained in this appendix. This appendix describes the Tag Logical Element (TLE) structured field and theformats of the resource data sets. Tag Logical Element (TLE) Structured Field TLE stru...
Page 208 - Format of the Resources File
You may also want to index (tag) a specific page within the statement, such as thesummary page. The following is an example of a print file that contains TLEs at thegroup level as well as at the page level: BDT BNG TLE Account #, 1ð1ð3ðTLE Customer Name, Mike Smith BPG Page 1 data EPG BPG Page 2 dat...
Page 209 - Begin Resource Group (BRG) Structured Field; FB
ACIF can retrieve all the resources used by the print file and can place them in aseparate resource file. The resource file contains a resource group structure whosesyntax is as follows: BRG BR AFP Resource 1 ER BR AFP Resource 2 ER .. BR AFP Resource n ERERG ACIF does not limit the number of resour...
Page 211 - Appendix C. Format of the Index Object File; EDI
Appendix C. Format of the Index Object File General-use Programming Interface and Associated Guidance Information iscontained in this appendix. One of the optional files ACIF can produce contains indexing, offset, and sizeinformation. The purpose of this file is to enable applications such as archiv...
Page 213 - Begin Document Index (BDI) Structured Field
Begin Document Index (BDI) Structured Field ACIF assigns a null token name (X ' FFFF ' ) and an FQN type X ' 01 ' triplet to this structured field. The FQN type X ' 01 ' value is the file name identified by the DDname specified in the INDEXDD parameter. ACIF also creates an FQN typeX ' 83 ' triplet ...
Page 215 - Appendix D. Format of the Output Document File
Appendix D. Format of the Output Document File This appendix contains General-use Programming Interface and AssociatedGuidance Information. Although ACIF can create three separate output files, only one of the files isrequired. ACIF always creates a print file in AFP data stream format. In doing so,...
Page 220 - changes ACIF must make to support MO:DCA-P output format.
Output MO:DCA-P Data Stream Regardless of the input data stream, ACIF always produces output files in theMO:DCA-P format. Each structured field in the file is a single record preceded by aX ' 5A ' carriage control character. The following sections describe the required changes ACIF must make to supp...
Page 221 - Glossary; Source Identifiers
Glossary Source Identifiers This glossary includes definitions from the followingsources: Definitions reprinted from the American National Dictionary for Information Processing Systems areidentified by the symbol (A) following the definition. Definitions reprinted from a published section of theIn...
Page 227 - Bibliography
Bibliography This bibliography lists the titles of publications containing additional information about PSF,Advanced Function Presentation, the MVS and OS/390 operating systems, and relatedproducts. The titles and order numbers may change from time to time. To verify the current title ororder number...
Page 228 - Advanced Function Presentation (AFP) Architecture; Advanced Function Presentation for Microfilm; Fonts
Advanced Function Presentation (AFP) Architecture Publication OrderNumber Advanced Function Presentation: Programming Guide and Line Data Reference S544-3884 Bar Code Object Content Architecture Reference S544-3766 Font Object Content Architecture Reference S544-3285 Graphics Object Content Architec...
Page 229 - Text Processing; InfoPrint Manager for AIX; Print Services Facility (PSF) for AIX
Text Processing Publication Ordernumber DCF/DLF General Information GH20-9158 Document Composition Facility: Bar Code User's Guide S544-3115 Document Composition Facility: SCRIPT/VS Text Programmer's Guide SH35-0069 Publishing Systems BookMaster General Information GC34-5006 Publishing Systems BookM...
Page 230 - EDMSuite OnDemand; Printers
EDMSuite OnDemand Publication OrderNumber EDMSuite OnDemand: Administrator's Reference G544-5293 EDMSuite OnDemand: Installation and Configuration Guide for UNIX Servers G544-5598 EDMSuite OnDemand: Installation and Configuration Guide for Windows NTServers G544-5526 EDMSuite OnDemand: Introduction ...
Page 232 - eNetwork Communications Server
eNetwork Communications Server Publication OrderNumber OS/390 eNetwork Communications Server: IP Application Programming InterfaceGuide SC31-8516 OS/390 eNetwork Communications Server: IP Configuration Guide SC31-8513 OS/390 eNetwork Communications Server: IP Network Print Facility SC31-8522 OS/390 ...
Page 233 - VTAM and NCP
Publication OrderNumber MVS/ESA SP V5 System Messages, Volume 4 GC28-1483 MVS/ESA SP V5 System Messages, Volume 5 GC28-1484 MVS/ESA SP V5 Using the Functional Subsystem Interface SC28-1505 RACF V2 General User’s Guide SC23-3728 RACF V2 Security Administrator’s Guide SC23-3726 RACF V2 System Programm...
Page 234 - Systems Network Architecture
Systems Network Architecture Publication OrderNumber SNA Customization LY43-0110 SNA Formats (SNA Reference Summary) GA27-3136 SNA Resource Definition Reference SC31-8565 SNA Technical Overview GC30-3073 SNA Transaction Programmer’s Reference Manual for LU Type 6.2 GC30-3084 Systems Network Architec...
Page 235 - Index
Index A ACIF See AFP Conversion and Indexing Facility (ACIF) ACIF command See also acif command, AIXnotational conventions xvii acif command, AIX automatically invoking 26 defined, AIX 27 flags, AIX 27 format 23line2afp 26notational conventions 23 parameters 23running, AIX 62 syntax rules 23 using 2...
Page 250 - Communicating Your Comments to IBM
Communicating Your Comments to IBM IBM Print Services FacilityAFP Conversion and Indexing Facility:User’s Guide Publication No. S544-5285-01 If you especially like or dislike anything about this book, please use one of the methodslisted below to send your comments to IBM. Whichever method you choose...
Page 251 - Readers' Comments — We'd Like to Hear from You; Overall, how satisfied are you with the information in this book?; Thank you for your responses. May we contact you?
Readers' Comments — We'd Like to Hear from You IBM Print Services FacilityAFP Conversion and Indexing Facility:User’s Guide Publication No. S544-5285-01 Overall, how satisfied are you with the information in this book? How satisfied are you that the information in this book is: Please tell us how we...
Page 252 - BUSINESS REPLY MAIL
Cut or FoldAlong Line Cut or FoldAlong Line Readers' Comments — We'd Like to Hear from YouS544-5285-01 IBM Fold and Tape Please do not staple Fold and Tape NO POSTAGENECESSARYIF MAILED IN THEUNITED STATES BUSINESS REPLY MAIL FIRST-CLASS MAIL PERMIT NO. 40 ARMONK, NEW YORK POSTAGE WILL BE PAID BY A...
Page 255 - User’s Guide
Spine information: IBM IBM Print Services Facility User’s Guide AFP Conversion and Indexing Facility: