Xerox D63-069-00 Manual do Utilizador

ida Xerox File ConversionInstallation GuideDocument Number D63-069-00February 1998i-data international a-sVadstrupvej 35 - 43DK-2880 BagsvaerdDenmarkT

System RequirementsThis section describes the prerequisites for operation of the three different product installa-tion options:• Functional Subsystem

Refer to ida Print Subsystem/MVS Product Installation Guide, D63-052 for additional de-tails. Support of the idaPSS XES Exit requires that idaPSS has

The installation process will require that the following items can be created / imple-mented prior to the operation of idaXFC;1. APF authorized load l

This installation process requires that idaPSS has already been installed on the sys-tem according to the idaPSS installation manual.2. Install the pr

General Installation ProcedureThe product tape contains a number of tape files that can be loaded using the IEBGENERutility.Load the datasets supplied

ida XFC Spool File Converter Installation ProcedureInstall the supplied fonts and codepagesA minimal of sample AFP fonts in the CG Courier typeface ar

Authorize the IDAXFC PROCPermit the IDAXFC program module to run in KEY=1 by adding an entry to the ProgramProperties Table (PPT) found in the SYS1.PA

FSSDEF FSSNAME=IDAXFC,PROC=IDAXFC,HASPFSSM=HASPFSSMThe following example indicates a JES2 FSS definition for JES2 versions after 4.1.FSS(IDAXFC) PROC=

JES3 InstallationNote:JES3 3.1.3 supports control of up to 32 printers by a single FSS. The actual numberof printers that can be active simultaneously

A more detailed description regarding the installation of an FSS can be found inChapter 3.24 of the CA-Spool Initialization and Customization Guide, V

PrefaceFirst Edition (February 1998)This document describes the installation and customization procedures for:•idaXFC Version 1.00 or higher under the

Note:The library names in this sample should be tailored to your installation specifica-tions. The YYYYY.IDAXFC.AFPLIB and XESLIB are included as samp

SMF TYPE=234 SMF RECORD TYPES TO BE CREATED** THE DEFAULT KEYWORD DEFINES COMMON OPTIONS FOR SUBSEQUENT PRINTER* STATEMENTS. DEFAULT CAN BE REDEFINED

*Description Comment statementSubparameter(s)NoneNotes Comment statement used to format/document profile informa-tion.idaPSS Profile Printer Subparame

OVLYLIB=Description The DDname used to select Forms overlay definitionsRange/OptionsOVLY38PP | 1-8 character DDname reference.Notes This library refer

JES Output Configuration ParametersCLASS=Description JES output class used for output directed to JES spool. The outputclass used (default A) must be

OUTPUT=Description Output statement reference for output directed to JES. The corre-sponding OUTPUT statement must be supplied in the idaXFC PROC.The

idaPSS XES Exit Installation and ModificationThis section describes the procedure required to install the idaPSS Exit component sup-plied with this pr

any of the JCL keywords mapped in the supplied User Exit Dataset control block. Multiplevalidations can be performed as required. Without modification

• Overlay library concatenation (XES overlays)Implement idaPSS Profile updatesSelection of XES processing requires that the EXIT1 and EXIT8 options ar

idaXFC batch Software Installation and ModificationidaXFC batch Installation ProcedureGeneration of the Load LibraryCreation of a load library will be

Revisions with this EditionThis section of this document is used to describe modifications that have been made withupdates to this document.Organizati

Generate the idaXFC program load moduleThe following JCL indicates the JCL used to generate the program load module. Modify thesupplied LNKXESR linkag

idaXFC Spool File Converter Operator CommandsThe idaXFC utilizes an operator interface. This interface permits the modification of config-uration valu

• Stop (P)This command performs an orderly shutdown of the entire idaXFC system. Thiscommand is intended to be used during termination of the system (

XES Transform modificationsThis section describes how the supplied XES translation source, XESTRANS can be modi-fied to alter the following transform

The six character codepage name (excluding T0) that describes the AFP codepagename.• Xerox Font NameThe name of the Xerox XES source font. The supplie

Modifying the XES FORMS Data Definition ReferenceIf the default DDNAME reference to the location of XES forms is not suitable, it can bemodified using

Appendix A. idaXFC Messages and CodesError messages produced by the idaXFC.. use the following syntax:XESXXXY| | || || | Indicates the message severit

•XES001W IDA XFC IS NOT APF AUTHORIZEDDescription The idaXFC is not APF Authorized.Severity Program execution is halted immediately.Action Ensure that

•XES008I INVALID SUB PARAMETER value•XES018I INVALID SUB PARAMETER value•XES031I INVALID SUB PARAMETER valueDescription The value of a idaXFC profile

•XES014I IDA XFC RUNNING IN TEST MODEDescription The product is running in TEST MODE, where only one printer canbe defined.Severity Information only m

Table of Contentsida XFC Product Highlights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Year 2000 Support . . . . . . . .

•XES021I YOU HAVE REACHED MAX NUMBER OF PAPERSDescription The maximum number of paper types that can be defined has beenexceeded.Severity The idaXFC c

•XES029I DUPLICATE PRINTER NAME prtnameDescription An attempt to dynamically add additional printers failed due to a du-plicate printer name.Severity

•XES051I IDENTIFY RC =Description A severe error has been encountered processing the identify macro.Severity The Functional Subsystem is terminated.Ac

•XES061I INVALID OPERATOR COMMAND commandDescription An invalid idaXFC operator command was received.Severity The command entered is ignored.Action Re

•XES068I PRINTER prtid IS NOT DEFINED•XES074I PRINTER prtid IS NOT DEFINED•XES081I PRINTER prtid IS NOT DEFINED•XES083I PRINTER prtid IS NOT DEFINEDDe

•XES077I IDAXFC IS RUNNING TEST MODE WITH 2 PRINTERSDescription The product is operational with the named printers in TEST mode.Severity Information o

•XES087W FSS DISCONNECT, RC = rcDescription An internal processing error has occurred.Severity A severe program error has occurred.Action Restart the

•XES100I command UNKNOWN AFPDS COMMAND IN MAINDescription An unrecognized AFPDS (CPDS) command was found during proc-essing in the MAIN module.Severit

•XES122I SMF RECORD WRITE TERMINATEDDescription Trace message.Severity TRACE message.Action none.•XES131I CHECK POINT WRITTEN FOR PAGE nnnnDescription

•XES214W Dataset member INPUT FILE NOT FOUNDDescription An expected data member could not be located.Severity The output job producing the error is he

Implement JCL modifications for XES selection . . . . . . . . . . . . . . . . . . . . . . 31idaXFC batch Software Installation and Modification . .

•XES231W GETREC FAILED, RC= Description An internal idaXFC error occurred.Severity Processing for the named printer is terminated.Action Restart the i

•XES250I LOGMSG FOR user JOBID= number JOBNAME nameDescription Trace information message indicating User, filename, type andprinter.Severity Informati

•XES502I IDA XFC PROGRAM VERSION= x.x •XES503I SYSTEM ID = xxxxxx LEVEL = xxxxxxxxxxxxxxx •XES504I CPU TYPE tttt CPUID nnnn•XES505I USER EXIT x IS INS

•XES512I FONTS = font•XES512I COPIES = copies•XES512I FORM = form•XES512I CLASS = class•XES512I CHAR1 = trc1•XES512I CHAR2 = trc2•XES512I CHAR3 = trc3

•XES516W FSA DISCONNECT REJECTED ON PRINTER printer, RC = rc Description An error in the JES to IDAXFC FSA interface has occurred.Severity Processing

•XES523I GDSFLAG = xxDescription Trace information message.Severity Information only message.Action None.•XES524I ffff ACTIVE ON PRINTER prtid FOR use

•XES530W RELDS REJECTED,RC = xxDescription An error in the JES to IDAXFC FSA interface has occurred.Severity Processing for the named printer is termi

•XES537I NOTIFY USER TERMINATEDDescription Trace message.Severity TRACE message.Action none.•XES540I HIGH MEMORY REQUESTED BY xxxxxxDescription A requ

•XES546I STORAGE RELEASED AT address LENGTH size CALLED FROM xxxxxxDescription Information-only message that defines the location of the virtual stor-

•XES705I START GRAPHIC ENTEREDDescription Trace information message.Notes Information-only message, produced when trace option is requested.•XES706I G

List of IllustrationsFigure 1. Sample JCL to load the LOADXES JCL from the Product Tape . . . . . . . . . . 17Figure 2. JCL Sample for IDAXFC Linkage

•XES715I MAP CODED FONT FAILED WITH RETURN CODE rcDescription An attempt to access the default AFP font failed.Severity Output continues to be generat

•XES724I INSUFFICIENT REGION FOR JOBDescription Insufficient region is available for processing.Severity Processing is terminated.Action Increase the

•XES750I MCF ENTERED FONT = font codepage AS nnnDescription The Map Coded Font processing routine has been invoked for theFONT font, using the code pa

•XES758I MCF TERMINATED RC= rcDescription The subroutine module MCF has completed processing.Notes Information-only message.•XES759I ORIENTATION xx NO

•XES787I member ddname CLOSEDDescription Information-only message.Notes Information-only message identifying that member ddname has beenclosed after p

•XES990I USER EXIT 8 ENTERED•XES990I USER EXIT 8 TERMINATEDDescription Trace information message.Severity Processing continues.Action None.•XES991I US

Appendix B. Data Stream DescriptionInput Datastream DescriptionThis section describes the format of the input data supported by the product. XES input

Stop Underline *wLine Spacing *l<n>Start Bolding *bStop Bolding *pCentering *qHorizontal Tab Clear *dHorizontal Tab *t<n1...n160><LE>

XES Datastream LimitationsThis section describes limitations regarding the XES support.• Printable Page sizeThe actual printable page size produced wi

GlossaryABEND: Abnormal End refers to the abnormal ter-mination of a (problem) program.AFP: Advanced Function Printing is a term that re-fers to the c

List of TablesTable 1. List of Data sets Created by the Installation Procedure . . . . . . . . . . . . . . . . . 17List of Tables vii

JCL: Job Control Language is an IBM-licensedlanguage used for defining data and program re-sources for job submission to JES under the MVSOperating S

IndexAAPF authorized library 18APF authorized load library 15BBatch InstallationInstallationSoftware 32CCA-spool customization 21CA-Spool modification

Mmessages, ida XFC A-1modifications to JES2 19MVS PPT modifications. 15NNODE 27OOperator commands, MVS console 34OUTPUT 28overlay 19OVLYLIB, subparame

ida XFC Product Highlights• Converts Xerox Escape Sequence printer (XES) datastream to AFP output• Print legacy XES application output on AFP printers

The following information further describes the use of date and time fields in the idaXFC.idaXFC does not contain any time based sort functions, and i