Xerox D63-069-00 User Manual

Download

ida Xer ox File Conversion

Installation Guide

Docum ent 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 in ternationa l a-s 1998

Preface

First Edition (Febr uary 1998)

This document describes th e instal lation and customizati on procedures for:

•

idaXFC

idaXFC batch

•

idaXFC Exit for idaPSS

No warranty is expressed or implied in r egard to the accuracy of this pu blicat ion.

IBM, Xerox and XES are registered trademarks of Xerox Corporation.

Version 1.00 or higher under the following environme nts:

* OS/390 * MVS/ESA * JES2 * JES3

under the following oper ating systems:

* OS/390 * MVS/ESA

Version 7.05 or higher under the following environments:

* OS/390 * MVS/ESA * JES2 * JES3

i-data international a-s

IBM Print Services Facility

1998

is a re gistered trademark s of Internati onal Business Machines Corporation.

All other trademarks or registered trademarks are owned by t heir res pective companies.

ii ida XFC Product Guide

Revisions with this Edition

This section of this document is used to describe modifications that have been made with updates t o this document.

Organization of this Publication

• "ida XF C P r oduc t Highli ght s " des cr i bes t he

• "System Requirements" describes the system requirements for installation of the

idaXFC

• "General Installation Proced ure" explains how to load the product t ape.

• "ida XFC Spool File Converter Installation Procedure" explains how to install the

idaXFC

• "idaXFC Spool File Converter Operator Commands" explains the Operator control commands.

• "idaPSS XES Exit Installation and Modification" describes the installation of the

idaXFC

• "idaXFC batch Software Installation and Modification" describes the idaXFC batch installationprocedures.

and

idaXFC batch

as an idaPSS User Exit.

("batch").

idaXFC

product highli ghts.

idaXFC

Console

Preface iii

ida XFC Product Highlights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Year 2000 Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Functional Subsystem Spool Converter Requirements . . . . . . . . . . . . . . . . . 13

idaPSS XES Conversion Exit Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

XES to AFP Batch Invocation Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Printer Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Print Resource Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Functi onal S ubsyst em Spo ol File Converter Installation Overview . . . . . . . 14

idaPSS XES Exit Installation Checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Batch Installation Checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

General Installation Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Load the datasets supplied on the product tape . . . . . . . . . . . . . . . . . . . . . . 17

ida XFC Spool File Converter Installation Procedure . . . . . . . . . . . . . 18

Install the supplied fonts and c odepages . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Create an APF authorized Libra ry (or use an existing authlib) . . . . . . . . . . 18

Generate the idaXFC program load module . . . . . . . . . . . . . . . . . . . . . . . . . 18

Authorize the IDAXFC PROC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Authorize the IDAXFC program module . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Create/Modify IDAXFC Program Security Rules . . . . . . . . . . . . . . . . . . . . . . 19

JES2 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

JES3 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

CA-Spool Customization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Reinitialize The System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Install idaXFC PROCLIB Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Sample IDAXFC Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

IDAXFC Control Profi le Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Profile Keyword Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

General idaXFC control profile statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

idaPSS Profile Printer Subparameter Keywords . . . . . . . . . . . . . . . . . . . . . . 25

JES Output Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

ida XFC Profile Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

ida XFC Printer Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

idaPSS XES Exit Installation and Modification . . . . . . . . . . . . . . . . . . 29

iv ida XFC Product Guide

Install the product tape files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Install the supplied Fonts and Codepages . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Modify the PSS Exit 1 invocation source (optional) . . . . . . . . . . . . . . . . . . . 29

Perform XES transform modifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Relink idaPSS program module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Implement idaPSS Proclib updates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Implement idaPSS Profile updates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

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

Generate the idaXFC program load module . . . . . . . . . . . . . . . . . . . . . . . . . 33

idaXFC batch Installation Verification Procedure . . . . . . . . . . . . . . . . . . . . . . . 33

idaXFC Spool File Converter Operator Commands . . . . . . . . . . . . . . 34

XES Transfo rm modifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Modification of XES to AFP Font selection . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Modifications to the Lead-in and L ead-out st rings . . . . . . . . . . . . . . . . . . . . 37

Modification of Page Length and Margins . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Modifying the XES FORMS Data Definition Reference . . . . . . . . . . . . . . . . 38

Modifying the Default User Defined Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Modifying the Sixel Decoding Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Changing the Character Mapping and Language . . . . . . . . . . . . . . . . . . . . 38

Appendix A. idaXFC Messages and Codes . . . . . . . . . . . . . . . . . . . . A-1

Appendix B. Data Stream Description . . . . . . . . . . . . . . . . . . . . . . . . B-1

Input Datastream Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1

XES Datastream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1

XES Datastream Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-3

Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-1

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-3

Table of Contents v

List of Illustrations

Figure 1. Sample JCL to load the LO ADXES JCL f rom the P roduct 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 . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Figure 6. JCL Sample to print XES via idaPSS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Figure 7. JCL Sample for IDAXFC Linkage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Figure 8. JCL Sample Invocation of the XESREAD Program . . . . . . . . . . . . . . . . . . . . 33

Figure 9. Syntax of the Operator Interface - Operator Commands . . . . . . . . . . . . . . . . 34

Figure 10. Syntaxof the Operator Interface -Printer configuration . . . .. .. . .. .. .. .. 34

vi ida XFC Product Guide

List of Tables

Table 1. List of Data sets Created by the Installation Procedure . . . . . . . . . . . . . . . . . 17

List of Tables vii

ida XFC Product Highlights

• Convert s Xerox Escape Sequence printer (XES) datastream to AFP output

• Print legacy XES applicat ion output on A F P print er s

• Wide range of install options for flexibility to match existing print environment.

• Customization available for tailoring to installation specific requirements

• Three sepa rate installation options * Stand A l one XES to AF P Spool file conversion

• Functional Subsystem Interface to JES spool system

• Emulates a printer devi ce to perf orm XES to AFP spool conversion

• Generates s pool file outpu t for further processing

* idaPSS Exit Installation

* Batch Program

Year 2000 Support

• Can use JES defin ed Sysout class for output to

• Accepts IEBG ENER or other standard input

• Reads directl y from sp ool via Cross Memory Services

• Operator interface using MVS Modi fy command

• Operator controls via JES2/SDSF commands

• Provide XES to AFP conversion using existing idaPSS.

• Permi ts printing on pr inter s supported by idaPSS.

• Enhances idaPSS as a total print solut ion for AFP, Line and XES data.

• Wide range of connectivity options

• Provide XES to AFP conversion using batch job step.

• Generates Spool output to ex isti ng AFP printe r driver(s).

idaXFC

When the program functions that affect date/time processing will function correctly. Further information on IBM products level of Year 2000 conformance can be found at the following inte rnet location http://www.ibm.s390.com/st ories/year2000.

idaXFC

product is used on IBM Operating Systems that conform to Year 2000,

ida XFC Product Highlights 11

The following information further describes the use of date and time fields in the

idaXFC

2000 date sort considerations. The system date is used in conjunction with the following programfunctions:

• Log Information

does not contain any t ime based sort function s, and is therefore unaffected by year

idaXFC

mation used to gener ate log information uses the TIM E macro to write the Julian date and time information in the format YY:JJJ: HH:MM

can write info rma tio n to th e SYSL OG o r p ro g ra m lo g file. Date a nd time infor-

12 ida XFC Installation Guide

System Requirements

This section describes the prerequisites for operation of the thr ee different product installation op tions:

• Functional Subsystem Spool File Converter

• idaPSS Program Exit

• Batch program

Common print resource requirement s are listed in the last chapter in thi s 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 libra ry used by the program requires a minimum of 1 MB. DASD space. The remainder of the librari es supplied with the

space. The IDAXFC requires a mini mum region size of 4MB. The following product s are prerequisites for instal ling of

• Operating Syst em One of the following * OS/390 * MVS/ESA * MVS/XA

• Spool Subsystem. One of the following spool subsystems is required: * JES2/JES3 Spool system * CA-Spool Spool syst em

MVS product s i s r equired:

IBM

idaXFC

require approxim ately 1 MB . DASD

idaXFC

idaPSS XES Conversion Exit Requiremen ts

The idaPSS XES Exit requires that idaPSS has already been installed on the system. Only the OS/390 or MVS version of idaPSS may be used to install the idaPSS XES Exit.

For deta il s regarding support of specific prod uct vers ions, refer to rel a ted

i-dat a

documentation.

System Requ i r ements 13

Refer to 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 pr ior to th is

version level.

ida Print Sub system/MVS Produc t Ins tallation G uide

XES to AFP Batch Invocation Prerequisites

The following prerequisit e products are required to use t he XES to AFP batch program.

, D63-052 for additional de-

The

idaXFC batch

or TSO and uses reentrant and reusable codes. If required for performance reasons, the

idaXFC b atch

mended batch or TSO region size is 4MB. The

idaXFC b atc h

storage in a load library.

•

MVS/ESA Operating Systems

• JES2 or JES3 Spool sy s t e m

does not require the use of a S tarted Task and can be invoked via batch

program can be placed in the system Linklist or LPA. The minimum recom-

program operates as a batch job and requires approximately 1 MB. of

in conjunction wi th

Printer Prerequisites

The

idaXF C

output in AFP format. A suitable AFP printer or print conversion system is required to process the generated output. The characteristics of the AFP output is that it uses 300 pel resource references. The appropri at e pr inters pr es ent ly supported by

Spool File Converter and

idaXFC Exit for idaPSS

Print Resource Requirements

Use of the AFP output generated from the idaXFC conversion program requires access to AFP resources that are required to perform print formatting/and or conversion to print datastreams. It is assumed that the appropriate print resources that match the input datastream are available for subsequent print processing. Assistance with the conversion of print resources can be obtained by contacting the product distr ibutor .

idaXFC batch

idaPS S

TSO/ISPF

program version generate JES spool

can be used to generate output to .

AFP Resources of the f ollowing types may be used in p rint processing:

• 300 pel AFP Bou nded box fonts .

• Associa ted code pages and coded fonts .

• Forms defini tions

• Page overlays

• Page segments

• Page definitions

A minimal number of fonts and codepages are provided with the product for installation verification.

Functional Subsystem Spool File Converter Installation Overview

The following steps should be followed during the installation process. Prior to starting installation, please use the check list be low and read through t his entire proced ure to ensur e that you underst and the actions that are required.

• System preparation check list.

14 ida XFC Installation Guide

The installation process will require that the following items can be created / implemented pr ior to the operation of

1. APF authorized load library

An AP F authorized load library is required to execute t he IDAXFC program.

2. PROC library

A system-accessible procedure library should be available to be used for the startup procedure.

3. MVS PPT modifications.

Modifi cat ion s to the Pr ogram Pr opert ies T abl e wi ll be requi r ed to per mit operat io n of the IDAXFC.

4. System security rules (e.g. RACF/ACF) for the IDAXFC.

Rule de fin itio ns will b e r eq uir ed fo r th e I DAXFC PROC to p e rmit read access to AFP reso urc es. W rite ac cess for the con trol in forma tion d atas et will also be required based on a hi gh- level qual i fier.

5. Spool System FSS and Printer Definitions

Customizati on of either JES 2, JES3 or CA-Spool w ill be required * JES PARM deck modification

Definitions of the FSS and appropriate printer definitions will be required in the JES PARM deck. Both FSS and printer definitions can be dynamically added during normal JES processing, however for permanent FSS and printer definitions, a JES warm start will be required.

idaXFC

;

* CA-S pool modif i cations

Modifications to the startup procedure and customization of initialization values will be required. A CA-Spool warm start will be required to implement these changes .

• Installation checklist The following sequence can be used;

1. Load Files from product tape using IEBGENE R

2. Allocate / select an APF authorized load library for the IDAXFC module

3. Generate the IDAXFC load module using the BLDXFC JCL.

4. Create IDAXFC PROC member

5. Install the supplied codepages and fonts

6. Create/update installation security access for IDAXF C module

7. Perform JES2/J ES3 or CA-S pool customizat ion

8. Perform PPT table modif icati ons

9. Activate system modifications (IPL ) - JES warm start

10. Perform instal lation verification procedure

idaPSS XES Exit Installation Checklist

This checklist describes the sequence of activities required to perform installation of the idaXFC XE S exits when idaPSS ha s already be en instal led on the system.

1. Installation of ida PSS Vers ion 7.05 or higher

System Requirements 15

This installation process requires that idaPSS has already been installed on the system according to t he idaPSS installat ion manual.

2. Install the product tape files using the LOADXE S JCL

3. Install the supplied codepages and fonts

4. Modify the PSS Exit 1 ass embler source and CH ANEX IT code (optional)

5. Perform XES transform modifications (XESTRANS)

6. Relink idaPSS program module (LNKPSSX)

7. Implement idaPSS Proclib updates

8. Implement i daP SS Prof ile updat es

9. Implement JCL modifications for XES selection (PRTXES)

Batch Installation Checklist

This checklist describes the sequence of activities required to perform batch installation. Items are listed in the sequence that they are required. The entire list should be reviewed prior to st ar t ing the inst allation procedure:

1. Download the load JCL from the installati on tape

2. Modify the load JCL for installation defaults

3. Install the supplied codepages and fonts

4. Perform customization of the XESTRANS source if required

5. Modify the "LNKXESR" JCL to installation defaults

6. Execute the "LNKXESR" JCL to crea te the program Load Module

7. Perform the insta llation veri fication procedure

16 ida XFC Installation Guide

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 IEBG ENER JCL t hat 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.SL1,LABEL=(1,SL),UNIT=TAPE, // VOL=(PRIVATE,RETAIN,SER=IDATA) //* //SYSUT2 DD DISP=(NEW,CATLG,DELETE),DSN=IDAXFC.JCLLIB(LOADXES), // SPACE=(TRK,(20,20,28)),UNIT=DISK,VOL=SER=XXXXXX //* //SYSIN DD DUMMY //SYSPRINT DD SYSOUT=* /*

Figure 1. Sample JCL to load the LOADXE S JCL f rom the Product Tape

The LOADXES JCL contained in tape file one should be customized according to your installation s tandards, and can subsequent ly be executed to read all necessary files from the product tape.

Upon execut ion of the LOADXES J CL, the following dat a sets are c reated:

Data set name Data set type Organization Description

JCL JCL Library User specified Program J CL Library MEMO 1403 output

XES.MACLIB Macro Library

ASM Assembler Source Libr ary

OBJ Progr am Object Library

FONT300 Font Library

PS, VBM, LRECL 132, BLKSIZE 4096

PO, FB, LRECL 80, BLKSIZE 3120

PO, VBM, LRECL 8205, BLKS IZE 15000

Installation memo and documentation

Macro cont rol statements

Assemble r Source C ode Object Code Library for

program modul es Font Li br ar y f or supplied

300 pel fo nts and codepages.

Table 1. List of Data set s Created by the Ins tallation Procedure

General Installation Procedure 17

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 conjuncti on w i th AFP gener ator progr ams, and f or printing wit h IBM AFP printers.

If r equired, these fonts (and associated code pag es) can be installed in an existing 300 pel font libraries.

Create an APF authorized Library (or use an existing authlib)

Creation of an authorized APF library can be performed by modifying the SYS1.PARMLIB member I EAAPF00. Supply t he name and volume of the new APF authorized library, e.g.

xxxx.IDAXFC.APF.LINKLIB VOLxxx

Altern a te l y , a d y nami c u p d ate o f the APF library c an b e fac ilita t e d us in g a PRO G x x mem ber containing an entry si milar to the f ollowing:

APF ADD

DSNAME(xxxxx.IDAXFC.APF.LINKLIB) VOLUME(volser)

idaXF C

and

The MVS SETPR OG can be subsequently used to activate the revised PROGX X member, e.g. (T PROG=xx, where xx is the PROGxx SYS1.PARMLIB member).

Generate the idaXFC program load module

The f ol low i ng JC L i n dica t es t he J CL us ed t o ge nerat e t he pr ogr am l oa d modul e. Modify t he supplied BLDX FC linkage editor JCL to match your installat ion standards.

The IDAXF C module must be linked using authorization code 1 (as shown) .

Note:

//* INSERT YOUR OWN JOB HEADER HERE //* //LNKPSS EXEC PGM=IEWL, // PARM='AC=1,LIST,LET,XREF,MAP,RENT' //SYSLMOD DD DISP=SHR,DSN=YYYYY.IDAXFC.APF.LINKLIB //OBJLIB DD DISP=SHR,DSN=YYYYY.IDAXFC.OBJ //SYSUT1 DD SPACE=(1024,(120,120),,,ROUND),UNIT=VIO //SYSPRINT DD SYSOUT=* //SYSLIN DD * INCLUDE OBJLIB(IDAXFC) NAME IDAXFC(R) /*

Figure 2. JCL Sample for IDAXFC Linkage

18 ida XFC Installation Guide

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 indicat es the attribut es required for the PPT:

PPT PGMNAME(IDAXFC) /* PROGRAM MODULE */

CANCEL /* CAN BE CANCELLED */ KEY(1) /* PROTECTION KEY */ AFF(NONE) /* NO PROCESSOR AFFINITY */

Dynamic activ ation of PPT table entries can be performed on newer MVS and OS/390 systems using the authorized MVS Operator SET SCH command, e.g. to activate member SCHED04, use the following command sequenc e:

T SCH=04,L

Authorize the IDAXFC program module

Permit the idaXFC PROC/program read access to fonts, XES forms and overlays from the system libraries i n R ACF or other security system(s). Where user libraries will be used, the security rules of the job submitter and the idaXFC will be in effect for these datasets.

Create/Modify IDAXFC Program Security Rules

A number of datasets are dynamically allocated during the operation of the IDAXFC which are used for logging. Permit the IDAXFC program to write on a non-temporary volume by creating/modifying system access security rules (if required). The high level dataset qualifier used during dataset creation is supplied in the IDAXFC profile DD NAME parameter.

JES2 Installation

The following modifications must be included in the JES2 param eter deck to define an FSS system and any associated printers.

The rec ommended JES printer defi nitions keywords are listed below :

Keyword Description

MODE=FSS PRMODE=(LINE,PAGE) UCS=0 ROUTECDE=dest

DRAIN

CLASS=x WS= Note:

ers that can be active simultaneou sly will depend on the processor siz e and pri nt w orkl oad. Multiple FSS definitions could ther efore be required.

1. Generate the FSS definition(s)

FSS printer definition Printer mode, accepts both line and page data Universal Character Set Recommen ded route code des ti nati on used t o di rect

output to this printer. Keyword indicates printer should be started by op-

erator START command. Output class to be initially proc essed. Work selection criteria.

Up to 2200 printers can be controlled by a single FSS. The actual number of print-

The FSSNAME and PROC name in the following example are both assumed to be IDAXFC.

The following example indicates a JES 2 FSS definition for JES2 versions prior to 4.1.

ida XFC Spool File Converter Installation Procedure 19

FSSDEF FSSNAME=IDAXFC,PROC=IDAXFC,HASPFSSM=HASPFSSM

The following example indicates a JES 2 FSS definition for JES2 versions after 4.1.

FSS(IDAXFC) PROC=IDAXFC,

Note:

HASPFSSM=HASPFSSM

When more than one FSS is defined, a

unique PROC name is require d for

eac h de finition

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)

The following example indicates a JES2 printer definition for JES2 versions 4.1 or higher.

PRT(1) FSS=IDAXFC, /* FUNCTIONAL SUBSYSTEM NAME */

PRT(2) FSS=IDAXFC,

MODE=FSS, /* Started by FSS */ CLASS=J, /* Class */ CKPTPAGE=20, /* Max page before a checkpoint */ DRAIN, /* Drained at initialization */ ROUTECDE=U7, /* Routecode */ UCS=0, /* Ucs */ PRMODE=(PAGE,LINE), /* Printer mode */ WS=(W,R,Q,PRM,LIM/F,UCS,FCB,P)

MODE=FSS,PRMODE=(LINE,PAGE), CLASS=J,DRAIN, UCS=0, WS=(W,R,Q,PRM,LIM/F,UCS,FCB,P)

/* */

Consult the rel eva nt JES p ubl i cat i ons f or f urt her i nf or mati o n on t he above par am eter s. To permit the distribution of print to a specific printer unit, a route code definition

should be supplied with the printer definition. This can be performed using the ROUTCDE= statement.

When a JES2 DESTID statement is also added as shown following, it is possible to directly addre ss a specific pri nter with the use of the DEST parameter on the SYSO UT or OUTPUT s tatements.

PRT(1) FSS=IDAXFC,

DESTID(PCPRT1) DEST=U1111

Both FSS and printer definit ions can also be dynamically added to JES2 d uring normal operation. Define the FSS proc first prior to defining any specific printers. The following JES2 commands are indicated as examples only, and will requ i re mod ifi c at io ns to m e et yo u r in stallation requirements. These examples of JES2 operator commands assume the availability of a PROCLIB member IDAXFC.

ADD FSS(FSS1),PROC=IDAXFC

ADD PRT20,MODE=FSS,FSS=FSS1,MODE=FSS,PRM=(LINE,PAGE),UCS=0,WS=(....

Consult the relevant JES publ icati ons for further information on t he above parameters.

20 ida XFC Installation Guide

MODE=FSS, PRMODE=(LINE,PAGE), CLASS=J,DRAIN, UCS=0, WS=(W,R,Q,PRM,LIM/F,UCS,FCB,P), ROUTECDE=U1111

JES3 Installation

Note:

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

2. Generate the JES3 printer definition

JES3 3.1. 3 supports contr ol of up to 32 printer s by a singl e F SS . The actual number

The FSSNAME and PROC name in the following example are both assumed to be IDAXFC.

FSSDEF,PNAME=IDAXFC,FSSNAME=IDAXFC,TYPE=WTR,SYSTEM=SYS1

When more than one FSS is defined, a

Note:

unique PROC name is r equire d on

eac h de finition

DEVICE,DTYPE=PRT3820,JNAME=PRT1,JUNIT=(,SYS1,, ON),

FSSNAME=IDAXFC,MODE=FSS,PM=(LINE,PAGE)

Consult the rel eva nt JES p ubl i cat i ons f or f urt her i nf or mati o n on t he above par am eter s. To permit the distribution of print to a specific printer unit, a route code definition

should be supplied with the printer definition. This can be performed using the ROUTCDE= statement. When a DESTID statement is also added as shown following, it is possible to di rectl y address a spec ific printer wit h the use of the DEST parameter:

DEVICE,DTYPE=PRT3820,JNAME=PRT1,JUNIT=(,SYS1,, ON),

FSSNAME=IDAXFC,MODE=FSS,PM=(LINE,PAGE),ROUTECDE= U1111

DESTID(PCPRT1) DEST=U1111

CA-Spool Customization

This procedure should only be used where the IDAXFC is to be installed under control of CA-Spool.

1. Customize t he CA-Spool i nitializat ion statements t o include the IDAXFC Modification of the CA-Spool initialization statements will be required to define the

idaXFC

fines a Functional Subsystem called IDAXFC, and adds two printer definitions, for NODE printer 1 and Node p rinter 2.

and a ll p r in ters th at will be def ined to the

************************************************ ************* * E S F X PARAMETER LIST * *************************************************************

FSSDEF IDAXFC,PROC=IDAXFC *************************************************************

* DEFNODE DEFINITION * *************************************************************

NODE PRT1,3812,CLASS=AQ,GROUP=2,PURGE=NO,

NODE PRT2,3812,CLASS=AQ,GROUP=2,PURGE=NO,

idaXFC

ACQUIRE=NO,REST=YES,RELEASE=NO, AUTO=YES,SETUP=FORM,RDQUERY=NO, FORM=STD,INITFF=NO,FSS=IDAXFC

. The following example de-

ida XFC Spool File Converter Installation Procedure 21

A more detailed description regarding the installation of an FSS can be found in Chapter 3.24 of the

CA-S pool Init iali zat ion and Custo mi z at ion Guide

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" fo r a listing of a sample C A-Spool startup Proc.

Reinitialize The System

It should be possible to dynamically add all necessary system definitions using MVS operator cons ole commands (authorized) to s tart idaXFC, e.g.

• APF member changes ( T PROG=xx, for SYS1.PARMLIB m ember PRO Gxx)

• PPT member changes ( T SCH=xx, for SYS1.PARMLIB member SCHxx)

• JES FSS and printer definitions

• Security modi fications (as required)

For earli er versions of MVS , an I PL may be requir ed to i mpl ement the P PT changes. A JES COLD start will be required to permanently add FSS and Printer definition changes.

Consult relev ant IBM publications f or further inf ormation.

Install idaXFC PROCLIB Member

, Version 10.0.

A proclib definition is requir ed th a t w ill be re f e r e n c e d whe n the JES printer start command. The proclib selected must be defined in the JES2 startup PROC. The used member name must match the name supplied in the JES2/JES3 or CA-Spool PROC printer definition. A sample initialization PROC with accompanying parameters is defined in "IDAXFC C ontrol Profile Description" on page 23. Refer to this chapter regarding r elevant cus tomization options suppl ied in IDAXFC profile c ontrol statement s.

Once th e s ta rtu p PR OC is pla c ed in t he a pp ro pria te sta rtu p libr ar y, y ou will b e ab le to in itialize the

idaXF C

Sample IDAXFC Procedure

The following example indicat es a sample IDAXFC procedure:

//******************************************** ******************* //** ** //** IDA XFC (C) I-DATA INTERNATIONAL A/S 1998 ** //** ** //** STARTUP PROCEDURE ** //** ** //*************************************************************** //IDAXFC PROC //IDAXFC EXEC PGM=IDAXFC,TIME=1440 //STEPLIB DD DISP=SHR,DSN=YYYYY.IDAXFC.APF.LINKLIB //SYSPROF DD DISP=SHR,DSN=YYYYY.IDAXFC.JCLLIB(IDAPROF) //SYSUDUMP DD SYSOUT=E //PRT1LOG DD SYSOUT=E //PRT3LOG DD SYSOUT=E //* //FONT300 DD DISP=SHR,DSN=YYYYY.IDAPSS.FONT300 // DD DISP=SHR,DSN=SYS1.FONTLIB // DD DISP=SHR,DSN=SYS11.FONTLIBB //OVLY38PP DD DISP=SHR,DSN=YYYYY.IDAXFC.AFPLIB //XESLIB DD DISP=SHR,DSN=YYYYY.IDAXFC.XESLIB //*

idaXFC

is started using the

Figure 3. IDA XFC PROCLIB In vocation Procedure

22 ida XFC Installation Guide

The library names in this sample should be tailored to your installation specifica-

Note:

tions. The YYYYY.IDAXFC.AFPLIB and XESLIB are included as sample dataset names only and are

generated during installation.

not

IDAXFC Control Profile Descri ption

The IDAXFC profile is used to supply idaXFC configuration options, e.g. general customization and print er definitions . The profile must be lo cated in a separate member or dataset (not instream) with a maximum width of 80 characters). The profile is divided into two sections, general definitions related to the entire subsystem and individual printer definitions. Printer related informati on consists of two components, a default pri nter profile and specif i c pr i nter defi n i tions.

The d e f a ult printe r defin it io n is u s ed t o spe c ify t h e def a ult va lues that w ill b e used fo r s uccessive printer definitions. Multiple default statements can be included to permit for generation of defau lt attributes for eac h printe r type. Values specified in the default definition will be used where a specific value is

The printer definition defines each printer available to the resp onding J ES or CA-S p o ol de finition w ill be re quired before the printer ca n be a c tiv ated . Printer specific information can be included with in this definition,

A sample profi le is indicated in Figure 4 on page 24.

Profile Keyword Syntax

The IDAXFC profile can be up to 80 characters, and consists of keyword and subparameter values. Keyword values mus t be placed in column one, followed by one or more sub-parameters (as appropriate) separated by a space. The comma is used as a continuation character after the l ast keywor d, and th e following sub-parameter s can be placed on consecutive li nes after column one.

Lines that do not contain a keyword, or are not continuation lines are interpreted as comment statements.

The following profile keywords can be defined:

• DEF AULT (defaul t printer definitions) The default statement must always be placed prior to the first PRINTER statement

within each FSS system. Multiple DEFAULT statements can be defined (e.g. after printer statements to enable the definition of printer opti ons by pri nter type).

• FSSNAM E (FSS name) - used to define multiple FSS's within a sing le profile. This keyword is not applicable when only a single FSS is defi ned.

• PRIN T ER (1 to 2200 pr i n t er def initions) Up to 2200 printers can be defined in each FSS subsystem. Multiple subsystems can

be defin ed to address additi onal printers. A sample idaXFC profile definition is illustrated on the following page that can be used

to control multiple printers fr om a single functional subsystem:

specified in t he print er defi nition.

not

idaXFC

. Remember that a cor-

ida XFC Spool File Converter Installation Procedure 23

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 ex planation of the

idaXFC

control pr of ile st at em ents.

General i d aXFC con t rol prof ile statements

The following statements can be defined for each idaPSS subsystem, or multiple subsystems:

DEFAULT

Description Defines default Printer Configuration for all printers within a

Subparameter(s) Notes Refer to the idaXFC PRINTER table for a description of the

FSSNAME

Description Member name that includes t he procedure containi ng the FSS

Subparameter(s)

XFC subsystem. Values can be overri dden usin g the individual PRINTER statements. The default statement must be placed prior to individual PRINTER statement s.

All printer related keywords.

additional keywords. Multiple DEFAULT statements can be specified, to establish

printer defaul ts for individual printer types.

startup PROC. Each FSS system may contain optional DEFAULT and PRINTER statements.

1-8 character FSS nam e.

Note s Use this ke y wor d to d ef ine mu ltip le FSS sy s tem s w ith in a s in-

PRINTER

Description Defines printer attributes/characteristics. Options can be sup-

Subparameter(s) Notes Refer to the PRINTER keywor d options for more description of

24 ida XFC Installation Guide

gle IDAXFC profile. The SYSPROF statement for all FSS systems contained within the profile should point to the same member name.

plied to override the default configuration.

Any PRINTER subparameter keywords.

the sub-parameters .

Description Comment statement Subparameter(s) Notes Comment statement used to format/document profile informa-

None

tion.

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. The DEFAULT keyword can be used to reduce the number of definitions required for individual printers, and to select your installation specific de fault values. Unless stated, all values are optional.

The following keywords can be used with the idaXFC profile PRINTER and DEFAULT statements. The first keywor d that must always be specified for each PRI NTER statement is the PRTID keyword, which identifies the printer's JES name. The remainder of the keywords c an be specified in a ny sequence (comma separated). If more than one k ey word is specified that affects the same configuration values, the keyword specified last will be used.

PRTID=

Description JES Printer definition/name. Range/Options Notes This keyword must be placed as the first keyword on the profile

1-8 character name

PRINTER statement.

FONTLIB=

LOGDD=

Description The DDname used to select fonts for the idaPSS Procedure. Range/Options Notes None.

Description Supplies the destination to be used for printer related error informa-

Range/Options Notes If LOGDD is omitted, CONSOLE error logging will be used. If th e

FONT300B

tion. The CONSOLE (default) option indicates that operator WTO message s will be generated. PRINTER indicates that error pages are sent to printer. DDNAME indicates file recording of to supplied DDNA ME that must be specified in startup PR OC.

CONSOLE

DDNAME option is used, a separate DDNAME is required for print er , ex ce pt

Using the PRINTER option, the MPDEF statement is used to specify the page definit ion used to format error mess ages.

A Julian date and timestamp is added to output messages when the PRINTER or DDNAME options are used. WTO messages sent to the MCS Console do not include date/timestamp information. When dataset output is selected (DDNAME), in the event that the dataset becomes full, logging will be wrapped.

| 1-8 character DDname reference.

| PRINTER | DDNAME

each

when directing output to SYSOUT.

ida XFC Spool File Converter Installation Procedure 25

OVLYLIB=

Description The DDname used to select Forms ove rlay definitions

PAPER=

PRMODE=

Range/Options Notes This library ref erence is on ly used in conjunction with XES forms .

Description This keyword defines the paper size available in the target printer.

Range/Options

Notes The supplied paper size is used to format the print data. If this value

Description This keyword defines the which JCL PRMODE will be used to indi-

Range/Options Note s If this key word is o mitted, the defa ult va lu e of PRMO DE=XES will be

OVLY38PP

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.

A4 DL | C5

does not match th e i nst al l ed paper i n t h e pri nt er , i ncor rec t o utpu t m ay be produced.

cate that XES to AFP conversion is required, size.

XES

used to (for outpu t select ion).

| 1-8 character DDname r eference.

| 1-8 character name.

TRACE=

XESLIB=

Description Activates a program trace (using the supplied trace option). Trace

output is directed to the target specified in the LOGDD keyword.

Multiple tr ac e options may be supplied . Range/Options Notes Care should be taken that sufficient DASD space is allocated when

Description The DDname used to select XES Forms Range/Options Notes This library ref erence is on ly used in conjunction with XES forms .

OFF | IO | FLOW | HEX | JOB | ALLOCATE | FSI | WTO | ALL

writing to a f ile ( o th erwise a wrap c o n d it io n w ill o ccur ). Multiple trace

options can be specified with successive TRACE keywords.

The JOB option records print job stop/start actions. The OFF option

disables tracing. IO traces program input/output. FLOW traces pro-

gram flow. ALLOCATE traces memory utilization and

allocations/deallocations. HEX traces all input data in hexadecimal.

FSI traces JES FSI calls and return codes. WTO includes operator

WTO's in the trace data. TRANS traces the input and output

datastream to and from the XES to AFP transform.

XESLIB

| 1-8 character DDname reference.

26 ida XFC Installation Guide

JES Output Configuration Parameters

CLASS=

DEST=

FCB=

Description JES output class used for output directed to JES spool. The output

Range/Options Notes Only valid JES param eter values should be used. Inv alid parameters

Description JES output destination name for output directed to JES. If this value

Range/Options 1-8 character JES DEST name Note s The de fau lt valu e o f PRTID will be us ed if t his pa ram eter is omit ted.

Description FCB statement for output directed to JES (optional). Permits defi-

Range/Opt ions 1-4 character F C B nam e Notes No default value applies. Only valid JES parameter values should be

class used (defaul t A) must be defined in JE S.

| JES defined output class

will result in DYNALLOC OPEN errors when attempting to print.

is omitted, the PRTID value will be used for DEST(i.e. default).

This keyword is only used for JES output. Keyword overrides the

OUTPUT statement. Only valid JES parameter values should be

used. Invalid parameters will result in DYNALLOC OPEN errors when

attempting to print.

nition of FCB options for J ES outp ut.

used. Invalid parameters will result in DYNALLOC OPEN errors when

attempting to print.

FORMS=

NODE=

Description JES output forms nam e for output directed to JES. Thi s parameter is

used for the JES Work Selection criteria. Range/Options 1-4 character JES FOR M S 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.

Description JES node to be used for output routed via JES. No default value ap-

plies. Where o nly one JES system is in use, this definition can be

omitted. Range/Options 1-8 character JES NODE name Notes This keyword can be used to direct output to another JES complex,

or a remote system defined to the local JES complex. This keyword

is only used for JES output. Only valid JES parameter values should

be used. Inva lid pa ramete rs will resu lt in DYNAL LOC OPEN e rrors

when attem pt ing to prin t .

ida XFC Spool File Converter Installation Procedure 27

OUTPUT=

Description Output statement reference for output directed to JES. The corre-

Range/Options 1-8 character OUTPUT statement name Notes No default value applies. Only valid JES parameter values should be

ida XFC Profile Defaults

The following ida XFC profile default values ar e us ed.

Keyword Description

DEFAULT PRINTER

ida XFC Printer Defaults

The following PRINTER and DEFAULT keyword profile parameters are used as default when a parameter i s omitted.

The following defaults apply to resour ce location:

sponding OUTPUT statement must be supplied in t he

The output statement can be used to specify output formatting

options, e.g. Page, Form definit ion, and other output controls.

used. Invalid parameters will result in DYNALLOC OPEN errors when

attempting to print.

Refer to the following table. Refer to the following table.

idaXFC

PROC.

Sub-parameter Descriptio n

FONTLIB OVLYLIB XESLIB

The following defaults apply for print formatting and printer configurat ion:

Sub-parameter Descriptio n

PAPER= LOGDD=

DD name F ONT300B DD name OVLY38PP DD name XESLIB

A4 paper size will be selected. The CONSOLE option will be used (which generates output to t he

console MCS log).

28 ida XFC Installation Guide

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 datastre am c an be printed on the same output devices presently driven by idaPSS (for AFP data). The supplied XES exit softwar e requires installation of User Exit's 1 and 8.

Please ensure that the idaPSS subsystem has previously been successfully in-

Note:

stalled prior to installing the idaPSS XES conversion Exit. The following steps are required to i nstall the idaXFC exit for idaPSS:

1. Install the product tape files

2. Install the supplied fonts and codepages

3. Modify the PSS Exit 1 invocation source (optional )

4. Perform X ES transform modifications

5. Relink idaPSS program module

6. Implement idaPSS Proclib updates

7. Implement i daP SS Prof ile updat es

8. Implement JCL modifications for XES selection

Install the product tape files

Installation of the product tape is described in "Load the datasets supplied on the product tape" on page 17. The product libraries created do not conflict or modify the current idaPSS installation libraries.

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 i n conjunction with AFP generator programs , and for printi ng with IBM AFP printers.

If requir ed, these font s ( an d associated code pages) can be i n st alled in an exi s t ing 300 pel font libraries.

Modify the PSS Exit 1 invocation source (optional)

Selection of the XES to AFP exit is performed using a modification to Exit 1 that selects XES output based on the value of the JCL OUTPUT DD statement PRMODE option (i.e. PRMODE=XES). If your installation plans on using another PRMODE value to identify the print datastream type, modify the CHANEXIT source appropriately. If you wish to use another JCL option to indicate that XES to AFP conversion is required, other you may select

idaPSS XES Exit Installation and Modification 29

idaXFC

and

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 PR MODE=XES will be used as the s electi on criteria.

In addition, if you are already using the Logical Record Processing Exit PSSUX1: Exit 1, you will need to modify the CH ANEXIT assembler source.

Perform XES transform modifications

The supplied XES translation source, XESTRANS can be modified to alter:

• XES to AF P font s election (including codepage)

• XES Lead-in and Lead-out st r ings

• Page length and margins

• External DD name for FORMS referenc es

• Defaul t User Defined Key (UDK)

• Modifying the sixel decoding table

• Default EBCDIC language tr anslation (codepage) If any modifications are required to these values, refer to the steps described in "XES

Transform modifications" on page 36for additional information. TheXESTRANS module will need to be relinked prior to proceedi ng (as described in this section).

Relink idaPSS program module

The supplied LNKPSSX JCL indicates a sample JCL that relinks the idaPSS load module. Modifi cat io ns will be required to thi s JCL t o matc h your i nsta ll ati on def ault s, and if user exi ts have already been i n stalled.

The sample LNKPSSX JCL is illustrated following:

//* INSERT YOUR OWN JOB HEADER HERE //* //* SAMPLE JCL TO LKED XESEXIT INTO IDAPSS //* //LNKPSSX EXEC PGM=IEWL, // PARM='AC=1,LIST,LET,XREF,MAP,RENT' //SYSLMOD DD DISP=SHR,DSN=YYYYY.IDAPSS.APF.LINKLIB PSS LINKLIB //OBJLIB DD DISP=SHR,DSN=YYYYY.IDAPSS.OBJ PSS OBJECT // DD DISP=SHR,DSN=YYYYY.XES.OBJ XES OBJECT //SYSUT1 DD SPACE=(1024,(120,120),,,ROUND),UNIT=VIO //SYSPRINT DD SYSOUT=* //SYSLIN DD *

INCLUDE OBJLIB(IDAFSS) GET A PSS INCLUDE OBJLIB(XESEXIT) INCLUDE EXIT ITSELF INCLUDE OBJLIB(CHANEXIT) INCLUDE EXIT GLUE INCLUDE OBJLIB(XESTRANS) INCLUDE USER TRANSLATE TABLES NAME IDAPSS(R)

Figure 5. JCL Sample for IDAPSS XES Exit Linkage

Implement idaPSS Proclib updates

When using the XES exit, the following idaPSS PROCLIB updates are required:

• Additional XESLIB DD Statement (for XES forms) A new DD statement is required to access XES forms that can be referenced in the

inputdatastream.

• Font library concatenation (X ES fonts)

30 ida XFC Installation Guide

• Overlay library concat enation (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 re quired for c ontrol of XES to AFP processing.

Implement JCL modifications for XES selection

As supplied on the product tape, user selection of XES output is performed by using the OUTPUT DD PRMODE=XES. A sample invocation JCL is illustrated following:

//* INSERT YOUR OWN JOB HEADER HERE //* //OUT OUTPUT PRMODE=XES, <- TELL PSS IT IS XES // NOTIFY=('??????'), <- NOTIFY MYSELF WHEN PRINTED // DEST=PRT110 <- PRINTER //* //PRINT1 EXEC PGM=IEBGENER //SYSUT1 DD DISP=SHR,DSN=YYYYY.XES.TESTA(XES ) //SYSUT2 DD SYSOUT=A,OUTPUT=*.OUT //SYSIN DD DUMMY //SYSPRINT DD SYSOUT=* //*

Figure 6. JCL Sample to print XES via idaPSS

idaPSS XES Exit Installation and Modification 31

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 modules. Modify the data set name and volser information on the Load Module DCB statement to match your i nstallation defaults.

IBM

utility to generate the

IEWL

idaXFC batch

program load

The

Note:

The steps described below sho uld be perf ormed prior to using the

idaXFC batch

load module is reentrant and reusable.

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 i n conjunction with AFP generator programs , and for printi ng with IBM AFP printers.

If requir ed, these font s ( an d associated code pages) can be i n st alled in an exi s t ing 300 pel font libraries.

Customize the XES Translation

The supplied XES translation source, XESTRANS can be modified to alter:

• XES to AF P font s election (including codepage)

• XES Lead-in and Lead-out st r ings

• Page length and margins

• External DD name for FORMS referenc es

idaXFC batch

idaXFC

and

• Defaul t User Defined Key (UDK)

• Modifying the sixel decoding table

• Default EBCDIC language tr anslation (codepage)

If any modifications are required to these values, refer to the steps described in "XES Transform modifications" on page 36 for additional information. The XESTRANS module will need to be relinked prior to proceeding.

32 ida XFC Installation Guide

Generate the idaXFC program load module

The f ol low i ng JC L i n dica t es t he J CL us ed t o ge nerat e t he pr ogr am l oa d modul e. Modify t he supplied LNKXESR linkage editor JCL to match your instal lation standard s.

//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.OBJ //SYSUT1 DD SPACE=(1024,(120,120),,,ROUND),UNIT=VIO //SYSPRINT DD SYSOUT=* //SYSLIN DD * INCLUDE OBJLIB(XESREAD) INCLUDE OBJLIB(XESEXIT) INCLUDE OBJLIB(CHANEXIT) INCLUDE OBJLIB(XESTRANS) NAME XESREAD(R) /*

Figure 7. JCL Sample for IDAXFC Linkage

idaXFC batch Installation Verification Procedure

Verification of the correct function of the

idaXFC b atc h

can be performed using the verifi-

cation data sets supplied on the distribution tape.

//XESREAD JOB (ACCT#),' ',CLASS=A,MSGCLASS=X,MSGLEVEL=(1,1), // TIME=1440 //* //* SAMPLE JCL TO RUN XESREAD BATCH CONVERSION //* //XESREAD EXEC PGM=XESREAD,REGION=3500K //STEPLIB DD DISP=SHR,DSN=YYYYY.XES.LOADLIB //* //OUTA OUTPUT DEST=PRT111,PRMODE=PAGE //* //SYSUT1 DD DISP=SHR,DSN=XES.DATASET(XES) //SYSUT2 DD SYSOUT=A,OUTPUT=(*.OUTA), // DCB=(RECFM=VBM,LRECL=8205,BLKSIZE=32000) //* //SYSPRINT DD SYSOUT=* //* //FONT300 DD DISP=SHR,DSN=YYYYY.XES.FONT300 FONTS // DD DISP=SHR,DSN=SYS1.FONT300 //XESLIB DD DISP=SHR,DSN=YYYYY.XES.XESLIB FORMS //*

Figure 8. JCL Sample Invocation of the XESREAD Program

idaXFC batch Software Installation and Modification 33

idaXFC Sp ool File Converter Operato r Commands

The id a X FC u t iliz e s an o pera tor interfa c e . Th i s in terfa c e p ermits the mo d if ic a t io n 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). The comm ands support ed by the operator interface are indicated in the following figu res:

P procname | jobname F procname | jobname,ADD,prt, F procname | jobname,ADD,prt F procname | jobname,Disp, [ option...]

Options:

Default PRinter

Level STOP START FORCE DUMP

Figure 9. Syntax of the Operator Interface - Operator Commands

F procname | jobname,default, | prt,

Options:

TRACE= CLASS= DEST= FCB= FORMS= LOGDD= NODE= OUTPUT= PAPER= PRMODE= START=

Figure 10. Syntax of the Operator Interfac e - Printer configura tion

The operator interface provides f our basic types of operation:

• Start/Stop/Force Performs normal printer st artup, and normal system termination.

• Display Provides a display of pr inter and default configuration display information.

•Add Dynamic addition of new printer devices

• Modify printer/default

OFF | ALL | IO | HEX | OUTPUT | WTO | ALL output class

destination

fcb name

forms name ddname

JES output node

JES output ddname

A4 | A3 | LETTER | LEGAL | MONARCH | C5 | COM10 | EXECUTIVE

Printer selection mode

YES | NO

[ option...]

Modify printer and def au lt setti n gs

34 ida XFC Installation Guide

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

• Stop Printer This c ommand performs an orderly shutdown of t he print er.

• Force Printer This c ommand performs a forced shutdown of the printer. A VTAM UNBIND request is

issued to the printer. This command should be used to terminate printer communication in the eve nt of a error situation

•Dump Printer This command is used only for diagnostic purposes, and causes a display of internal

control blocks. Processing is no t affected with the use of this command.

• DISPLAY This command can be used to display the printer status and configuration (using op-

tional keyword s). Optional keywords that can be supplied are: *Printers

Displays a summary status of all printers

* Default

Displays the defau lt profile conf igurati o n keywords

* Single printer

Displays status and configurat ion information for a single print er

* Level

Displays the product software level

•ADD This command allows the addition of a new printer definition without requiring termi-

nation of the idaXFC. Prior to using this command, the printer to be defined must be defined to the V TAM application. The prt par ameter r efers to the printer name that will be used.

When printers are defined, only the printer name and printer related configur ation values are supplied. All other values are set to the configuration supplied on the default statement or actual keyword defaults (where no default value has been requested). Keywor d values can b e altere d using the modify operation.

Printer add and set commands first take effect when the prin ter is stopped and

Note:

restarted, and are in effect until the print system is terminated, or the next add or modify command is entered.

•MODIFY Any printer configuration value can be altered dynamically using the set command.

Values will first be used when the printer is stopped an d restarted. In addition, the Set default keyword can be used to alter the configuration values supplied for the default statement.

idaXFC Spool File Converter Operator Commands 35

XES Transform modifications

This section describes how the s upplied XES t ranslation source, XESTRANS can be modified to alter the following transform attribu tes:

• XES to AF P font s election (including codepage)

• Lead-in and Lead-out strings

• Page length and margins

• External DD name for FORMS referenc es

• Defaul t User Defined Key (UDK)

• Modifying the sixel decoding table

• Default EBCDIC language tr anslation (codepage)

Customizati on of the XEST RANS assembl er source is required t o tailor the operation of this transform. The default operation is designed to permit processing of datastreams that have been encoded using i-data FSL Escape or Escape Esca pe notation.

The format of the assembler source file requires that the notation used for Assembler source f iles is maint ained, e.g.

• The keyword macros are placed in column one.

• Keyword macro operands are placed in column 10, together with other data definitions.

• Line continuation (if required) requires an "X" in column 72, and the subsequent line must st art before position 10.

• Comments statements on an empty line are indicated using an asterisk in column one. Comment statements can be placed on other lines after a single space from the last comm and operand.

The supp lied XESTRANS a ssemb ler s ourc e ind icate s the standard configuration supplied with the product, and can be used as a reference example for modifications. The assembler source uses entry points to identify the various options that can be customized.

Certain entries in t his fi le are cas e s ensitive.

Note:

Modification of XES to AFP Font selection

The FONTTAB entry point is used to indicate (via the FONTENT macro) which AFP fonts will be used for XES font refe renc es. Th e firs t FONTENT sta teme nt de scrib es wh ich AFP font will be the default font. The syntax of the FONTENT macro subparameters are as follows.

• AFP Font name The six character font member name (excluding C0) that describes the AFP font

name.

• Codepage name

36 ida XFC Installation Guide

The six character codepage name (excluding T0) that describes the AFP codepage name.

• Xerox F ont Name The name of the Xerox XES source font. The supplied names are case sensitive. Do

not specify the trailing -l and -p id entifiers (landscape & p ortrait).

Termination of the FONTTAB definition is performed using the X'00' terminator (DC X'00'). Up to 63 fon ts can be spec if ied i n the F ON TT A B def ini ti on ( for a total of 126 font ref erences , for bot h landscape/portrait orientation).

Modifications to the Lead-in and Lead-out strings

The default MPI lead-in and lead-out strings can be modified to match your installation requirements. D efault s ettin gs are designed for operation i n conjunction with MPI escape sequences. The MPILI, MPILO, MPILIL, MPILOL entries describe the lead-in and lead-out sequences (and their corresponding lengths). The two to five character lead-in and leadout sequences should be specified in the MPILI and MPILO statements respectively. MPI lead-in and lead-out strings can be disabled by indicating a null length value in the MPLIL and MPILOL constants.

Modification of Page Length and Margins

The IMARGINS entry can be used to modify the page margin values, for printing in both portrait and landscape directions . The IMARGINS entry is used to identify the start of page margin definitions. Two sets of values are supplied, for both portrait and landscape values respect iv ely. Al l values are su ppl ied in 1/7200t h s of an i nch. For each set o f v al ue s, a page length, top, bottom, left and right margin values are required. The format of this entry is similar to the XES margins command.

Height Page height, (distance between the top edge and the

bottom edge of the page).

Top Margin Distance from the top edge of the page to the baseline

of the c haracters in the first line of text.

Bottom Margin Distance from the bottom edge of the page to the

baseline of the c haracters in the last line of text.

Left Margin Distance from the left edge of the page to the leftmost

point of the first c haracter in each line.

Right Margin Distance from the left edge of the page to the right s ide

of the last char acter in each line.

XES Transform modifications 37

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 .

Use of XES f orms may not apply t o your installation.

Note:

Modifying the Default User Defined Key

The Default UDK (User Defined Key) is used within XES print jobs to override the standar d escape sequence. The specified value may vary from installation to installation. The DEFUDK entry is used to alter the default value used by the program. If no UDK will be used, t he default value (X'1B') should be replaced with a s pace.

Modifying the Sixel Decoding Table

The XES datastream can contain non-printable text fields used to represent font and picture data in si xel format. Sixel en coding is used to el iminate the problem of f ont/image data being interpreted as characters or commands. Fonts are typically provided in sixel format, however you installation may use their own code routines to reconvert font or image data to other si xel encodi ng. If thi s is t he case , you m ay n eed t o mod if y th e def aul t supp li e d si xe l to bina ry decoding tables.

The TRTAB Entry point is used to start the definition of translate table from sixel format to binary encoding. All codepoints from 00 to FF are supplied in this table .

Changing the Character Mapping and Language

The

idaXFC

format. This applies to XES datastreams in ASCII (e.g. ESC ESC format) and EBCDIC format. From the ISO c odepage, selection of the language specific character selection is performed us ing the default language or XES language commands.

The default EBCDIC language or codepage can be selected by modifying the DEFLANG entry to incl ude the appropriate language number as requir ed.

converts the XES datastream input to a common ISO codepage 500 based

38 ida XFC Installation Guide

Appendix A. idaXFC Messages and Codes

Error messages produced by the idaXFC.. use the following syntax:

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. no additional date/timestamp identifier is used). Printer trace mes sages are routed to the destina tion specified in the LOGDD statement.

The following information is described for each message;

• Messages descriptor

•Description

• Message severity

• Require d action (where appropriat e)

Appendix A. idaXFC Messages an d Codes A-1

•

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

•

XES002I INVALID INPUT text

Description The supplied idaXF C profile statement is inva lid. Severity Processing will continue and this statement is ignored. Action Correct the incorr ect idaXFC pr ofile statement(s).

•

XES003I STATEMENT IS TOO LONG statement

Description The supplied idaXF C profile statement exceeds the valid length. Severity Processing will continue and this statement is ignored. Action Correct the incorr ect idaXFC pr ofile statement(s).

•

XES004I NEW KEYWORD FOLLOWING COMMA, COMMA IGNORED

Description An idaXFC profile keyword statement was supplied however, a con-

Severity Processing will continue and this statement is ignored. The new

Action Correct the incorrect idaXFC profile statement, by removing the mis-

prior to attempting a restart.

tinuation of the previ ous keyword was expected.

keyword will take eff ect.

placed comm a (as requi red).

•

XES005I INVALID KEYWORD nnnnnnnnn

Descri ption An idaX F C profile keywor d statement i s invali d. Severity Processing will continue and this statement is ignored. Action Review the documentation for a list of valid keywords.

•

XES006I SUB PARAMETERS IGNORED value

Description The value of a idaXFC profile sub parameter keyword is invalid Severity The id aXFC terminates. Action Correct the incorrect idaXFC profile sub parameter keyword, and re-

•

XES007I INVALID NON NUMERIC KEY key

Description The idaXFC profile KEY statement does not contain a valid decimal

Severity The id aXFC terminates. Action Correct the KEY statement b y sup plying a valid KEY value. Record

A-2 ida XFC Installation Guide

start the idaXFC.

value.

the CP UID if you have not yet obtained a key.

•

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 id aXFC terminates. Action Correct the incorr ect idaXFC pr ofile sub parameter keyword keyword

•

XES009I INVALID DECIMAL NUMBER argument

•

XES019I INVALID DECIMAL NUMBER argument

Description The idaXFC subparameter does not contain a v alid decimal value. Severity The id aXFC continues using the default for the named value. Action Correct the idaXFC subparam eter to include a valid decimal va lue.

•

XES010I SMF RECORD TYPE IS TOO LARGE

Description The idaXFC profile SM F keyword value exceeds the allowable range. Severity SMF recording will not be per formed. Action Cor rect the SMF keyword to reflect a valid value.

•

XES011I IDA XFC PRODUCT IS NOT LICENSED FOR THIS CPUID nnnn

Description The idaXFC program is not licensed for this CPU complex, or the

Severity The id aXFC terminates.

and restart the idaXFC.

specified key is invalid.

Action Obtain the required product key using the procedures described in

•

XES012I NO KEY SUPPLIED IN IDA XFC PROFILE

Description A KEY statement is missing in the idaXFC PROFILE specified key is

Severity The id aXFC terminates. Action Code the idaXFC PROFILE KEY statement using the product KEY

•

XES013I MORE THAN ONE PRINTER DEFINED IN TEST MODE

Description An

Severity The id aXFC terminates. Acti on Operati on of one print er i s possi bl e wit hout the pr oduct key (i .e. TE ST

the installation manual. The CPUID number supplied on this message should be recorded.

invalid.

supplied.

idaXFC

than one PRINTER statement is detect ed.

MODE) If additional printers are required to be tested, obtain a product key from the product distributor.

KEY PROFILE statement was not detected, and more

Appendix A. idaXFC Messages an d Codes A-3

•

XES014I IDA XFC RUNNING IN TEST MODE

Description The product is running in TEST MODE, where only one printer can

Severity Information only message. Action Operation of one ICDS printer is possible without the

•

XES015I NO PRINTERS DEFINED

Description An operator operation has been attempted when no printers are de-

Severity No action will be performed (printing is not possible). Action Respecify the idaX FC profile to reference one or more print ers.

•

XES016I IDA XFC LICENSED FOR nnnn PRINTERS

Description Operation of the product has terminated as the number of licensed

Severity Processing for the named subsystem is termin ate. Action A maximum of stated number of printers may be defined f or print op-

be defined.

PROFILE statement (i.e. TEST MODE). If additional printers are required to be tested, obtain a product key from the product distributor .

fined in the idaXFC profile.

printers has been exceeded.

eration to image. Support of additional printers will require use of another product key.

idaXFC

instances of IDAXFC operational on the same system

all

KEY

•

XES017I nnnn PRINTERS DEFINED

Description The

Severity Information only message. Action None.

•

XES019I INVALID DECIMAL NUMBER nnnnn

Description A non-decimal numeric value has been specified in the IDAXFC pro-

Severity The val ue specified will not be used for the named printer. Action Correct the IDA XFC profile entry for the target printer.

•

XES020I OUT OF RANGE nnnnn

Description An IDAXFC profile value contains a value that is outside of the ac-

Severity The val ue specified will not be used for the named printer. Action Correct the IDA XFC profile entry for the target printer.

idaXFC

PROFILE.

file.

ceptablerange.

has located nnnn PRINTER definitions in the

idaXFC

A-4 ida XFC Installation Guide

•

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 maxi-

mum 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. Severity Information only message.

•

XES025I IDA XFC PRODUCT WILL EXPIRE WITHIN nnn DAYS

Descriptio n The idaXFC KEY use d is a temp orary key that can b e used fo r the

foll ow ing nnn days. Severity The id aXFC processing continues. Action None. The KEY used is a temporary key that contains an expiration

date.

•

XES026I IDA XFC IS RUNNING ON CPUID nnnnnn

Description The idaXFC is running on CPU ID nnnnnn. Severity Information only message. Action None. This information can be used to obtain a product key. Refer to

the installation section for further information.

•

XES027I INVALID KEY key

Description The idaXFC profile KEY stat ement does not contain a valid v alue. Severity The id aXFC terminates. Action Correct the KEY statement b y sup plying a valid KEY value. Record

the CP UID if you have not yet obtained a key.

•

XES028I ERROR FOUND ON LINE nnn IN PROFILE

Description An error was encountered during processing of the

FILE. Severity The keyword(s) specified on the named line will not be processed. Action Correct the

idaXFC

PROFILE, and restart the IDAXFC subsystem.

PRO-

Appendix A. idaXFC Messages an d Codes A-5

•

XES029I DUPLICATE PRINTER NAME prtname

Description An attempt to dynamically add additional printers failed due to a du-

plicate printer name. Severity T he IDAXFC ADD PRINTER command was not performed. Action Ensure that the additional printer name does not confli ct with and ex-

isting printer name and reenter the IDA XFC Add Printer com mand.

•

XES030I YOU HAVE REACHED MAX NUMBER OF PRINTERS

Description The maximum number of printers that can be defined has been ex-

ceeded. Severity The idaXFC continues processing using the first 2200 printer (MVS)

or 128 (V M) definitions. Action Remove additional printer definitions to the allowable maximum. For

MVS, define additional FSS subsystems if more than 2200 printers

are require d. For VM, defi ne addit ion al GC S subsystem s if more than

128 printers are required.

•

XES032I INVALID TRACE OPTION tracetype

Description The idaXFC profile TRACE option is invalid. Severity The id aXFC continues. Action Correct the idaXFC TRACE s ubparameter option.

•

XES033I INVALID PAPER SELECT command

Description The idaXFC profile PAPER keyword contained an invalid numeric

Severity The id aXFC continues using the default for the named value. Action Correct the idaXFC subparameter t o include a valid numeric value.

•

XES034I BLANK NOT ALLOWED IN text

Description The supplied i daXFC profile keywor d c annot be defaulted. Severity Processing will continue and this statement is ignored. Acti on Corr ec t t he i nc orrect idaXFC profile ke yw ord, by supply i ng a value or

•

XES050I IDA XFC IS NOT IN PPT. KEY = nn

Description The idaXFC has not been defined in the MVS Program Properties

Severity Program execution is halted immediately.

value.

omitting this keywor d (use of default).

Table.

Action Ensure that a correct PPT entry exists prior to restarting the idaXFC.

A-6 ida XFC Installation Guide

•

XES051I IDENTIFY RC =

Description A severe error has been encountered pro cessing the identify macro. Severit y The F u nct i onal Subsystem i s t er mi n at ed. Action This error can be caused by duplicate file entries in the LPA

•

XES052W name, MISSING IN CIB DATA

Descri ption A severe pr ogram error has oc c urred. Severity Program execution is halted immediately. Action Restart the idaXFC specifying an FSI trace option on the failing

•

XES053W WRONG INVOCATION OF IDA XFC

Description The idaXFC has been initiat ed using an MVS START command. Severity Program execution is halted immediately. Action The JES or CA-Spool printer start c ommand should be used.

•

XES054W NO FSID IN CIB

Descri ption A severe pr ogram error has oc c urred. Severity Program execution is halted immediately. Action Restart the idaXFC specifying an FSI trace option on the failing

(PSSFSA00). For all other e rror conditions, contact the product dis-

tributor in dicating the named error message .

printer and contact the pr oduct distributor.

•

XES055I prtid LOGMODE = logmod PORT = port

•

XES055I prtid FDEFLIB = ddname PDEFLIB = ddname

•

XES055I prtid FONTLIB = ddname RESOURCE= ddname

•

XES055I prtid OVLYLIB = ddname PSEGLIB = ddname

•

XES055I prtid DEFAULT FORMDEF= member PAGEDEF= member

•

XES055I prtid HEADER FORMDEF= member PAGEDEF= member

•

XES055I prtid TRALER FORMDEF= member PAGEDEF= member

•

XES055I prtid SEPARATOR FORMDEF= member PAGEDEF= member

•

XES055I prtid MESSAGE FORMDEF= member PAGEDEF= member

•

XES055I prtid DEFAULT FCB = member FCBLIB= member

Description Response to a operator printer display command. The printer attri-

Severity Information only message. Action None.

•

XES060I IDA PRINT SUBSYSTEM VERSION version IS ACTIVE

Description The idaXFC has been initiat ed using a printer start command. Severity Information only message. Action None.

butes, and certain profile opt ions are displaye d.

Appendix A. idaXFC Messages an d Codes A-7

•

XES061I INVALID OPERATOR COMMAND command

Description An invalid idaXF C operator command was received. Severi t y T he comm and entered is i gnored. 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. Action Restart the idaXFC specifying an FSI trace option on the failing

printer and contact the pr oduct distributor.

•

XES063I keyword TO KEN TOO LONG

Description An idaXFC modify keyword exceed ed 16 characters. Severi t y Comm and t oken is ignored. Action Refer to the Operator Controls section in this document for a list of

valid operator c ommands and reenter the c ommand if required.

•

XES064I TOO MANY MODIFIED, REMAINDER SKIPPED

Description An excessive number of modify commands could not be a cc epted. Severity The addi tional modify c ommands will not be processed. Action Refer to the Operator Controls section in this document for a list of

valid operator commands and reenter the command if required. Up

to eight modify commands can be ent ered simultaneously .

•

XES066I BLANK MODIFY command

Description An idaXFC invalid modify command "command" was attempted. Severity The operator command is ignored. Action Refer to the

Controls section for a list of valid modify commands and reenter the

command if requir ed.

•

XES067I MODIFY COMMAND COMPLETED

Description The operator entered modify command has been accepted and is in

effect f o r t he su bs equent print j ob(s). Severity Information only message. Action None.

ida Print Subs y s tem Pro d uc t In sta llation Gu id e

Operator

A-8 ida XFC Installation Guide

•

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

Severity Processing continues, the command is not performed. Action Verify that the printer id or idaXFC service machine is correct and re-

•

XES069I DUPLICATE PRINTER NAME printer

Description The idaXFC PRINTER name has previously been defined. Severity The first definition of the PRINTE R name will be used. Action Remove the duplicate printer def inition, or modify the printer name to

•

XES070I NO PRINTER SPECIFIED IN ADD COMMAND

Description A dynamic printer addition has n ot been perf ormed due to an error in

Severity The addi tional printer is not added. Action Respecify the ADD printer command.

•

XES071I IDA XFC NOT LICENSED FOR MORE PRINTERS

that is not def ined to this idaXFC.

specify the command if required.

the corr ect value.

the ADD comm and ( pr i nter not spec i f ied).

Descri pt ion The total numb er of printer s defined in the

Severity The id aXFC terminates. Action You have attempted to define more printers (t hat exceed the number

the maxi mum all owed by the defined KEY.

permitted by your key license). If you wish to add additional printers,

an upgraded product key will be requir ed. Op erat ion of

be performed by reducing the number of PRINTER statements in the

idaXFC

•

XES073W FSS CONNECT REJECTED,RC = rc

Description Attachment of the idaXFC FSS to the spool subsystem failed. Severity idaXFC processing is terminated. Action Restart the idaXFC specifying an FSI trace option on the failing

•

XES076I IDA PRINT SUBSYSTEM VERSION version

Description Response to the operator Q SYS LEVEL com m and. Severity Information only message. Action None.

printer and contact the product distributor. Return code information

can be found in the appropriate documentation for the FS I macro.

PROFILE.

idaXFC

PROF I LE ex ceeds

idaXFC

can

Appendix A. idaXFC Messages an d Codes A-9

•

XES077I IDAXFC IS RUNNING TEST MODE WITH 2 PRINTERS

Description The product is operational with the named print ers in TEST mode. Severity Information only message. Action The product is operational in TEST mode (without a product KEY). If

•

XES078I IDAXFC IS LICENSED FOR nnnn PRINTERS

Description The product is operational with a license key that permits operation

Severity Information only message. Action None

•

XES079I PROC procname PRINTERS nnnn

Description Informational message describing the product characteristics, (Proc

Severity Information only message. Action None

•

XES080I ACTIVATING PRINTER printerid type id

Description The idaXFC has been initiated using a printer start command for the

Severity Information only message. Action None.

you wish to use the product with additional printers, a product KEY

will be required.

of up to nnnn printers.

name, and produc t l i c ens e key informa t ion).

named printer printerid using t he connection type specified.

•

XES081I printer IS ALREADY STARTED

Description An attempt was made to start printer "printerid" that has previously

Severity Processing continues. Action None.

•

XES084I PRINTER printerid DEACTIVATED

Description The PRINTER called printerid is terminated. Severity Information only message. Action None.

•

XES085I IDA XFC SHUTDOWN IN PROCESS

•

XES086I IDA XFC SHUTDOWN FORCE IN PROCESS

Description Termination is in progress for idaXFC in response to a shutdown

Severity Information only message. Action None.

A-10 ida XFC Installation Guide

been started.

command, M VS STOP or VTAM deactivation of APPLID.

•

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

•

XES088I IDA XFC SHUTDOWN COMPLETED

Description Termination is complete for idaXFC. Severity Information only message. Action None.

•

XES090I printer SIZE xxxx,yyyy ORIGO xxxx,yyyy PRINTAREA xxxx,yyyy

Description Information message generated as a result of an operator Display

Severity Information only message. Action None.

•

XES091I FSA STATUS xxxx xxxx xxxx xxxx

•

XES091I DATA ECB xxxx

•

XES091I RELEASED ECB xxxx

•

XES091I RECEIVE ECB xxxx

•

XES091I RESPONSE ECB xxxx

•

XES091I MESSAGE ECB xxxx

•

XES091I COM ECB xxxx

printer and contact the product distributor. Return code information

can be found in the appropriate documentation for the FS I macro.

command.

Description Response to a display printer, dump command. Severity Information only messages, processing conti nues. Action None.

•

XES099W MORE THAN 100 PSS START ED

Description The total number of IDAXFC functional subsystems that have been

Severity The attempt t o s tart s ubesquent ID AXFC FSS has failed. Action Reduce the total number of FSS subsystems defined or

•

XES092I PAPER type NOT DEFINED for printer A4 USED

Description A attempt to select an undefined paper size failed. The A4 default

Severity A4 paper size is selected for pri nt formatting. Action Verify that the specified PROFILE PAPER value is correct.

started exceeds 99 subsystems.

simuletaneouslyoperational.

paper size will be used instead.

Appendix A. i daXFC Messages and Codes A- 11

•

XES100I command UNKNOWN AFPDS COMMAND IN MAIN

Description An unrecognized AFPDS (CPDS) command was found during proc-

Severity Processing will continue after this message. Action Ensure that the input ddname is correct, and that the input has not

•

XES101W INVALID ORDER RECEIVED IN FSA

Description An error in the JES to IDAXFC FSA int erface ha s occurred. Severity Processing for the named printer is terminated. Action Restart the idaXFC specifying an FSI trace option on the failing

•

XES102I SYNC ORDER RECEIVED

•

XES103I ORDSYR1 = n ORDSYR2 = n ORDSYR3 =n

•

XES103I ORDSYR4 = n ORDSYR5 = n ORDSYR6 =n

•

XES103I ORDSYNP = n ORDSYKI = n ORDSYCP =n

•

XES104I ORDSYMSG = nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn

Description Trace information mes sage. Notes Information-only message.

essing in t he MA IN module.

been corrupted.

printer and contact the pr oduct distributor.

•

XES106I RESPONSE SEND. TYPE= xx

•

XES110I RESPONSE SEND. TYPE= xx

•

XES107I RECNO = xxxx DSNA ME = xxxxx

•

XES111I RECNO = xxxx DSNAME = xxxxx

•

XES108I PAGE = xxxx COPIES = xx FLAG= xx

•

XES112I PAGE = xxxx COPIES = xx FLAG= xx

Description Trace information mes sage. Severity Information only message. Action None.

•

XES120I SMF RECORD WRITE ENTERED

Description Trace message. Severity TRACE message. Action none.

•

XES121W SMF WRITE FAILED RC = xx

Description Generation of an SMF record was not possible, Severity SMF recording will not be per formed. Action Determin e the cause of the error and ev aluate if printer operation can

continue withou t SMF record generation.

A-12 ida XFC Installation Guide

•

XES122I SMF RECORD WRITE TERMINATED

Description Trace message. Severity TRACE message. Action none.

•

XES131I CHECK POINT WRITTEN FOR PAGE nnnn

Description Trace information mes sage indic ating checkpoint activi ty. Notes Information-only message.

•

XES200W SHORT RECORD FOUND. LENGTH = llllll

Description An error was encountered processing AFPDS data. An AFPDS com-

mand was proc essed that was less than 9 bytes. Severity The outpu t job pr oducing the e rror i s held and proc essing continues. Action Validate that the print output containing AFPDS (X'5A') records has

not been corrupted, and that records are minimum 9 bytes in length

(X'5A' plus 8 bytes) .

•

XES201I CC =

Description Structured field command i ndicator. Notes Information-only message identifying the structured field being proc-

essed.

•

XES202I CMD=command LENGTH= lllll

Description Structured field command i ndicator. Notes Information-only message identifying the structured field being proc-

essed.

•

XES210W Dataset member MEMBER NOT FOUND

Description An expected data member could not be located. Severity The outpu t job pr oducing the e rror i s held and proc essing continues. Action Validate that all i nput data and resources have been supplied.

•

XES213W dataset member INVALID RECORD FORMAT

Description The named dataset member contained an invalid rec ord format. Severity The outpu t job pr oducing the e rror i s held and proc essing continues. Action Correct the invalid input member. Ensure that the member attributes

(RECFM) are set correctly. Allowable record formats are: V or VB

with optional Machine or ANSI contr ol charact ers.

Appendix A. i daXFC Messages and Codes A- 13

•

XES214W Dataset member INPUT FILE NOT FOUND

•

XES215I member ddname CLOSED

•

XES216I member ddname CLOSED

Description Informatio n-only message. Notes Informatio n-only message identifying that member ddname has been

closed after proc essing.

•

XES217I NOTE CALLED

Description The note macro has been encountered. Recording for a dataset has

been started. Notes Information-only message.

•

XES218I POSITION IS xxxx,xxxx

Description Trace information mes sage. Severity Processing continues. Action None.

•

XES219I POINT CALLED

Description The point macro has been encountered. Repositioning for an input

Notes Information-only message.

•

XES230I POSITION TO xxxx,xxxx

Description Trace information mes sage. Severity Processing continues. Action None.

•

XES230W CHKPT REJECTED RC = xx

Description Generation of a checkpoint record was not possible, Severity Checkpointing w ill not be performed. Action Determin e the cause of the error and ev aluate if printer operation can

dataset h as occurred.

continue withou t checkpointing.

A-14 ida XFC Installation Guide

•

XES231W GETREC FAILED, RC=

Description An internal idaXFC err or occurred. Severity Processing for the named printer is terminated. Action Restart the idaXFC specifying an FSI trace option on the failing

•

XES232I GETREC, FLAGS1=

Description Informatio n message. Severity Processing continues. Action None.

•

XES233W GETREC FAILED, FLAGS1=

Description The idaXFC was unable to read the spool volume. A spool IO error

Severity Processing for the named printer is terminated. Action Verify the integrity of the spool volume, and take any necessary in-

•

XES234I RECORD READ xxxx,xxxx

Description Trace information mes sage. Severity Processing continues. Action None.

printer and contact the product distributor. Return code information

can be found in the appropriate documentation for the FS I macro.

has occurred.

stallatio n defined recovery actions.

•

XES235I IDXFLAG1 =

Description Trace information mes sage. Severity Information only message. Action None.

•

XES236W FREEREC FAILED, RC=

Description An internal idaXFC err or occurred. Severity Processing for the named printer is terminated. Action Restart the idaXFC specifying an FSI trace option on the failing

•

XES237W dataset member READ FAILED

Description The named dataset member contained an invalid rec ord format. Severity The outpu t job pr oducing the e rror i s held and proc essing continues. Action Validate that the input data record format is acceptable and that the

printer and contact the product distributor. Return code information

can be found in the appropriate documentation for the FS I macro.

input dat a has not been co r r upted.

Appendix A. i daXFC Messages and Codes A- 15

•

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 p rinter. Action Ensure that the dataset attributes and size of the log dataset are ac-

ceptable, and rest art the printer in orde r to reacc es s the log d ataset.

•

XES260W DYNALLOC RETURN rrrr ON PRI NT E R printer

•

XES260W INFO CODE rrrr ON PRINTER printer

Description An error occurred for the named printer during a dynamic allocation

operation. The named printer uses dat aset file output. Severity Generation of the file output is terminated. Action Examine the return code supplied in the INFO CODE using the ap-

propriate IBM Authorized Assembler Programming Guide for an ex-

planation regarding this error. Perform the described corrective

action s to resolve this problem.

•

XES500W FSA CONNECT REJECTED ON printer, RC =rc

Description Connection of the named pr inter was not possible. 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 FS A macro.

•

XES501W INTERNAL ERROR DEQ PENDING FOR printer

Description A internal error has been encountere d for the named printer. Severity Processing for the printer FSA is terminated. Action Restart the printer if required. If this problem persists, contact the

product distributor.

A-16 ida XFC Installation Guide

•

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 oper-

ating system version, level. Interface specific message indicates

microcode level and print er support and other f eatures. Notes Information-only message. Interface version information should be

recorded if required.

•

XES506I RC FROM CPDSMAIN = rc VTAM SENSE = ssss ON PRIN T ER pr ti d

Description An non zero return code was received during processing from the

CPDSMAIN module, with an optional VTAM sense code. Severity Processing of the current file is terminated and the file is held. Print-

ing can subsequently continue. Action Review related idaXFC messages, and examine the output gener-

ated for the failing printer (in the CONSOLE, SYSOUT or other

LOGDDoutput).

•

XES507W INVALID ORDER RECEIVED IN FSA

printer and contact the pr oduct distributor.

•

XES508I SET ORDER RECEIVED

Description Trace information message indicating operator SET command is be-

ing processed. Notes Information-only message.

•

XES509I SYNC ORDER RECEIVED

•

XES509I ORDSYR1 = n ORDSYR2 = n ORDSYR3 =n

•

XES509I ORDSYR4 = n ORDSYR5 = n ORDSYR6 =n

•

XES509I ORDSYNP = n ORDSYKI = n ORDSYCP =n

•

XES509I ORDSYMSG = nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn

Description Trace information mes sage. Notes Information-only message.

•

XES511I INTERVENTION ORDER RECEIVED

Description Trace information mes sage. Notes Information-only message.

Appendix A. i daXFC Messages and Codes A- 17

•

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

•

XES512I ADDRESS = address3

•

XES512I ADDRESS = address4

•

XES512I USERLIB = user library 1

•

XES512I USERLIB = user library 2

•

XES512I USERLIB = user library 3

•

XES512I USERLIB = user library 4

•

XES512I USERLIB = user library 5

•

XES512I USERLIB = user library 6

•

XES512I USERLIB = user library 7

•

XES512I USERLIB = user library 8

•

XES512I NOTIFY = notify1

•

XES512I NOTIFY = notify2

•

XES512I NOTIFY = notify3

•

XES512I NOTIFY = notify4

•

XES512I DEPT = department

•

XES512I BUILD = building

•

XES512I TITLE = title

•

XES512I FCB = fcb

•

XES512I FLASH = flash

•

XES512I PIMSG = pimsg

•

XES512I PRIO = priority

•

XES512I DATACK = data check

•

XES512I PRMODE = print mode

•

XES512I KEY = nn, NUMBER OF KEYS = nn

Description Trace info rmation record indicat ing all print job details. Severity. Infor mation only message. Action None.

•

XES513I START DEVICE CALLED

Description Trace information message indicating start printer command is being

Notes Information-only message.

•

XES514I STOP DEVICE CALLED

•

XES515I STOP FSA CALLED

Description Trace information mes sage indic ating stop printer command is being

Notes Information-only message.

A-18 ida XFC Installation Guide

processed.

•

XES516W FSA DISCONNECT REJECTED ON PRINTER printer, RC = rc

•

XES517W GETDS REJECTED,RC =

•

XES518I GETDS : , GDSFLGS1 =

Description Trace information mes sage. Severity Information only message. Action None.

•

XES519W WRONG FLAG : GDSFLGS1 = xx

printer and contact the product distributor. Return code information

can be found in the appropriate documentation for the FS A macro.

printer and contact the product distributor. Return code information

can be found in the appropriate documentation for the FS I macro.

printer and contact the pr oduct distributor.

•

XES520I VALID CHECKPOINT RETURNED

Description Trace information mes sage. Notes Information-only message.

•

XES521W SJFREQ REJECTED,RC = xx

•

XES521W SJFREQ REASON CODE = xx

Description An error in the JES to IDAXFC SJF interface has oc curred. Severity Processing for the named printer is terminated. Action Restart the idaXFC specifying an FSI trace option on the failing

•

XES522I JESNEWS DATASET ACTIVE

Description Trace info rmation record indicat ing all print job details. Severity. Infor mation only message. Action None.

printer and contact the pr oduct distributor.

Appendix A. i daXFC Messages and Codes A- 19

•

XES523I GDSFLAG = xx

Description Trace information mes sage. Severity Information only message. Action None.

•

XES524I ffff ACTIVE ON PRINTER prtid FOR userid

Desc rip tio n File n um be r o r M VS jobname is active on the printer prtid. Indicates

print processing is active on the named printer. Severity Information only message. Action None.

•

XES525I jobname REQUEUED NO CHK ON printer

Description Due to a previous error, the named job has been requeued for print-

ing from the start of the print job. Severity When a connection to the printer is reestablished, printing of the job

will be performed fr om the start of the job. Action Trace JOB information. See the previous message for additional in-

formation.

•

XES526I jobname REQUEUED ON printer

Description Due to a previous error, the named job has been requeued for print-

ing from the last checkpoint in the print job. Severity When a connection to the printer is reestablished, printing of the job

will be performed fr om the las t checkpoint prior to j ob failure. Action Trace JOB information. See the previous message for additional in-

formation.

•

XES527I jobname MADE UNPRINTABLE ON printer

Description Due to a previous error, the named job cannot be printed. Severity The named job will be placed in unprintable status. Action Trace JOB information. See the previous message for additional in-

formation.

•

XES528I jobname PRINTED ON printer

Description The job name jobid has completed pri nting on printer prtid. Message

is produced as a result of t he JCL NOTIFY optio n. Severity Information only message. Action Trace JOB inform ation mes sage.

A-20 ida XFC Installation Guide

•

XES530W RELDS REJECTED,RC = xx

•

XES531I DATASET FREE CALLED WITH FLAG xx

Description Trace info rmation record indicat ing dataset being released. Severity Information only message. Action None.

•

XES532I KEY = nn, NUMBER OF KEYS = nn

•

XES532I nnnnnnnnnnnnnnnnnnnnnnnnnnnnn

Description Trace info rmation record indicat ing all print job details. Severity. Infor mation only message. Action None.

•

XES533I NOTIFY USER ENTERED

Description Trace message. Severity TRACE message. Action none.

printer and contact the product distributor. Return code information

can be found in the appropriate documentation for the FS I macro.

•

XES534I jobid COMPLETED ON prtid

Description The job name jobid has completed pri nting on printer prtid. Message

Severity Information only message. Action None.

•

XES535I jobid PLACED ON HOLD BY prtid REASON CODE = rc

Description The job name jobid has not printed and is placed on hold for printer

Severity Pri nting of job did not complete. Action Examine accompanying messages and error logs to determine the

•

XES536W RC FROM SSIREQ = rr

Description An internal processing error has occurred during a sub system inter-

Severity A severe program error has occurred. Action Contact the product distributor with a desc ription of th e problem.

is produced as a result of t he JCL NOTIFY optio n.

prtid. Message is produced as a result of the JCL NOTIFY option.

cause of failure. Release the job from hold if required, when the

problem is corrected (or resubmit the job c orrectly).

face request .

Appendix A. i daXFC Messages and Codes A- 21

•

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 regi on is avai lable for process ing. Severity Processing on the named printer is termina ted. Action Increase the region size for the idaXF C PROC, and res tart the failing

•

XES542I STORAGE ALLOCATED AT address LENGTH si z e CA LLED BY xxxx

Description Informatio n-only message that defines th e location of the virtual stor -

Notes Information-only message.

•

XES543I HIGH MEMORY REQUESTED BY xxxxxx

Description A request for memory was received from location xxxxxx. Notes Information-only message.

•

XES544I LONG STORAGE ALLOCATED AT address LENGTH size CALLE D BY xxxx

Description Informatio n-only message that defines th e location of the virtual stor -

Notes Information-only message.

printer.

age allocated during processing. The 8-byte hexadecimal field ad-

dress indicates the allocated storage location, and the range of

storage allocated is indicated in the length field, and the caller ad-

dress location.

age allocated during processing. The 8-byte hexadecimal field ad-

dress indicates the allocated storage location, and the range of

storage allocated is indicated in the length field, and the caller ad-

dress location.

•

XES545W WRONG FREEMAIN AT ADDR XXXXXXX CALLED BY module

Description An internal idaXFC err or occurred. Severity Processing of jobs continues. Action Retry the print job. If th is er ror persists, perform a idaXFC trace (ALL),

A-22 ida XFC Installation Guide

and report this error t o the product distributor.

•

XES546I STORAGE RELEASED AT address LENGTH size CALLED FROM xxxxxx

Description Informatio n-only message that defines th e location of the virtual stor -

Notes Information-only message.

•

XES547I LONG STORAGE RELEASED AT address LENGTH size BY FREEMAIN

Description Information-only message that defines the location of the virtual stor-

Notes Information-only message.

•

XES700I ONLY nn MARGINS RECEIVED

Description A non-match set of margi n values has bee n received. Severity The margin values received will be ignored, and default values will be

Action Correct the XES margins command, and ensure that all margin val-

•

XES701I FONT fontname NOT FOUND

age released during processing. The 8-byte hexadecimal field ad-

dress indicates the released storage location, and the length field

shows the storage range released, and the caller address location.

age released during processing. The 8-byte hexadecimal field ad-

dress indicates the released storage location, and the length field

shows the storage range released, and the caller address location.

used.

ues are specified (i.e. height, top, bottom, left and right margins) .

Description An expected XES font could not be mapped to an AFP font, as no

Severity The default font value will be used for the named XES font. Action Ensure that the named XES font has been mapped to an AFP font,

•

XES702I MAP CODED FONT FAILED WITH RETURN CODE rc

Description The named font described i n ac companying mes sages has been not

Severity Processing continues with the def ault font. Notes Verify that the named AFP font is available, and is accessible to the

•

XES703I BEGIN MERGE PAGE ENTERED

Description Trace information mes sage. Notes Informatio n-only message, produced when trace option is reques ted.

•

XES704I FORM READ = formname

Description Trace information mes sage. Notes Informatio n-only message, produced when trace option is reques ted.

definition was supplied.

and resubmi t the pr int job.

been found, or is corrupted.

idaXFC program.

Appendix A. i daXFC Messages and Codes A- 23

•

XES705I START GRAPHIC ENTERED

Description Trace information mes sage. Notes Informatio n-only message, produced when trace option is reques ted.

•

XES706I GRAFX SIZE = value

Description Trace information mes sage. Notes Informatio n-only message, produced when trace option is reques ted.

•

XES707I GRAFY SIZE = value

Description Trace information mes sage. Notes Informatio n-only message, produced when trace option is reques ted.

•

XES708I GSIZEX SIZE = value

Description Trace information mes sage. Notes Informatio n-only message, produced when trace option is reques ted.

•

XES709I GSIZEY SIZE = value

Description Trace information mes sage. Notes Informatio n-only message, produced when trace option is reques ted.

•

XES710I START LINE ENTERED

Description Trace information mes sage. Notes Informatio n-only message, produced when trace option is reques ted.

•

XES711I START LINE TERMINATED

Description Trace information mes sage. Notes Informatio n-only message, produced when trace option is reques ted.

•

XES712I PRINT LINE ENTERED

Description Trace information mes sage. Notes Informatio n-only message, produced when trace option is reques ted.

•

XES713I PRINT LINE TERMINATED

Description Trace information mes sage. Notes Informatio n-only message, produced when trace option is reques ted.

•

XES714I MERGE PAGE TERMINATED

Description Trace information mes sage. Notes Informatio n-only message, produced when trace option is reques ted.

A-24 ida XFC Installation Guide

•

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

Acti on Corr ec t t he i nv al i d AFP font referenc e, and re su bmi t the print j ob.

•

XES716I END PAGE ENTERED

Description Trace information mes sage. Notes Informatio n-only message, produced when trace option is reques ted.

•

XES717I END PAGE TERMINATED

Description Trace information mes sage. Notes Informatio n-only message, produced when trace option is reques ted.

•

XES718I BEGIN PAGE ENTERED

Description Trace information mes sage. Notes Informatio n-only message, produced when trace option is reques ted.

•

XES719I BEGIN PAGE TERMINATED

Description Trace information mes sage.

generated.

Notes Informatio n-only message, produced when trace option is reques ted.

•

XES720I XES INPUT RECORD

Description Trace information mes sage. Notes Informatio n-only message, produced when trace option is reques ted.

•

XES721I hexadecimal data

Description Trace information mes sage. Notes Informatio n-only message, produced when trace option is reques ted.

•

XES722I FILE formname, xes library INCLUDED

Description Trace information mes sage. Notes Informatio n-only message, produced when trace option is reques ted.

•

XES723I HIGH MEMORY REQUESTED BY value

Description Trace information mes sage. Notes Informatio n-only message, produced when trace option is reques ted.

Appendix A. i daXFC Messages and Codes A- 25

•

XES724I INSUFFICIENT REGION FOR JOB

Description Insufficient regi on is avai lable for process ing. Severity Processing is terminated. Action Increase the region size for the idaXFC PROC, and restart the print

•

XES725I STORAGE ALLOCATED AT storage LENGTH length CALLED BY name

Description Information-only message that defines the location of the virtual stor-

Notes Information-only message.

•

XES726I WRONG FREEMAIN AT ADDR location CALLED BY name

Description A severe internal program error has occured. Severity Processing is terminated. Action Contact the the product distributor and report this message.

•

XES727I STORAGE RELEASED AT location LENGTH length CALLED BY name

Description Information-only message that defines the location of the virtual stor-

job.

age allocated during processing. The 8-byte hexadecimal field ad-

dress indicates the allocated storage location, and the range of

storage allocated is indicated in the length field, and the caller ad-

dress location.

age released during processing. The 8-byte hexadecimal field ad-

dress indicates the released storage location, and the length field

shows the storage range released, and the caller address location. Notes Information-only message.

•

XES728I STORAGE RELEASED AT location LENGTH length BY FREEMAIN

Description Informatio n-only message that defines th e location of the virtual stor -

age released during processing. The 8-byte hexadecimal field ad-

dress indicates the released storage location, and the length field

shows the storage range released, and the caller address location. Notes Information-only message.

•

XES729I UNPACKED XES INPUT RECORD

Description Trace information mes sage. Notes Informatio n-only message, produced when trace option is reques ted.

•

XES730I hexadecimal data

Description Trace information mes sage. Notes Informatio n-only message, produced when trace option is reques ted.

A-26 ida XFC Installation Guide

•

XES750I MCF ENTERED FONT = font codepage AS nnn

Description The Map Coded Font processing routine has been invoked for the

Notes Information-only message.

•

XES751I INVALID FONT CONTROL FOUND IN FONT font

Description An AFPDS font control command in the input data stream contains

Severity Processing for the present print job is terminated. Action Correct the invalid font reference. Verify that the font named ex ists.

•

XES752I RELATIVE FONT CONTROL TO SMALL IN FONT font

Description Expected data is missing in the rel ative font FNC record. Severity Processing for the present print job is terminated. Action Correct the error in the font, and resubmit the print job.

•

XES753I command UNKNOWN AFPDS COMMAND IN FONT fffff

FONT font, using the code page. The number nnn indicates the se-

quence number ass igned to this f ont.

an invalid command or length field.

Description An unknown AFPDS command was detected within the font named.

Severity Processing continues. Action Verify that the font resource is not corrupted and that it is the correct

•

XES754I command UNKNOWN AFPDS COMMAND IN CODE PAGE

Description An unknown AFPDS command was detected within the code page

Severity Processing continues. Action Verify that the code page resource is not corrupted and that code

•

XES756I CHARACTER character NOT FOUND IN FONT font WITH codepage

Descri ption The character id named w as not present i n the s pecified font. Severity Printing of the character using the supplied code point will not be

Action Verify that the font and code page combination is valid and all re-

•

XES757I FONT codepage charset AS nn ACTIVE

This c ommand cannot be recognized.

type for use with idaXFC.

named. This comm and cannot be recognized.

page generation was performed c orrectly.

possibl e, pr oc essing contin ues .

quired characters are present in the font.

Description The named font codepage and character set has been generated as

Notes Information-only message.

internal font number nn.

Appendix A. i daXFC Messages and Codes A- 27

•

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 orienta tion xx failed , bec aus e the

Severity Pri nting of the job indicated is terminated. Action Verify the specified font resource is available in the requested orien-

•

XES780I CMD=command LENGTH= lllll

Description Structured field command i ndicator. Notes Information-only message identifying the structured field being proc-

•

XES782I Dataset member MEMBER NOT FOUND

•

XES786I Dataset member MEMBER NOT FOUND

•

XES783I member ddname OPENED FOR READ

Description Informatio n-only message.

font does not contain this orient ation.

tation.

essed.

Notes Information-only message identifying the member ddname being

•

XES784I dataset member INVALID RECORD FORMAT

•

XES790W dataset member INVALID RECORD FORMAT

•

XES785I Dataset member INPUT FILE NOT FOUND

•

XES791W Dataset member INPUT FILE NOT FOUND

A-28 ida XFC Installation Guide

opened for a read process ing.

(RECFM) are set correctly. Allowable record formats are: V or VB

with optional Machine or ANSI contr ol charact ers.

•

XES787I member ddname CLOSED

Description Informatio n-only message. Notes Informatio n-only message identifying that member ddname has been

closed after proc essing.

•

XES788I dataset member READ FAILED

•

XES792W dataset member READ FAILED

input dat a has not been co r r upted.

•

XES791W dataset member INVALID RECORD FORMAT

(RECFM) are set correctly. Allowable record formats are: V or VB

with optional Machine or ANSI contr ol charact ers.

•

XES791W Dataset member INPUT FILE NOT FOUND

•

XES900I hexadecimal data

•

XES900I FSI CONNECT

•

XES900I FSI DISCONNECT

•

XES900I FSI GET DATASET

•

XES900I FSI GET DATASET JSPA

•

XES900I FSI GET DATASET CHECK POINT

•

XES900I FSI GET RECORD

•

XES900I FSI GET RECORD INDEX

•

XES900I FSI RELEASE DATASET

•

XES900I FSI GET RECORD INDEX RETURNED

•

XES900I FSI FREE RECORD

•

XES900I FSI WRITE CHECK POINT

•

XES900I CHECK POINT AREA

•

XES900I FSI SEND

•

XES900I FSI POST

Description FSI trace inform ation messages. Severity Information only message. Action None.

Appendix A. i daXFC Messages and Codes A- 29

•

XES990I USER EXIT 8 ENTERED

•

XES990I USER EXIT 8 TERMINATED

Description Trace information mes sage. Severity Processing continues. Action None.

•

XES991I USER EXIT 1 ENTERED

•

XES991I USER EXIT 1 TERMINATED

Description Trace information mes sage. Severity Processing continues. Action None.

•

XES992I USER EXIT 2 ENTERED

•

XES992I USER EXIT 2 TERMINATED

Description Trace information mes sage. Severity Processing continues. Action None.

•

PSS998W MODULE = xxxxxx ABEND COD E = xxxx ON xxxxxxxxx

•

XES998W IDA XFC PROGRAM VERSION = vvvvv FSAS TAT= nnnn

•

XES998W PSW= xxxxxxxx xxxxxxxx START = xxxxxxxx OFFSET= xxxx xxx

•

XES998W GENERAL REGISTERS R0..R15

•

XES998W REG 0 - 3 xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx

•

XES998W REG 4 - 7 xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx

•

XES998W REG 8 - 11 xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx

•

XES998W REG 12 - 15 xxxxxxxx xxxxxxxx xxxxxxxx xxxxxxxx

•

XES998W ABEND OCCURRED BEFORE PSS CODE

•

XES998W ABEND OCCURRED AFTER PSS CODE

•

XES998W ABEND OCCURRED IN module OFFSET nnnnnn

Description A program abend has occurred for Severity The FSA has been termin ated. Action Analyze the SYSLOG and relevant printer logs / error information to

determine the cause of the failure. Contact the product distributor in

the event that a program error is i dentified.

idaXFC

A-30 ida XFC Installation Guide

Appendix B. Data Stream Descript ion

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 EBC DIC encoding.

• Escape or Escape Escape Coding XES dat a tha t has been generated in ASCII for mat, and contains i-data s ingle or dou-

ble escape notation to enable data transfer. A variety of escape notations can be utilized.

i-data Function Selection via the Line (FSL) commands are not supported by the product, except for the Escape and Escape Escape notation. FSL commands will however be removed from the datastream, and will not be printed.

The Carriage control channel command Skip to Channel One is supported. All other carriage c ontrol commands will be ignored.

XES Datastream

In general, the mands suppor ted as cont ained in this sect ion.

Further infor mation r egarding t he XES datastre am can be obtained from

CP User Manual, January 1986, number 600P88455

cates a line-ending character, e.g. Carr iage Ret urn or Li ne Feed.

idaXFC

Font ID Assignment +n<Fontname><LE> Font Change *n (n=0-9 ) Print *+P<LE> Reset *+X<LE> Margins ( w ho l e page) * m <S , T,B, L,R><LE> Top Margi n *zn<N><LE> Bottom Margin *zq<N><LE> Left Margin *zk<N><LE> Right Margin *zm<N><LE> Start Justification *j Stop Justification *k Start Underline *u

provides Xerox 4045 XES emulation. Details regarding the com-

In the followin g tab le, the <LE> ind i-

Appendix B. Data Stre am Descriptio n B-1

Xerox 4045 Laser

Stop Underline *w Line Spacing *l<n> StartBolding *b Stop Bolding *p Centering *q Horizontal Tab Clear *d Horizontal Tab *t<n1...n160><LE> Units -1/60" inch *zg Units -1/300" inch *zf Landscape Dr aw Lines H orizontal *y<X ,Y,L,T><LE> Landscape Dr aw Lines Verti cal *x<X,Y,L,T><LE> Portrait D raw Lines Horizontal *x<X,Y ,L,T><LE> Portrait Draw Lines Vertical *y<X,Y,L,T><LE> Absolute Text Placement *a<X.Y><LE> Relative Text Placement *r<D ><n><c > Start Superscript *h Stop Superscript *s Start Subscript *l Stop Subscript *s Start Overstrike *zo<x> Stop Overstrike *zp Merge Pa ge Load +M<LE> Merge Start *ze Merge Stop *zd Merge Page Unload +V<LE> Language *zl<c> Graphic Window *gw<E>; < X,Y,A,B><LE> Vertical Tab Clear *e Vertical Tab Set *v<n1...n125><LE>

B-2 ida XFC Installation Guide

XES Datastream Limitatio n s

This s ection de scribes limitations regarding the XES support.

• Prin table P age 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 dat astream.

• Downlo aded Translate Table This functionality cannot be directly supported (Character Table, (+T<LE>), however

translate table modifications can be supported by customizing the supplied XES TRANS XE S to AFP conversion program.

• Downlo aded X E S fonts Fonts downloaded in the XES datastream are ignored. (Font Load (+F<LE>), Font

Unload (+U<LE>), Font Add Selected (+A<LE>), Font Delete Selected (+B<LE>)). XES downloaded fonts can however be supported by supplying the font references qas customization options, which requires prior font conversion to A FP f ormat.

• Portr ait/Lands cape Fonts Changes i n the font orient ation are supported by rotating the output font .

• XES Data Monitor Command The Data monitor command (+D) is not supported.

• XES VFU commands The XES VFU comma nd s ( VFU, VFU Stops Clea r, VFU Stops set) are not supported,

and wil l be printed.

• Printer Status Sheet Inf ormation The printer status sheet generated by the printer i s not supported.

Appendix B. Data Stre am Descriptio n B-3

Glossary

ABEND:

mination of a (problem) program.

AFP:

fers to the collection of printing functions for APA printers for printing text and graphi cs .

AFPDS:

is a data stream format used for creating output to an AFP printer.

APA:

capability to write text, overlay and image information at any point (pel) of a page.

APL:

programming language.

Bounded box c haract ers:

design that excludes character positioning information from the raster character image.

CDPDS:

stream is a data stream consisting of merged text and graphic s that ca n be print ed on a APA printer.

CMS:

that provides time sharing capabilities under the VM operati ng sy st em .

cm: code pa ge:

graphic character identifiers that can be used to group a variety of characters and symbols.

control word:

that informs SCRIPT/VS how to process the document.

CP:

and supervises the execution of programs.

Abnormal End refers to the abnormal ter-

Advanc ed Fu n ctio n Pr inting is a te rm tha t r e-

Advanced Function Printing Data stream

All Points Addressable refers to the printer

A Pr ogramming Language is an

A system of character

Composed Document Presentation Data

Conversational Monitor System is a system

Centimetre

A file that associates code points, and

An instruction within a document

Control Program is a program that schedules

IBM

-licensed

data set:

refers to a collection of related records.

dot:

pel.

dpi:

printer (see pel).

duplex pr inting:

of a sheet of paper.

file:

a collection of rel ated recor ds.

font:

typeface and size.

FSL:

that refers to a set of commands used for directing setup commands to an

GDDM:

IBM

ments consisting of graphics, im age and text.

host system:

used to prepare and run programs and to which a network is connected (for communication with other systems).

ICU:

GDDM

data.

ICDS:

the printable output datastream generated by the

idaXFC

IEWL:

for performing linkage editing and loading of assembler object code.

In the MVS operating environment, this

Dot used in this manual is synonymous with

Dots Per Inch defines the resolution of a page

The ab ility to print o n bo th sid es

In the VM operating environment, this refers to

A collection of characters in a specific

Function Selection via the Line is an acronym

interface.

ida

Graphical Data Display Manager is an

-licensed program used to create page seg-

A data processing system that is

Interactive Chart Utility is an

program used for the processing of graphic

i-data Compressed Data Stream refers to for use with attached

The IEWL is a n

IBM

products.

i-dat a

-licensed program used

IBM

-licensed

CPDS: DASD:

age device that permits access of data independent of location.

data stream:

in a continuous stream that can be used to transmit infor m a t ion.

DD:

with JCL to provide information regarding a data set to a progr am.

Composed Print Data stream. See AFPDS. A Direct Access Storage Device is a stor-

A data stream is a collection of data

Data Definition is a term used in conjunction

image:

and untoned pels that form a picture.

interface:

interface is a hardware component used to link two devices.

IRQ:

ting on a vention to be reported to t he 3x74 controller.

IVU:

program used for processing of image dat a.

A term used to describe a pattern of toned

Within the context of this publication an

Intervention Required timeout value is a set-

Image View Utility is a n

interface that permits printer inter-

ida

-licensed

IBM

Glossary C-1

GDDM

Job Control Language is an

JCL:

language used for defining data and program resources for job submission to JES under the MVS Operating System.

Job Execution and Submission system is an

JES:

-licensed program used to schedule and spool

IBM

input an d output under the MVS Operat ing system.

laser (light amplification by stimulated emission of radiation):

of light, used in electrophotographic printing.

line data:

on a line print er.

Logical Unit type 0 is a reference to an SNA

LU0:

protocol used to communicate with a specific class of device.

Logical Unit type 1 is a reference to an SNA

LU1:

protocol used to communicate with a specific class of device that ac cepts SC S commands.

Logical Unit type 3 is a reference to an SNA

LU3:

protocol used to communicate with a specific class of device that does not accept SCS commands.

The Mi ssing Interrupt Handler is a component

MIH:

used in the host operating and subsystems for specify ing actions to be taken on missing interrupts

Multiple Virtual System and MVS/XA (ex-

MVS:

tended architecture) are licensed systems.

Overlay Generation Language is an

OGL:

censed produced used for generation of electronic overlays for printing in AFP printers.

page pr inter:

entation text and images on a page basis.

Page s egment:

lection of resources, typically graphics and text that can be included for printing.

Printer Command Language is a command

PCL:

language used for communicating with the printer.

A device that emits a coherent beam

Data that has been prepared for printing

A class of printer that accepts pres-

term that re fers to a col-

IBM

operating

IBM

-licensed

-li-

IBM

PCL 4/5

A pel refers to the smallest area that can be

pel:

toned on a printer .

raster:

raster image. A digitized pattern of toned/untoned pels is referred to as a r aster pat tern.

RSCS:

Subsystem is an the VM Operating System for spooling and communication of data.

SCRIPT/VS:

DCF text.

simplex printing:

(compare with duplex printing).

SMP:

censed program used for maintaining components in the MVS Operating System.

SNA:

IBM

host and communi c at ion and device res our c es.

structured field:

and data or parameters, used in the AFPDS, CPDS data streams.

TCP/IP:

Protocol refers to the collection of public protocols used to connec t host and communications systems.

TSO:

gram that runs under the MVS Operating System to provide time shar ing capability .

tumble printing:

printing in duplex mode for binding on the shorter edge of the page.

typographic font:

proportionally spaced characters that are similar in appearance to characters generated by typeset printing.

VTAM:

Method is an used with the MVS and VM Operating Systems to connect host and co mm unication dev ices.

A series of pels in a scan line is called a

Remote Spooling and Communications

System Modification Program is an

System Network Architecture refers to an

network architecture that is used to connect

Transmission Control Protocol / Internet

Time Sharing Option is an

Virtual Telecommunications Access

-licensed program used with

IBM

-licensed program that formats

IBM

Printing on one s ide of the paper

A self-identifying string of bytes

-licensed pro-

IBM

Tumble duplex printing refers to

A typographic font is a set of

-licensed program that can be

IBM

-li-

C-2 ida XFC Installation Guide

Index

APF authorized library 18 APF authorized load library 15

Batch Installation

Installation Software 32

CA-s pool customizati on 21 CA-Spool modificat ions 15 CLASS 27 Commands, Operat or 34

DEFAULT p rofile parameter 28 DEFAULT, Keyword 24 DEST 27

ida XFC

ProductHightlights 11 ida XFC prof ile default 28 IDAPSS control profile 23 idaPSS Exit Installation idaPSS XES Exit

Resource Re qui rements 13 idaXFC control prof ile statement 24 idaXFC keywords 23 idaXFC Pro file DEFAULT subparameters 25 idaXFC Pro file PRIN TER subparameters 25 IDAXFC Started Task, Profile ke ywords

Comment 25

DEFAULT 24

FSSNAME 24

PRINTER 24

Printer Subparameters 25 idaXF C , sa mple profi le 23 IEBGENER 17, 18 install idaXFC PROCLIB member 22 Installation

Libraries 17

Verification Procedures 33 installation checklist 15 installation overview 14 installation procedure 17, 18 IPL 22

FCB 27 font installation 18, 29, 32 FONTLIB, subparameter 25 form definition 19 FORMS 27 FSSNAME, Keyword 24 Functional Subsystem

Resource Requireme nts 13

JES PARM deck modification 15 JES3 FSS definition 21 JES3 installation 21

Librar ies, Created 17 LOADXES JCL 17 LOGDD , subparameter 25

Index C-3

messages, i d a XFC A-1 modifications to JES2 19 MVS PPT modifications. 15

profi le keyword syntax 23 Program Properties T able 19 PRTID, sub parameter 25

NODE 27

Operator commands, MVS cons ole 34 OUTPUT 28 overlay 19 OVLYLIB, subparameter 26

page defi nition 19 PAPER 26 prerequis ite operating system 13 prerequis ite spool system 13 Printer

Prequis ite Requi r emen t s 14 printer definition PRINTER parameter 28 Printer Subpar am eters

FONTLIB 25

LOGDD 25

OVLYLI B 26

PRTID 25

TRACE 26

XESLIB 26 PRINTER, Keyword 24 Printer, s ubparameter s 25 PRMODE 26 PROC library 15

reinitialize the system 22 Revisions iii

sample IDAXFC procedure 22 Software

Mainframe Requi rements 14 Prerequisite Requirements 14

system prepar at ion 14

TRACE, sub parameter 26

Verification

Procedur es 33

XES LIB, subparameter 26

Year 2000 suppor t 11

C-4 ida XFC Installation Guide

Xerox D63-069-00 User Manual

Specifications and Main Features

Frequently Asked Questions

User Manual

Preface

Table of Contents

Year 2000 Support

System Requirements

Functional Subsystem Spool Converter Requirements

idaPSS XES Conversion Exit Requiremen ts

XES to AFP Batch Invocation Prerequisites

Printer Prerequisites

Print Resource Requirements

idaPSS XES Exit Installation Checklist

Batch Installation Checklist

General Installation Procedure

Load the datasets supplied on the product tape

Install the supplied fonts and codepages

Generate the idaXFC program load module

Authorize the IDAXFC PROC

Authorize the IDAXFC program module

Create/Modify IDAXFC Program Security Rules

JES2 Installation

JES3 Installation

CA-Spool Customization

Install idaXFC PROCLIB Member

Sample IDAXFC Procedure

IDAXFC Control Profile Descri ption

Profile Keyword Syntax

General i d aXFC con t rol prof ile statements

idaPSS Profile Printer Subparameter Keywords

JES Output Configuration Parameters

ida XFC Profile Defaults

ida XFC Printer Defaults

idaPSS XES Exit Installation and Modification

Install the product tape files

Install the supplied Fonts and Codepages

Perform XES transform modifications

Relink idaPSS program module

Implement idaPSS Proclib updates

Implement idaPSS Profile updates

Implement JCL modifications for XES selection

idaXFC batch Software Installation and Modification

idaXFC batch Installation Procedure

Generation of the Load Library

Install the supplied Fonts and Codepages

Customize the XES Translation

Generate the idaXFC program load module

idaXFC batch Installation Verification Procedure

idaXFC Sp ool File Converter Operato r Commands

XES Transform modifications

Modification of XES to AFP Font selection

Modifications to the Lead-in and Lead-out strings

Modification of Page Length and Margins

Modifying the XES FORMS Data Definition Reference

Modifying the Default User Defined Key

Modifying the Sixel Decoding Table

Changing the Character Mapping and Language

Appendix A. idaXFC Messages and Codes

Appendix B. Data Stream Descript ion

Input Datastream Description

XES Datastream

XES Datastream Limitatio n s

Glossary

Index