MVS Environments, Explaining the JCL Statements | IBM S544-5285-01

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
		environments.

Using	ACIF in	the	OS/390	and	MVS Environments

Figure 20 contains sample JCL to invoke ACIF to process print output fr application.

//USERAPPL EXEC PGM=user application

//PRINTOUT DD DSN=print file,DISP=(NEW,CATLG) //\

//ACIF EXEC=APKACIF,PARM=[[ 'PARMDD=ddname ][,MSGDD=ddname']],REGION=3M

//INPUT DD DSN=\.USERAPPL.PRINTOUT

//OUTPUT DD DSN=output file,DISP=(NEW,CATLG),

//DCB=(LRECL=32756,BLKSIZE=3276ð,RECFM=VBA,DSORG=PS),

//SPACE=(3276ð,(nn,nn)),UNIT=SYSDA

//RESOBJ DD DSN=resource file,DISP=(NEW,CATLG),

//DCB=(LRECL=32756,BLKSIZE=3276ð,RECFM=VBA,DSORG=PS),

//SPACE=(3276ð,(nn,nn)),UNIT=SYSDA

//INDEX DD DSN=index file,DISP=(NEW,CATLG),

//DCB=(LRECL=32756,BLKSIZE=3276ð,RECFM=VBA,DSORG=PS),

//SPACE=(3276ð,(nn,nn)),UNIT=SYSDA

//SYSPRINT DD SYSOUT=\

//SYSIN DD \ ACIF parms go here

Figure 20. Sample OS/390 and MVS JCL to Invoke ACIF

Explaining the JCL Statements

The JCL statements in Figure 20 are explained as follows. For more inf about programming JCL, referOS/390 toMVS JCL Reference.

USERAPPL

Represents the job step to run the application that produces the

output.USERAPPL oruser applications the name of the program that produces the print data set.

PRINTOUT

The DD statement that defines the output data set produced fro application. The application output cannot be spooled to the Job

Subsystem (JES),		because		ACIF	does	not read		data fromprint the spool.
fileis the	name	of	the	print	data	userset	createdapplication. by the
ACIF
Represents	the	job	step	that	invokes ACIF to process the print d
can specify two		optional		input	parameters		to	ACIF:

PARMDD

Defines the DDname for the data set containing the ACIF proce

parameters.PARMDDIf is not specified, SYSINACIF usesas the default DDname and terminates processingSYSIN ifis not defined.

 Copyright IBM Corp. 1993, 1999

81

Image 101

IBM S544-5285-01 manual MVS Environments, Explaining the JCL Statements, Acif OS/390

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 APK252I Apar AparAPK343I Apar APK345I Apar What Do I Need To Know? Why Should I Read This Publication?Xiii MVS VSE AIX Acif MVS VSE AsciiMVS Library AIX What Terms Are Used In This Publication? Understanding Syntax Notation Related InformationHighlighting 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 ReferenceTasks You Can Do with Acif Programming Guide and Line Data Reference PresentationLine 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 ForConsiderations PSF System Prerequisites Installpsf.baseTheformdef Thepagedef VSE Prerequisites Acif User’s Guide Part 2. Using Acif in the AIX Environment Acif User’s Guide Syntax PurposeAcif Ovlylib=pathlist Isnot Description Font OvlylibFor Font Collection Files You can use Acif to prepare S/370 line Data UnformattedFlag 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= pathlistDirectory/usr/lpp/psf/reslib Record Specifies Relative Error Condition Terminates ProcessingLiteral valueX literal value Isanything Other Record As the defaultRecord, n RDW Stream, newline=X nn Print Services Facility for AIX Print . AdministrationIfnewline Fontlib= pathlist Index 35in Imageout=asis Index1Asis Name,field n ,field n Filename Specifies Name Full Path Name for Index ob When Field Field nName For Index Object f Field Indexstartby=1 nn Indexobj=group all noneInput. I fileyou specify Variable You Not Specify Insertimm=yes Inputdd= filename39in Usr/lpp/psf/bin/asciinpe Programname Specifies Filename SpecifiesOutput File Into your Current Directory Not Spe Pagedef= pdefname Print referServices to Facility For AIX Administration Pdeflib= pathlist Parmdd= Chars SOSI1Pseglib= pathlist Theacif Pseglib Reslib= pathlistRespath Pseg FdefOvly Font Trigger n = record Trc=yes noTrigger Value X trigger value Trigger1 Looking Instructs Acif Scan Every Record‘ACCOUNT’ ‘PAGE Userlib= pathlist Orfield nFontlib Orpseglib 370 Line IBM AFP Trc=yes Files Implementation SpecificsNLS Messages Suggested Reading Acif User’s Guide AIX Example of a Customer’s Telephone Bill Input Input FileSpecifying Acif Processing Line-Data Telephone Bill Data File WithParmdd Example of a Parameter File for Ascii Input Data To create the indexing tag for Input Data DataParameters Specifying Acif Processing Trigger1 = \,1,XF1 Field3 Field1Field2 Literal ValuesMust As axeb Oriconv Acif Output Running the Acif JobDetermining the Form Definition Transferring the Document Accessing the DocumentWorkstation Mounting WorkstationCd AIXdirectoryname User Programming Exits Attributes Exit For AIX Print AdministrationInput Record Work Bytes Reserved1 Bytes Record BytesRecordln 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 ExitRestype Byte Sample Resource Exit C Language Header IfMCF2REF=cf GocaIoca Cc Bytes Non-Zero Return CodesChars Bytes Sample Print File Attributes C Language Header ‘P1PROD’ Acif Trc Bytes‘P1TEST’ Acif User’s Guide For FontsData Thechars 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 Parameters Syntax Rules for OS/390OS/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 AfterFontname TheCHARS Example COMSETUP= FDEFLIB= DCFPAGENAMES=YES noYES Filetype1,filetype2,filetype ...VM CustomizationFdeflib Facility/VSE System Unbounded ‘literalValue Dummy Fontlib ExampleFacility/VSE System Programming Guide IfUSERLIB Fdefname Specifies the complete file name A library referenced in the // Libdef PHASE,SEARCH=... DlblMember Doesnot Require IMAGEOUT=ASIS Ioca INDEXnTreats Group Uses this information to index Document Also Specified FIELDn Field n ,FIELDnDdname 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 Linect Jobparm Output JCL OS/390 SOSI2 PdeflibSOSI3 PSEGLIB= RESEXIT= Module NamePseglib Stat Specifies FileThat Appears Dlbl ALL 108 Ovly FontTRC=YES no Trigger Value X valueTrigger 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 CommandsOS/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 INDEX1FIELD1 Field5 Field3City, State, Zip, index attribute Field4 Concatenating Files VM CMS CommandsOS/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 OrderNon-Zero Return Or name.TEXTLIB OfCCTYPEthe Cctype ByteBytes 25-32 Bytes 33-40 Acif User’s Guide Multiple Message Scenarios For OS/390133 Severe General Messages WAS NameAction Field 136 Logic Error You Length Padding For Error MayDocument To create the structured fields For Guide Line Data Ignored UserExplanation For Document Content Architecture Referencefor more Document ContentObjectto Advanced Function Printing DiagnosisforGuide MSU Content Architecture140 MMC Printing DiagnosisMMO ProgrammerArchitecture 142 Presentation Programming Guide Line Data SystemBIM ReferAdvancedto Function Printing Diagnosis Acif User’s Guide Message Identifying Positio Error Issues Message IdentifyingLogic Error Error May be an Acif logic error Valid Response Identifier, is Unit MMCInvalid Data APK244IArchitecture Referencefor Guide for Not Content Architecture Referencefor moreANY Maps Structured fieldDO not Match 150 AEG MCFIPO Architecture RefeorAdvancedence 152Function Printing Diagnosis Presentation Function Printing Diagnosis Guide for Programming Guide and Line Data Reference, Document Content Document Content Architecture ReferenceforPGP ToFunction Logic Error You Structured Field Used Program Assistance Determining Source ProblemForm Definition With Error Verify That Structured Field Error Contained a LND Structured Field numberISPresentation Programming Guide and Line Data Referencefor Structured field numberISparameter IdentifierIS 156 ISparameter Value Printing Diagnosis ForGuide PresentationLND Programming Guide Line Data 158Identifier1 Identifier2WAS Printing Diagnosis ForGuide Advanced IdentifierWAS Size 160 Identifier Referencefor Number, PresentationBMM Structured field Are DirectionGuide be Advanced Function Presentation Value For Definition Correct Error Res Logic Error You UsedWith Error Verify That Inp Set Issues Message Identifying System Programmer Response Storage Request,requestsize UsedModule Module Name File OpenHave Invalid Explanation Range WereCode = Processing Acif has Completed Processing ErrorDuring But Xxxxxxxx IndexXxxxxxnn Token1 Values Specified Not Supported for Field IndexTrigger Function Specified Message APK476I Message Text not Available for Programmer Response APK905S Missing Font Metric Pointer CCMDAT Find 174 Acif Messages for OS/390, MVS, VM, 175and VSE Acif User’s Guide 177 Acif User’s Guide Placing TLEs in named That179 Lines Variable-length files Working with file transfer and AIXEbcdic Ascii Fixed-length files Carriage controlsUnderstanding how Ansi Ansi carriage control characters Physical media SystemsPC file transfer program IND$FILE Image Invoke Medium Map IMM Structured FieldBinary NFS Indexing Considerations Specifying the Imageout DocumentIndex Acif User’s Guide 187 Tag Logical ElementStructured Field Introducer 8 bytes Tag Identifier Triplet 4-254 bytes BPG Format of the Resources File Structured FieldResource 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 TagField BDI 195 Appendix D. Format of the Output Document File BDT BPG TLE INDEX1 Begin Document BDT GroupsBegin Named Group BNG EDT Structured Fields EDTBegin Page BPG Structured IsINDEX2 Definitions Output MODCA-P Data StreamComposed Text 201 Source IdentifiersAFP AIX 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 See AFP 215Acif JCL API See acif AIX AIX Ascii Ascii AIXAsciinp BDI Defined, OS/390, MVS, VM, VSE CommandsSee See End EPG Variables ExitsERG AIX Index AIX Imageout GTFAIX IMM AIX JCL Indxexit IndexobjAIX Indexdd AIX Inpexit See file Parameter LibrarySee Map Userlib Index JCL FORMDEF, OS/390, MVS, VM, VSE COMSETUP, OS/390, MVS, VM, VSE OvlylibAIX 41 GROUPNAME, OS/390, MVS, VM, VSE IMAGEOUT, OS/390, MVS, VM, VSE RESEXIT, OS/390, MVS, VM, VSE ResexitReslib AIX Trigger AIX AIX VSE ExitReslib TRC See TagAIX 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