Xerox D63-069-00 User Manual
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.
Copyright
©
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
Table of Contents
ida XFC Product Highlights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Year 2000 Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Functional Subsystem Spool Converter Requirements . . . . . . . . . . . . . . . . . 13
idaPSS XES Conversion Exit Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . 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
.
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.
1
.
1
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, FB, LRECL 80,
BLKSIZE 3120
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
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
Loading...