Summary of the content on the page No. 1
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.com
IBMMAIL: DK9DXKDX
© i-data international a-s 1998
Summary of the content on the page No. 2
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 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. © Copyright i-dat
Summary of the content on the page No. 3
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. • "ida XFC Spool File Converter Installation Procedure" expla
Summary of the content on the page No. 4
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 . . . . . . . . . . . . . . . . . . . . . . . .
Summary of the content on the page No. 5
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 Tra
Summary of the content on the page No. 6
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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 Figure 4. Sample ida XFC Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 Figure 5. JCL Sample for IDAPSS XES Exit Linkage . .
Summary of the content on the page No. 7
List of Tables Table 1. List of Data sets Created by the Installation Procedure . . . . . . . . . . . . . . . . . 17 List of Tables vii
Summary of the content on the page No. 8
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. • Customization available for tailoring to installation specific requirements • Three separate installation options * Stand Alone XES to AFP Spool file conversion • Functional Subsystem Interface to JES spool system • Emulates a printer device to perform XES to
Summary of the content on the page No. 9
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. Date and time infor- mation used to generate log information uses the TIME macro to write the Julian date and time information i
Summary of the content on the page No. 10
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. 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). The load library used by the pr
Summary of the content on the page No. 11
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 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 idaXFC batch does not require the use of a Started Task and can be invoked via batc
Summary of the content on the page No. 12
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 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.
Summary of the content on the page No. 13
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 (optional) 5. Perform XES transform modifications (XESTRANS) 6. Relink idaPSS program module (LNKPSSX) 7. Implement idaPSS Proclib updates 8. Implement idaPSS Profile updates 9. Implement JCL modifications
Summary of the content on the page No. 14
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 obtain- ing the IEBGENER load JCL: //S1 EXEC PGM=IEBGENER //SYSUT1 DD DISP=OLD,DSN=IDATA.SL1,LABEL=(1,SL),UNIT=TAPE, // VOL=(PRIVATE,RETAIN,SER=IDA
Summary of the content on the page No. 15
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 libra
Summary of the content on the page No. 16
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. The following example indicates the attributes required for the PPT: PPT PGMNAME(IDAXFC) /* PROGRAM MODULE */ CANCEL /* CAN BE CANCELLED */ KEY(1) /* PROTECTION KEY */ AFF(NONE) /* NO PROCESSOR AFFINITY */ Dynamic activation of PPT table entries can be performed on newer MVS and OS/390 sys- tems using the authorized MVS Oper
Summary of the content on the page No. 17
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. PRT1 FSS=IDAXFC, MODE=FSS,PRMODE=(LINE,PAGE), CLASS=J,DRAIN, UCS=0, WS=(W,R,Q,PRM,LIM/F,UCS,FCB,P) T
Summary of the content on the page No. 18
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. Generate the JES3 FSS definitions The FSSNAME and PROC name in the following example are both
Summary of the content on the page No. 19
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 Proce- dure" for a listing of a sample CA-Spool startup Proc. Reinitialize The System It should be possible to dynamically add all necessary system definitions using MVS oper
Summary of the content on the page No. 20
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 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). The profile is
