ida Xerox File Conversion Installation Guide Document Number D63-069-00 February 1998 i-data international a-s Vadstrupvej 35 - 43 DK-2880 Bagsvaerd Denmark Tel: + 45 44 36 60 00 Fax: + 45 44 36 61 11 e-mail: i-data@i-data.com WWW: www.i-data.
Preface First Edition (February 1998) This document describes the installation and customization procedures for: • idaXFC Version 1.00 or higher under the following environments: * * * * • idaXFC batch under the following operating systems: * * • OS/390 MVS/ESA JES2 JES3 OS/390 MVS/ESA idaXFC Exit for idaPSS Version 7.05 or higher under the following environments: * * * * OS/390 MVS/ESA JES2 JES3 No warranty is expressed or implied in regard to the accuracy of this publication.
Revisions with this Edition This section of this document is used to describe modifications that have been made with updates to this document. Organization of this Publication • "ida XFC Product Highlights" describes the idaXFC product highlights. • "System Requirements" describes the system requirements for installation of the idaXFC and idaXFC batch ("batch"). • "General Installation Procedure" explains how to load the product tape.
Table of Contents ida XFC Product Highlights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Year 2000 Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Functional Subsystem Spool Converter Requirements . . . . . . . . . . . . . . . . . 13 idaPSS XES Conversion Exit Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . .
Implement JCL modifications for XES selection . . . . . . . . . . . . . . . . . . . . . . 31 idaXFC batch Software Installation and Modification . . . . . . . . . . . . . 32 idaXFC batch Installation Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 Generation of the Load Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 Install the supplied Fonts and Codepages . . . . . . . . . . . . . . . . . . . . . . . . . . 32 Customize the XES Translation .
List of Illustrations Figure 1. Figure 2. Figure 3. Figure 4. Figure 5. Figure 6. Figure 7. Figure 8. Figure 9. Figure 10. vi ida XFC Product Guide Sample JCL to load the LOADXES JCL from the Product Tape . . . . . . . . . . 17 JCL Sample for IDAXFC Linkage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 IDAXFC PROCLIB Invocation Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 Sample ida XFC Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
List of Tables Table 1. List of Data sets Created by the Installation Procedure . . . . . . . . . . . . . . . . .
ida XFC Product Highlights • Converts Xerox Escape Sequence printer (XES) datastream to AFP output • Print legacy XES application output on AFP printers • Wide range of install options for flexibility to match existing print environment.
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 is therefore unaffected by year 2000 date sort considerations. The system date is used in conjunction with the following program functions: • Log Information idaXFC can write information to the SYSLOG or program log file.
System Requirements This section describes the prerequisites for operation of the three different product installation options: • Functional Subsystem Spool File Converter • idaPSS Program Exit • Batch program Common print resource requirements are listed in the last chapter in this section. Functional Subsystem Spool Converter Requirements The IDAXFC operates as a functional subsystem initiated as a started task (using a JES, CA-Spool or start printer command).
Refer to ida Print Subsystem/MVS Product Installation Guide, D63-052 for additional details. Support of the idaPSS XES Exit requires that idaPSS has been installed at version 7.05 or higher. There is no support of the idaPSS Exit with versions of idaPSS prior to this version level. XES to AFP Batch Invocation Prerequisites The following prerequisite products are required to use the XES to AFP batch program.
The installation process will require that the following items can be created / implemented prior to the operation of idaXFC; 1. APF authorized load library An APF authorized load library is required to execute the IDAXFC program. 2. PROC library A system-accessible procedure library should be available to be used for the startup procedure. 3. MVS PPT modifications. Modifications to the Program Properties Table will be required to permit operation of the IDAXFC. 4. System security rules (e.g.
This installation process requires that idaPSS has already been installed on the system according to the idaPSS installation manual. 2. Install the product tape files using the LOADXES JCL 3. Install the supplied codepages and fonts 4. Modify the PSS Exit 1 assembler source and CHANEXIT code (optional) 5. Perform XES transform modifications (XESTRANS) 6. Relink idaPSS program module (LNKPSSX) 7. Implement idaPSS Proclib updates 8. Implement idaPSS Profile updates 9.
General Installation Procedure The product tape contains a number of tape files that can be loaded using the IEBGENER utility. Load the datasets supplied on the product tape The first file on the tape contains an IEBGENER JCL that can be used to load the required files and create the installation libraries. A sample JCL is indicated here to assist in obtaining the IEBGENER load JCL: //S1 EXEC PGM=IEBGENER //SYSUT1 DD DISP=OLD,DSN=IDATA.
ida XFC Spool File Converter Installation Procedure Install the supplied fonts and codepages A minimal of sample AFP fonts in the CG Courier typeface are provided on the installation tape in 300 pel. These fonts have been provided as samples only, to allow for installation validation, and can be used in conjunction with AFP generator programs, and for printing with idaXFC and IBM AFP printers. If required, these fonts (and associated code pages) can be installed in an existing 300 pel font libraries.
Authorize the IDAXFC PROC Permit the IDAXFC program module to run in KEY=1 by adding an entry to the Program Properties Table (PPT) found in the SYS1.PARMLIB SCHEDXX member.
FSSDEF FSSNAME=IDAXFC,PROC=IDAXFC,HASPFSSM=HASPFSSM The following example indicates a JES2 FSS definition for JES2 versions after 4.1. FSS(IDAXFC) PROC=IDAXFC, HASPFSSM=HASPFSSM Note: When more than one FSS is defined, a unique PROC name is required for each definition 2. Generate the JES2 printer definition The following example indicates a JES2 printer definition for JES2 versions prior to 4.1.
JES3 Installation Note: JES3 3.1.3 supports control of up to 32 printers by a single FSS. The actual number of printers that can be active simultaneously will depend on the processor size and print workload. Multiple FSS definitions could therefore be required. The following modifications are required to be included in the JES3 initialization deck to define an FSS system and any associated printers. 1.
A more detailed description regarding the installation of an FSS can be found in Chapter 3.24 of the CA-Spool Initialization and Customization Guide, Version 10.0. The remainder of the installation procedure is identical to the installation required in conjunction with the JES2 or JES3 spool systems. Refer to "Sample IDAXFC Procedure" for a listing of a sample CA-Spool startup Proc.
Note: The library names in this sample should be tailored to your installation specifications. The YYYYY.IDAXFC.AFPLIB and XESLIB are included as sample dataset names only and are not generated during installation. IDAXFC Control Profile Description The IDAXFC profile is used to supply idaXFC configuration options, e.g. general customization and printer definitions. The profile must be located in a separate member or dataset (not instream) with a maximum width of 80 characters).
SMF TYPE=234 SMF RECORD TYPES TO BE CREATED * * THE DEFAULT KEYWORD DEFINES COMMON OPTIONS FOR SUBSEQUENT PRINTER * STATEMENTS. DEFAULT CAN BE REDEFINED LATER IN THE PROFILE, OR * OVERRIDDEN. * DEFAULT * * * SAMPLE PRINTER DEFINITIONS * PRINTER PRTID=PRTN, LOGDD=PRT1LOG, LOG ERROR MESSAGES TO DDNAME PRT1LOG DEST=PSSPRT1, NODE=IDATA, CLASS=E, OUTPUT=VLU0OUT, FCB=DEF, FORMS=STD Figure 4. Sample ida XFC Profile Refer to the following table for further explanation of the idaXFC control profile statements.
* Description Comment statement Subparameter(s) None Notes Comment statement used to format/document profile information. idaPSS Profile Printer Subparameter Keywords Printer definition and customization is performed using the PRINTER and DEFAULT keywords. The types of customization are spool file output destination, output formatting options, printer resource definitions and error processing options.
OVLYLIB= Description The DDname used to select Forms overlay definitions Range/Options OVLY38PP | 1-8 character DDname reference. Notes This library reference is only used in conjunction with XES forms. Description This keyword defines the paper size available in the target printer. The supplied paper size selection is used to indicate the paper size, and is used for formatting data, page rotation (when specified). Incorrect specifications of paper size may produce incorrectly formatted output. size.
JES Output Configuration Parameters CLASS= Description JES output class used for output directed to JES spool. The output class used (default A) must be defined in JES. Range/Options A | JES defined output class Notes Only valid JES parameter values should be used. Invalid parameters will result in DYNALLOC OPEN errors when attempting to print. Description JES output destination name for output directed to JES. If this value is omitted, the PRTID value will be used for DEST(i.e. default).
OUTPUT= Description Output statement reference for output directed to JES. The corresponding OUTPUT statement must be supplied in the idaXFC PROC. The output statement can be used to specify output formatting options, e.g. Page, Form definition, and other output controls. Range/Options 1-8 character OUTPUT statement name Notes No default value applies. Only valid JES parameter values should be used. Invalid parameters will result in DYNALLOC OPEN errors when attempting to print.
idaPSS XES Exit Installation and Modification This section describes the procedure required to install the idaPSS Exit component supplied with this product. The supplied XES Exit software can be installed together with existing program Exits, and does not alter their functionality. The XES input datastream can be printed on the same output devices presently driven by idaPSS (for AFP data). The supplied XES exit software requires installation of User Exit's 1 and 8.
any of the JCL keywords mapped in the supplied User Exit Dataset control block. Multiple validations can be performed as required. Without modifications to the CHANEXIT source, the PRMODE=XES will be used as the selection criteria. In addition, if you are already using the Logical Record Processing Exit PSSUX1: Exit 1, you will need to modify the CHANEXIT assembler source.
• Overlay library concatenation (XES overlays) Implement idaPSS Profile updates Selection of XES processing requires that the EXIT1 and EXIT8 options are inlcuded on the PRINTER (or DEFAULT statements). Both of these exits are used to process XES input datastream. There are no additional idaPSS profile keywords that are required for control of XES to AFP processing.
idaXFC batch Software Installation and Modification idaXFC batch Installation Procedure Generation of the Load Library Creation of a load library will be required for the program modules supplied in object code. The BLDXFC JCL invokes the IBM IEWL utility to generate the idaXFC batch program load modules. Modify the data set name and volser information on the Load Module DCB statement to match your installation defaults. Note: The idaXFC batch load module is reentrant and reusable.
Generate the idaXFC program load module The following JCL indicates the JCL used to generate the program load module. Modify the supplied LNKXESR linkage editor JCL to match your installation standards. //LNKXESR JOB (ACCT#),'HF',CLASS=A,MSGCLASS=X,MSGLEVEL=(1,1), // TIME=1440 //* //* SAMPLE JCL TO LKED XESREAD BATCH CONVERTER //* //LNKXESR EXEC PGM=IEWL, // PARM='LIST,LET,XREF,MAP,RENT' //SYSLMOD DD DISP=SHR,DSN=YYYYY.XES.LOADLIB //OBJLIB DD DISP=SHR,DSN=YYYYY.XES.
idaXFC Spool File Converter Operator Commands The idaXFC utilizes an operator interface. This interface permits the modification of configuration values without requiring that idaXFC is shutdown and restarted. Operator commands can be entered at the Master console or using a program that supports this interface (e.g. SDSF).
• Stop (P) This command performs an orderly shutdown of the entire idaXFC system. This command is intended to be used during termination of the system (e.g. prior to an IPL). The shutdown command will take affect when all printing presently in progress is terminated. When more than one Stop command is entered, an orderly "forced" termination of idaXFC system is performed, which will interrupt any printing/conversion presently in progress.
XES Transform modifications This section describes how the supplied XES translation source, XESTRANS can be modified to alter the following transform attributes: • XES to AFP font selection (including codepage) • Lead-in and Lead-out strings • Page length and margins • External DD name for FORMS references • Default User Defined Key (UDK) • Modifying the sixel decoding table • Default EBCDIC language translation (codepage) Customization of the XESTRANS assembler source is required to tailor th
The six character codepage name (excluding T0) that describes the AFP codepage name. • Xerox Font Name The name of the Xerox XES source font. The supplied names are case sensitive. Do not specify the trailing -l and -p identifiers (landscape & portrait). Termination of the FONTTAB definition is performed using the X'00' terminator (DC X'00'). Up to 63 fonts can be specified in the FONTTAB definition (for a total of 126 font references, for both landscape/portrait orientation).
Modifying the XES FORMS Data Definition Reference If the default DDNAME reference to the location of XES forms is not suitable, it can be modified using the DDNAME Entry. The DDNAME label contains the DDNAME reference that will be used by the XES transform when XES forms are requested. Note: Use of XES forms may not apply to your installation. Modifying the Default User Defined Key The Default UDK (User Defined Key) is used within XES print jobs to override the standard escape sequence.
Appendix A. idaXFC Messages and Codes Error messages produced by the idaXFC.. use the following syntax: XESXXXY | | | | | | | Indicates the message severity. I = Information | | E = Eventual action required | | W = Warning | | XXX indicates the unique decimal message number | XES - is the identifier type for ida XFC messages XES = Printer driver messages General messages are routed to the MCS console. The SYSLOG julian date and time are used for journaling purposes (i.e.
• • • • • • • A-2 XES001W IDA XFC IS NOT APF AUTHORIZED Description The idaXFC is not APF Authorized. Severity Program execution is halted immediately. Action Ensure that the idaXFC is located in an APF authorized load library prior to attempting a restart. XES002I INVALID INPUT text Description The supplied idaXFC profile statement is invalid. Severity Processing will continue and this statement is ignored. Action Correct the incorrect idaXFC profile statement(s).
• • • • • • • • • XES008I INVALID SUB PARAMETER value XES018I INVALID SUB PARAMETER value XES031I INVALID SUB PARAMETER value Description The value of a idaXFC profile sub parameter keyword is invalid Severity The idaXFC terminates. Action Correct the incorrect idaXFC profile sub parameter keyword keyword and restart the idaXFC. XES009I INVALID DECIMAL NUMBER argument XES019I INVALID DECIMAL NUMBER argument Description The idaXFC subparameter does not contain a valid decimal value.
• • • • • • A-4 XES014I IDA XFC RUNNING IN TEST MODE Description The product is running in TEST MODE, where only one printer can be defined. Severity Information only message. Action Operation of one ICDS printer is possible without the idaXFC KEY PROFILE statement (i.e. TEST MODE). If additional printers are required to be tested, obtain a product key from the product distributor.
• • • • • • • • XES021I YOU HAVE REACHED MAX NUMBER OF PAPERS Description The maximum number of paper types that can be defined has been exceeded. Severity The idaXFC continues processing using the first valid paper types definitions. Action Remove additional paper type statements to conform to the maximum allowable value of 50 paper types. XES022I VIRTUAL STORAGE DISPLAY FOR TCB nnnn XES023I SUBPOOL nnn KEY nnn TCB nnnn XES024I ADDRESS nnnn LENGTH nnnn Description Diagnostic messages.
• • • • • • A-6 XES029I DUPLICATE PRINTER NAME prtname Description An attempt to dynamically add additional printers failed due to a duplicate printer name. Severity The IDAXFC ADD PRINTER command was not performed. Action Ensure that the additional printer name does not conflict with and existing printer name and reenter the IDAXFC Add Printer command. XES030I YOU HAVE REACHED MAX NUMBER OF PRINTERS Description The maximum number of printers that can be defined has been exceeded.
• • • • • • • • • • • • • • • XES051I IDENTIFY RC = Description A severe error has been encountered processing the identify macro. Severity The Functional Subsystem is terminated. Action This error can be caused by duplicate file entries in the LPA (PSSFSA00). For all other error conditions, contact the product distributor indicating the named error message. XES052W name, MISSING IN CIB DATA Description A severe program error has occurred. Severity Program execution is halted immediately.
• • • • • • A-8 XES061I INVALID OPERATOR COMMAND command Description An invalid idaXFC operator command was received. Severity The command entered is ignored. Action Refer to the Operator Controls section in this document for a list of valid operator commands. XES062W INVALID ORDER RECEIVED IN FSS fssorder Description The idaXFC FSI interface received the FSS order "fssorder" that is not supported. Severity idaXFC order is ignored. Processing continues.
• • • • • • • • • XES068I PRINTER prtid IS NOT DEFINED XES074I PRINTER prtid IS NOT DEFINED XES081I PRINTER prtid IS NOT DEFINED XES083I PRINTER prtid IS NOT DEFINED Description An attempt was made to perform an operator command on a printer that is not defined to this idaXFC. Severity Processing continues, the command is not performed. Action Verify that the printer id or idaXFC service machine is correct and respecify the command if required.
• • • • • • • • XES077I IDAXFC IS RUNNING TEST MODE WITH 2 PRINTERS Description The product is operational with the named printers in TEST mode. Severity Information only message. Action The product is operational in TEST mode (without a product KEY). If you wish to use the product with additional printers, a product KEY will be required. XES078I IDAXFC IS LICENSED FOR nnnn PRINTERS Description The product is operational with a license key that permits operation of up to nnnn printers.
• • • • • • • • • • • • XES087W FSS DISCONNECT, RC = rc Description An internal processing error has occurred. Severity A severe program error has occurred. Action Restart the idaXFC specifying an FSI trace option on the failing printer and contact the product distributor. Return code information can be found in the appropriate documentation for the FSI macro. XES088I IDA XFC SHUTDOWN COMPLETED Description Termination is complete for idaXFC. Severity Information only message. Action None.
• • • • • • • • • • • • • • • XES100I command UNKNOWN AFPDS COMMAND IN MAIN Description An unrecognized AFPDS (CPDS) command was found during processing in the MAIN module. Severity Processing will continue after this message. Action Ensure that the input ddname is correct, and that the input has not been corrupted. XES101W INVALID ORDER RECEIVED IN FSA Description An error in the JES to IDAXFC FSA interface has occurred. Severity Processing for the named printer is terminated.
• • • • • • • XES122I SMF RECORD WRITE TERMINATED Description Trace message. Severity TRACE message. Action none. XES131I CHECK POINT WRITTEN FOR PAGE nnnn Description Trace information message indicating checkpoint activity. Notes Information-only message. XES200W SHORT RECORD FOUND. LENGTH = llllll Description An error was encountered processing AFPDS data. An AFPDS command was processed that was less than 9 bytes.
• • • • • • • • XES214W Dataset member INPUT FILE NOT FOUND Description An expected data member could not be located. Severity The output job producing the error is held and processing continues. Action Validate that all input data and resources have been supplied. XES215I member ddname CLOSED XES216I member ddname CLOSED Description Information-only message. Notes Information-only message identifying that member ddname has been closed after processing.
• • • • • • • XES231W GETREC FAILED, RC= Description An internal idaXFC error occurred. Severity Processing for the named printer is terminated. Action Restart the idaXFC specifying an FSI trace option on the failing printer and contact the product distributor. Return code information can be found in the appropriate documentation for the FSI macro. XES232I GETREC, FLAGS1= Description Information message. Severity Processing continues. Action None.
• • • • • • • XES250I LOGMSG FOR user JOBID= number JOBNAME name Description Trace information message indicating User, filename, type and printer. Severity Information only message. Action None. XES251W LOG DATASET FAILED ON printer XES252W LOG DATASET FAILED ON printer Description An error has occurred with the LOG dataset associated with the named printer. Severity Use of the specified log dataset is terminated. Error logging will be directed to the target printer.
• • • • • • • • • • • • • XES502I IDA XFC PROGRAM VERSION= x.x XES503I SYSTEM ID = xxxxxx LEVEL = xxxxxxxxxxxxxxx XES504I CPU TYPE tttt CPUID nnnn XES505I USER EXIT x IS INSTALLED Description Indicates the version number of the program installed and the operating system version, level. Interface specific message indicates microcode level and printer support and other features. Notes Information-only message. Interface version information should be recorded if required.
• • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • XES512I FONTS = font XES512I COPIES = copies XES512I FORM = form XES512I CLASS = class XES512I CHAR1 = trc1 XES512I CHAR2 = trc2 XES512I CHAR3 = trc3 XES512I CHAR4 = trc4 XES512I JOB ID = job id XES512I JOBNAME = jname XES512I USERID = user XES512I DEST = dest XES512I ROOM NR = room number XES512I PROC = proc XES512I DSN = dataset name XES512I CLASS = class XES512I ADDRESS = address1 XES512I ADDRESS = address2 XES51
• • • • • • • • XES516W FSA DISCONNECT REJECTED ON PRINTER printer, RC = rc Description An error in the JES to IDAXFC FSA interface has occurred. Severity Processing for the named printer is terminated. Action Restart the idaXFC specifying an FSI trace option on the failing printer and contact the product distributor. Return code information can be found in the appropriate documentation for the FSA macro.
• • • • • • XES523I GDSFLAG = xx Description Trace information message. Severity Information only message. Action None. XES524I ffff ACTIVE ON PRINTER prtid FOR userid Description File number or MVS jobname is active on the printer prtid. Indicates print processing is active on the named printer. Severity Information only message. Action None.
• • • • • • • • XES530W RELDS REJECTED,RC = xx Description An error in the JES to IDAXFC FSA interface has occurred. Severity Processing for the named printer is terminated. Action Restart the idaXFC specifying an FSI trace option on the failing printer and contact the product distributor. Return code information can be found in the appropriate documentation for the FSI macro. XES531I DATASET FREE CALLED WITH FLAG xx Description Trace information record indicating dataset being released.
• • • • • • • XES537I NOTIFY USER TERMINATED Description Trace message. Severity TRACE message. Action none. XES540I HIGH MEMORY REQUESTED BY xxxxxx Description A request for memory was received from location xxxxxx. Notes Information-only message. XES541W INSUFFICIENT REGION FOR JOB Description Insufficient region is available for processing. Severity Processing on the named printer is terminated. Action Increase the region size for the idaXFC PROC, and restart the failing printer.
• • • • • • • XES546I STORAGE RELEASED AT address LENGTH size CALLED FROM xxxxxx Description Information-only message that defines the location of the virtual storage released during processing. The 8-byte hexadecimal field address indicates the released storage location, and the length field shows the storage range released, and the caller address location. Notes Information-only message.
• • • • • • • • • • XES705I START GRAPHIC ENTERED Description Trace information message. Notes Information-only message, produced when trace option is requested. XES706I GRAFX SIZE = value Description Trace information message. Notes Information-only message, produced when trace option is requested. XES707I GRAFY SIZE = value Description Trace information message. Notes Information-only message, produced when trace option is requested.
• • • • • • • • • XES715I MAP CODED FONT FAILED WITH RETURN CODE rc Description An attempt to access the default AFP font failed. Severity Output continues to be generated, however invalid output will be generated. Action Correct the invalid AFP font reference, and resubmit the print job. XES716I END PAGE ENTERED Description Trace information message. Notes Information-only message, produced when trace option is requested.
• • • • • • • XES724I INSUFFICIENT REGION FOR JOB Description Insufficient region is available for processing. Severity Processing is terminated. Action Increase the region size for the idaXFC PROC, and restart the print job. XES725I STORAGE ALLOCATED AT storage LENGTH length CALLED BY name Description Information-only message that defines the location of the virtual storage allocated during processing.
• • • • • • • XES750I MCF ENTERED FONT = font codepage AS nnn Description The Map Coded Font processing routine has been invoked for the FONT font, using the code page. The number nnn indicates the sequence number assigned to this font. Notes Information-only message. XES751I INVALID FONT CONTROL FOUND IN FONT font Description An AFPDS font control command in the input data stream contains an invalid command or length field. Severity Processing for the present print job is terminated.
• • • • • • • • • • XES758I MCF TERMINATED RC= rc Description The subroutine module MCF has completed processing. Notes Information-only message. XES759I ORIENTATION xx NOT FOUND IN FONT ffffffff Description An request to use a font fffffff with orientation xx failed, because the font does not contain this orientation. Severity Printing of the job indicated is terminated. Action Verify the specified font resource is available in the requested orientation.
• • • • • • • • • • • • • • • • • • • • XES787I member ddname CLOSED Description Information-only message. Notes Information-only message identifying that member ddname has been closed after processing. XES788I dataset member READ FAILED XES792W dataset member READ FAILED Description The named dataset member contained an invalid record format. Severity The output job producing the error is held and processing continues.
• • • • • • • • • • • • • • • • • XES990I USER EXIT 8 ENTERED XES990I USER EXIT 8 TERMINATED Description Trace information message. Severity Processing continues. Action None. XES991I USER EXIT 1 ENTERED XES991I USER EXIT 1 TERMINATED Description Trace information message. Severity Processing continues. Action None. XES992I USER EXIT 2 ENTERED XES992I USER EXIT 2 TERMINATED Description Trace information message. Severity Processing continues. Action None.
Appendix B. Data Stream Description Input Datastream Description This section describes the format of the input data supported by the product. XES input datastream can bee encoded in a variety of formats. The following formats are supported by the idaXFC: • EBCDIC XES XES data that has been generated in XES format using EBCDIC encoding. • Escape or Escape Escape Coding XES data that has been generated in ASCII format, and contains i-data single or double escape notation to enable data transfer.
Stop Underline *w Line Spacing *l Start Bolding *b Stop Bolding *p Centering *q Horizontal Tab Clear *d Horizontal Tab *t Units -1/60" inch *zg Units -1/300" inch *zf Landscape Draw Lines Horizontal *y Landscape Draw Lines Vertical *x Portrait Draw Lines Horizontal *x Portrait Draw Lines Vertical *y Absolute Text Placement *a
XES Datastream Limitations This section describes limitations regarding the XES support. • Printable Page size The actual printable page size produced will be dependant on the AFP output device being used, together with the formatting information supplied in the XES datastream. • Downloaded Translate Table This functionality cannot be directly supported (Character Table, (+T), however translate table modifications can be supported by customizing the supplied XESTRANS XES to AFP conversion program.
Glossary ABEND: Abnormal End refers to the abnormal termination of a (problem) program. data set: In the MVS operating environment, this refers to a collection of related records. AFP: Advanced Function Printing is a term that refers to the collection of printing functions for APA printers for printing text and graphics. dot: Dot used in this manual is synonymous with pel. AFPDS: Advanced Function Printing Data stream is a data stream format used for creating output to an AFP printer.
JCL: Job Control Language is an IBM-licensed language used for defining data and program resources for job submission to JES under the MVS Operating System. JES: Job Execution and Submission system is an IBM-licensed program used to schedule and spool input and output under the MVS Operating system. laser (light amplification by stimulated emission of radiation): A device that emits a coherent beam of light, used in electrophotographic printing.
Index A APF authorized library 18 APF authorized load library I 15 B Batch Installation Installation Software 32 C CA-spool customization 21 CA-Spool modifications 15 CLASS 27 Commands, Operator 34 D DEFAULT profile parameter DEFAULT, Keyword 24 DEST 27 28 ida XFC Product Hightlights 11 ida XFC profile default 28 IDAPSS control profile 23 idaPSS Exit Installation idaPSS XES Exit Resource Requirements 13 idaXFC control profile statement 24 idaXFC keywords 23 idaXFC Profile DEFAULT subparameters 25 idaX
profile keyword syntax 23 Program Properties Table 19 PRTID, subparameter 25 M messages, ida XFC A-1 modifications to JES2 19 MVS PPT modifications.
