Page 2 - Preface
Preface First Edition (February 1998) This document describes the installation and customization procedures for: • idaXFC Version 1.00 or higher under the following environments: * OS/390 * MVS/ESA * JES2 * JES3 • idaXFC batch under the following operating systems: * OS/390 * MVS/ESA • idaXFC Exit f...
Page 4 - Table of Contents
Table of Contents ida XFC Product Highlights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Year 2000 Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . ....
Page 6 - List of Illustrations
List of Illustrations Figure 1. Sample JCL to load the LOADXES JCL from the Product Tape . . . . . . . . . . 17 Figure 2. JCL Sample for IDAXFC Linkage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 Figure 3. IDAXFC PROCLIB Invocation Procedure . . . . . . . . . . . . . . . ....
Page 10 - idaPSS XES Conversion Exit Requirements
System Requirements This section describes the prerequisites for operation of the three different product installa-tion options: • Functional Subsystem Spool File Converter • idaPSS Program Exit • Batch program Common print resource requirements are listed in the last chapter in this section. Functi...
Page 11 - XES to AFP Batch Invocation Prerequisites; Printer Prerequisites; Print Resource Requirements
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 been installed at version7.05 or higher. There is no support of the idaPSS Exit with versions of idaPSS prior to thisversion level. XES to AFP Batch...
Page 12 - idaPSS XES Exit Installation Checklist
The installation process will require that the following items can be created / imple-mented 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 ava...
Page 13 - Batch Installation Checklist
This installation process requires that idaPSS has already been installed on the sys-tem 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 (optio...
Page 14 - General Installation Procedure; Load the datasets supplied on the product tape
General Installation Procedure The product tape contains a number of tape files that can be loaded using the IEBGENERutility. 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 requiredfiles and create the installation libr...
Page 15 - ida XFC Spool File Converter Installation Procedure; Install the supplied fonts and codepages; Create an APF authorized Library (or use an existing authlib); Generate the idaXFC program load module
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 installationtape in 300 pel. These fonts have been provided as samples only, to allow for installation validation, andcan be used ...
Page 16 - Authorize the IDAXFC PROC; Authorize the IDAXFC program module
Authorize the IDAXFC PROC Permit the IDAXFC program module to run in KEY=1 by adding an entry to the ProgramProperties Table (PPT) found in the SYS1.PARMLIB SCHEDXX member. The followingexample indicates the attributes required for the PPT: PPT PGMNAME(IDAXFC) /* PROGRAM MODULE */ CANCEL /* CAN BE C...
Page 18 - JES3 Installation; CA-Spool Customization
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 printworkload. Multiple FSS definitions could therefore be required. The following modifications are require...
Page 19 - Reinitialize The System; Sample IDAXFC Procedure
A more detailed description regarding the installation of an FSS can be found inChapter 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 inconjunction with the JES2 or JES3 spool systems....
Page 20 - IDAXFC Control Profile Description; Profile Keyword Syntax
Note: The library names in this sample should be tailored to your installation specifica- tions. The YYYYY.IDAXFC.AFPLIB and XESLIB are included as sample dataset namesonly and are not generated during installation. IDAXFC Control Profile Description The IDAXFC profile is used to supply idaXFC confi...
Page 21 - General idaXFC control profile statements
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 DE...
Page 22 - idaPSS Profile Printer Subparameter Keywords
* Description Comment statement Subparameter(s) None Notes Comment statement used to format/document profile informa-tion. idaPSS Profile Printer Subparameter Keywords Printer definition and customization is performed using the PRINTER and DEFAULTkeywords. The types of customization are spool file o...
Page 24 - JES Output Configuration Parameters
JES Output Configuration Parameters CLASS= Description JES output class used for output directed to JES spool. The outputclass 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 parameterswill result in DY...
Page 25 - ida XFC Profile Defaults; ida XFC Printer Defaults
OUTPUT= Description Output statement reference for output directed to JES. The corre-sponding OUTPUT statement must be supplied in the idaXFC PROC. The output statement can be used to specify output formattingoptions, e.g. Page, Form definition, and other output controls. Range/Options 1-8 character...
Page 26 - Install the product tape files; Modify the PSS Exit 1 invocation source (optional)
idaPSS XES Exit Installation and Modification This section describes the procedure required to install the idaPSS Exit component sup-plied with this product. The supplied XES Exit software can be installed together with ex-isting program Exits, and does not alter their functionality. The XES input d...
Page 28 - Implement idaPSS Profile updates
• Overlay library concatenation (XES overlays) Implement idaPSS Profile updates Selection of XES processing requires that the EXIT1 and EXIT8 options are inlcuded on thePRINTER (or DEFAULT statements). Both of these exits are used to process XES inputdatastream. There are no additional idaPSS profil...
Page 29 - Generation of the Load Library; Install the supplied Fonts and Codepages; Customize the XES Translation
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 mod...
Page 30 - idaXFC batch Installation Verification Procedure
Generate the idaXFC program load module The following JCL indicates the JCL used to generate the program load module. Modify thesupplied 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 LK...
Page 31 - idaXFC Spool File Converter Operator Commands
idaXFC Spool File Converter Operator Commands The idaXFC utilizes an operator interface. This interface permits the modification of config-uration values without requiring that idaXFC is shutdown and restarted. Operator com-mands can be entered at the Master console or using a program that supports ...
Page 33 - XES Transform modifications; Modification of XES to AFP Font selection
XES Transform modifications This section describes how the supplied XES translation source, XESTRANS can be modi-fied 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 re...
Page 35 - Modifying the XES FORMS Data Definition Reference; Modifying the Default User Defined Key
Modifying the XES FORMS Data Definition Reference If the default DDNAME reference to the location of XES forms is not suitable, it can bemodified using the DDNAME Entry. The DDNAME label contains the DDNAME referencethat will be used by the XES transform when XES forms are requested. Note: Use of XE...
Page 66 - XES Datastream
Appendix B. Data Stream Description Input Datastream Description This section describes the format of the input data supported by the product. XES inputdatastream can bee encoded in a variety of formats. The following formats are supportedby the idaXFC : • EBCDIC XES XES data that has been generated...
Page 68 - XES Datastream Limitations
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 devicebeing used, together with the formatting information supplied in the XES datastream. • Downloaded Translate...
Page 69 - Glossary
Glossary ABEND: Abnormal End refers to the abnormal ter- mination of a (problem) program. AFP: Advanced Function Printing is a term that re- fers to the collection of printing functions for APAprinters for printing text and graphics. AFPDS: Advanced Function Printing Data stream is a data stream for...