Oce PRISMAproduction, Reference Manual

Page 1: ...Océ PRISMAproduction ROUTER V1 0 Reference Guide ...

Page 2: ...A Inc 5600 Broken Sound Blvd Boca Raton FL 33487 January 2002 Edition Copyright Océ Printing Systems GmbH 2000 2002 All rights reserved including rights of translation reprinting reproduction by coying or any other method Offenders will be liable for damages All rights including rights created by patent grant or registration of a utility model or design are reserved Delivery subject to availabilit...

Page 3: ... can be performed without any detailed knowledge of SPS or its parameters The intended audience for this document is anyone responsible for these functions in an installation Version 1 0 of PP ROUTER includes support for the SPS base product spool interface and the PP ROUTER print distribution driver Use this manual to install PP ROUTER version 1 0 and all subsequent releases until the manual is s...

Page 4: ...Summary of Amendments U20944 J Z247 6 7600 Summary of Amendments Summary of Amendments PP ROUTER Version 1 0 ...

Page 5: ...nvironment 17 RECEIVE the Product 18 Allocate the SPS MVS Install Data Sets 18 Adjust JCLIN for LPALIB Installation OPTIONAL 20 Adjust JCLIN for LINKLST Installation OPTIONAL 21 APPLY the Product 22 Authorize SPS Libraries in the System 23 Establish SPS Program Properties 24 Specify LSQA dumping for SPS 25 Define the SPS Printers to JES 26 Install the SPS Start up Procedure 27 Allocate the SPS Exe...

Page 6: ...4 SPS LI Installation and Customization VSE 51 Installation Overview 51 Basic Machine Readable Material 51 Restore Sublibrary from Tape 52 Define JECL Parms in AUTOSTART 54 SPS Reentrant Phases 55 5 PP ROUTER Installation and Customization VSE 55 Installation Overview 55 Basic Machine Readable Material 57 Install product from Tape 57 PP ROUTER printer definitions in VSE and VM 58 POWER JECL define...

Page 7: ...Commands 84 8 JCL parameters 87 OS 390 MVS 87 VSE Extended Output Features 89 Extended JECL Keywords 89 9 Print Parameter Exit 97 OS 390 MVS 97 VSE 98 10 Maintenance 99 Temporary Fixes 99 11 Performance Considerations 101 Memory 101 PP ROUTER Storage Estimates 101 Libraries 102 Trace Files 102 12 Diagnosis 103 Error Reporting 103 Associated Documentation 103 When to Dump 104 When to Trace 104 Trac...

Page 8: ...odes 107 Conventions 107 PP ROUTER Messages 109 SPS Messages 121 OS 390 MVS 121 VSE 121 SPS Abend Codes 121 Appendix A OS 390 REXX Alternate Library Installation 122 Appendix B Problem Documentation 129 List of Tables 131 Bibliography 133 Index 135 ...

Page 9: ...andard interfaces within the operating system OS 390 MVS FSI Interface The FSI is an IBM supported customer interface permitting an address space to communicate with the spooling and operator facilities of the installed JES The FSI supports such functions as connecting and disconnecting Functional Subsystems FSS s and Functional Subsystem Applications FSA s to JES establishing and terminating comm...

Page 10: ... file depending on the initial spool file disposition If an error occurs during the processing of a spool file the spool file is returned to JES with a request to save it on the spool All operator printer requests are processed by SPS A cancelled file will be purged Operating System Requirements SPS Version 3 8 will run without restrictions on MVS systems at the release levels listed below Any spe...

Page 11: ...ding on the initial spool file disposition If an error occurs during the processing of a spool file the spool file is returned to POWER with a request to save it on the spool All operator printer requests are processed by SPS A cancelled file will be purged Operating System Requirements VSE ESA Versions 5 and higher TCPIP V1 4 VSE REXX Oce SPS VSE V3 4 1 Ptf SD30007 ROUTER Support Summary PRISMApr...

Page 12: ...em crashes SPS writes SMF records for the printing files either at clean up or at re selection time assuring a 100 reliable accounting system for the printing jobs VSE No accounting support User exits The following exit points are defined Print Parameter Exit PSF exit 15 This exit inserts records to be appended to the Header string opa section that is transmitted to the server Each printer may hav...

Page 13: ...taset following correction of the network error that has caused the problem If checkpointing was active then a restart of the dataset will be attempted from the checkpoint restart point if the restart from the checkpoint fails then the print will be restarted from the beggining ...

Page 14: ...LINKLST installation optional 6 Apply SPS 7 Authorize SPS libraries in the system 8 Establish SPS program Properties 9 Exclude SPS printers from SMS processing 10 Specify LSQA dumping for SPS 11 Set RACF authorization for SYSUDUMP processing 12 Define the SPS printers to JES 13 Install the start up procedure s 14 Allocate the execution libraries 15 Create the SPS parameter library members 16 Copy ...

Page 15: ... purposes and their member names will be mentioned throughout this document whenever models or examples are available The library model members for parameters have names ending in XXX for APA printers YYY for LIP printers and ZZZ for MOD2 printers Throughout this document the member names in the text ending in xxx are examples of APA printer parameter requirements members ending in yyy are LIP par...

Page 16: ...n release and modification levels provided in the release letter The tapes are formatted as SMP compatible relative file tapes SPS is packaged as functional sysmods and should be installed in the operating system using SMPE The 5 tape files delivered on the SPS base product installation tape can be found in Table 1 on page 16 The tape file format for the PP ROUTER driver feature and be found in th...

Page 17: ...n and SPSISRE0 sample SMP E receive job After the receive is done all other samples may be found in the SAMPLE library relfile loaded SPSJ00 JOB ACCOUNT NAME MSGLEVEL 1 1 SPSJ00C EXEC PGM IEBCOPY SYSPRINT DD SYSOUT PSvrm0 DD DSN SPSvrm0 F3 UNIT tape LABEL 4 SL DISP SHR VOL SER PSvrm0 USERLIB DD DSN USER USERLIB DISP SHR SYSIN DD COPY O USERLIB I PSvrm0 S M SPSISSMP SPSISRE0 SMPPROC Figure 1 Sample...

Page 18: ...e data sets are arbitrary as all references to libraries by SPS and SMP are by ddname The systems programmer may choose any names convenient to the installation However throughout this document all references to these data sets will be by the names used in the table DATA SET SMP DDNAME FUNCTION SPS ASPSDLIB ASPSDLIB DLIB module library SPS ASPSSAMP ASPSSAMP DLIB sample library SPS ASPSMESS ASPSMES...

Page 19: ...page 20 The suggested attributes will simplify maintenance procedures If you have run the sample job SPSISSMP these DDDEF s are already defined DATA SET RECFM LRECL BLKSIZE BLOCKS DIR SPS ASPSDLIB U 6144 900 100 42 SPS ASPSSAMP FB 80 3120 1200 120 40 SPS ASPSMESS VB 251 5020 50 10 5 SPS SPSLINK U 6144 1800 200 16 SPS SPSSAMP FB 80 3120 1200 120 40 SPS SPSMESS VB 251 5020 50 10 5 Table 4 SPS Data S...

Page 20: ...es SPSPLINE SPSPLIP and SPSPEPM or APA module SPSPAPA2 The modules SPSMPDEF SPSMGDA and all the header separator message and trailer page load modules cannot be moved to LPALIB as they are actually non reentrant data areas The direct printing modules SPSMDCAU SPSMDLCN SPSMDLOP and SPSMDSSI should not be installed in LPALIB They will only waste LPA space when installed in LPALIB The JCLIN may be fo...

Page 21: ...do not use direct printing mode When an installation is installing SPS as part of the linklst concatenation the direct printing modules that are normally directed to LINKLIB by the supplied JCLIN can be linked into SPS SPSLINK This will keep the SPS load modules in one library which can facilitate testing of new releases of SPS To install the direct printing modules in SPS SPSLINK change the targe...

Page 22: ...SYS1 SVCLIB UNIT XXXX DISP SHR VOL SER NNNNNN SMP LINKLIB DD DSN SYS1 LINKLIB UNIT XXXX DISP SHR VOL SER NNNNNN SET BDY SPSvrmT APPLY CHECK S SPSvrm0 Figure 3 Sample SMP Apply Job SPSISAP0 SPS base has two appendage routines that are placed in SVCLIB startio and abnormal end As distributed these appendages are named IGG019WS and IGG019WM respectively If either of these appendage names has been use...

Page 23: ...The SPS target load library must be authorized SPS can be run as an authorized steplib as a member of LINKLST or loaded from LPA When run as an authorized steplib the SPS load library name must be added to the IEAAPF00 member of SYS1 PARMLIB When run as a member of linklst the SPS load library name must be added to linklst and if the installation linklst is not authorized then it must also be adde...

Page 24: ...program in the SCHED00 member of SYS1 PARMLIB SCHED00 update is simply coding the PPT statement see Figure 5 A model statement can be found at the beginning of SPSIPPT in SPS SPSSAMP PPT PGMNAME SPSMFSS PROGRAM NAME NOSWAP NON SWAPPABLE KEY 1 PROTECTION KEY AFF NONE NO PROCESSOR AFFINITY NODSI NO DATA SET INTEGRITY Figure 5 Sample PPT statement for SCHED00 in SYS1 PARMLIB ...

Page 25: ... In this trace table are recorded events from the DIE exit JES X memory routines and direct printing open close routines For this reason the trace table needs to be fixed in the LSQA To have the trace table dumped in case of an abend your dump options member in SYS1 PARMLIB i e IEADMP00 for SYSUDUMP should specify SDATA LSQA or SDATA ALLSDATA ...

Page 26: ...e is one functional subsystem The printers defined in the procedure are the printers that the functional subsystem controls The SPS functional subsystems and the printers they control must be defined to the JES subsystem that the installation is using See ROUTER install section for the JES defintions required ...

Page 27: ...944 J Z247 6 7600 Install the SPS Start up Procedure Start up procedures to control the SPS driven printers must be defined and placed in the installation proclib See ROUTER install section for a clarification of the start up procedure ...

Page 28: ...win printers are installed an external storage data set may be optionally used It is suggested that the suffix for this data set be the number of the JES printer expanded to 4 digits jjjj in SPSIEXDS sample A model allocation job for the SPS execution data sets can be found in member SPSIEXDS of SPS SPSSAMP This job also copies the SPSPARM sample members from the SPSSAMP to the SPSPARM library Ple...

Page 29: ...edge of SPS processing options and how the installation is planning on using the product The SPS parameter library members need not be coded before completing the installation of SPS If the installer is also going to code these members the SPS MVS APA SPS MVS LIP or the SPS MVS MOD2 Administrator s Guide should be consulted for an overview of SPS processing and details on coding the parameters The...

Page 30: ...nst unauthorized change 3 Each SPS started task must be authorized to use the SPS data sets defined in its start up procedure 4 Each SPS started task must be authorized to use any control data sets defined in its control key data set list member of SPS SPSPARM 5 Each control data set user must be authorized to update the assigned control data set For a full discussion of defining SPS to RACF pleas...

Page 31: ... should be changed to the drivers ordered 3 If only one of the SPS drivers has been ordered the accept card should be changed to include only the fmid s that are to be installed 3 Where v is the version r is the release and m is the modification level of the delivered version ...

Page 32: ...lude PP ROUTER printers from SMS processing see SPS MVS Installation manual 5 Define the PP ROUTER TCPIP target servers 6 Define the PP ROUTER printers to JES 7 Install extend the start up procedure s 8 Create the PP ROUTER parameter library members SPSPRINT SETUPxxx MSGSUxxx LSCOxxxx 9 Create the PP ROUTER router control table 10 Define SPS Start up Procedures and Data Sets to RACF see SPS MVS In...

Page 33: ... the volume serials are the right 6 characters of the current FMID s of the product with v r and m being the version release and modification levels provided in the release letter The tapes are formatted as SMP compatible relative file tapes All components are packaged as functional sysmods and should be installed in the operating system using SMPE FILE NAME DSORG BLKSIZE DESCRIPTION 1 SMPMCS PS 8...

Page 34: ...n use for the SPS base product These libraries have been named for distribution purposes as shown in Table 10 The names of the data sets are arbitrary as all references to libraries by SPS and SMP are by ddname The systems programmer may choose any names convenient to the installation However throughout this document all references to these data sets will be by the names used in the table DATA SET...

Page 35: ...ACCOUNT NAME MSGLEVEL 1 1 APPLY EXEC SMPPROC SMP SYSIN DD SMPCNTL SMP SVCLIB DD DSN SYS1 SVCLIB UNIT XXXX DISP SHR VOL SER NNNNNN SMP LINKLIB DD DSN SYS1 LINKLIB UNIT XXXX DISP SHR VOL SER NNNNNN SET BDY SPSvrmT APPLY CHECK S SPSvrm8 Figure 8 Sample SMP Apply Job ...

Page 36: ...o device number parameter should be coded If a device number is included in the PRT nnnn or DEVICE statement SPS does not complete its initialization phase Figure 9 Example JES2 Initialization Statements for PP ROUTER client printers A brief explanation of each parameter in the JES initialisation statements follows For a detailed description of these parameters see IBMs documentation relating to J...

Page 37: ...ed Optional no default FSS fss_name Gives the name of the FSS that controls this FSA Required MODE FSS Indicates the FSA is controlled by an FSS Optional default is FSS when FSS is coded PRESELCT YES NO whether data sets are preselected for FSA Optional default is YES PRMODE processing_modes Sets the dataset processing modes for this FSA LINE line data PAGE MO DCA P SOSIn SOSI1 SOSI2 or SOSI3 for ...

Page 38: ...ther track cell despooling is to be used for this FSA Optional default is NO UCS font_name 0 1 4 character default font name 0 specifies that no default font Optional WS work_selection_criteria Establishes the spool selection criteria for this FSA CL Q selects only datasets with the same class as stated in CLASS parameter R selects only those datasets with a destination name that matches one in th...

Page 39: ...O BE USED IN WHICH CASE THE SYSOUT 00680000 STATEMENT SHOULD BE REPLACED BY 00690000 00700000 SYSUDUMP DD DSN PREFIX DUMPSPS1 DISP MOD 00710000 00720000 00930000 SPSMSGDD DD DSN SMIC SPS MESSAGES V030800 SY09014 ENGLISH DISP SHR 00971000 DD DSN SMIC SPS MESSAGES V030800 SY09014 ENGLISH8 DISP SHR 01000100 01010000 SPSPARM DD DSN SPS SMIC SPSPARM DISP SHR R 01072000 01080000 THE LAST 4 CHARS OF THE ...

Page 40: ...quires start up procedure oriented and printer oriented data sets Start up procedure data sets have one allocation of each type in the procedure Printer data sets have one allocation of each type for each printer Every procedure requires a message library a parameter library a ROUTER control table and may need a steplib and dump data set The libraries and ROUTER control table may be shared between...

Page 41: ... in SYS1 PARMLIB SPSMSGDD REQ R This DD is a concatenation of the message data set members for the products installed Up to 5 members may be selected the base product messages the SPS sort messages APA printer messages LINE printer messages and ROUTER messages Different languages may be selected by member name if ordered The message library should be shared between all start up procedures The mess...

Page 42: ...uppressed when GTF is not active during printer initialization and these ddnames are not present for a printer GTF trace collection is not recommended see Trace Generation on page 104 The BUFNO subparameter from the DCB parameter may be increased defaults to 5 to avoid start stops together with tracing see Trace Files on page 102 Table 10 SPS Printer Oriented DDNAME and OUTPUT statement descriptio...

Page 43: ...t terminator should not be used as text within the comment Please refer to Figure 8 for allowable syntax examples All parameters are keywords Their general format is KEYWORD value1 valuen Keyword values must be enclosed by parentheses Multiple keyword values must be separated by commas Blanks will be taken as part of the value if present This means keyword parameters interrupted by a continuation ...

Page 44: ...SPSPRINT SETUPxxx supported parameters PRT printer name Is the device name defined to the spooling system that ROUTER will control Required JES2 Must correspond to the JES printer name CUU RTnn Is a unique name within the group of devices defined within this SPSPRINT member RTnn the first 2 characters must be RT nn can be any number between 00 99 Required LSCODE license code file name A License Ke...

Page 45: ... print parm exit name PPRTRPPX CMDIF MODIFY WTOR TRACELEV 0 4 TRACETYPE ALL INITERM REQFLOW PS DISPAT INVRET PDS ORDER SOCKET TRACEFILE GTF USER TRACESET FF FF FF FF FF FF FF FF DUMP YES NO CHARS font name JCL FORMDEF formdef name JCL PAGEDEF pagedef name JCL MSGSUxxx member parameters The MSGSUxxx parameter member which is installed into the SAMPLIB must be used for all the PP ROUTER printers in ...

Page 46: ... table All parameters should be written in uppercase All parameter values should be coded in uppercase exception to this being the TCPIP name parameter which can be coded in mixed case Each parameter must be coded on a seperate line End a group of parameters relevant for a particular destination by a semi colon Comments should be coded on seperate lines and must begin with ROUTER controls the para...

Page 47: ...on names each being 1 8 characters long separated by a blank character Optional However when not specified then CLASS or FORMS must be given FORMS form names Up to eight form names each being 1 8 characters long separated by a blank character Optional However when not specified then CLASS or DEST must be given IPADDR Server ip address Is the address of the remote server system Specify a valid ip a...

Page 48: ... within a routing group must be terminated with a semicolon e g YEAR_FORMAT YY If you specify more than one of the three routing parameters that is CLASS DEST or FORMS on one routing statement data sets must match all of the specified parameters to be routed to the associated server Install the PP ROUTER License Key PRISMAproduction ROUTER requires a license key in order to run in production mode ...

Page 49: ...fined in 2 7 Errors in router table entries will be shown Any router table groups that have missing required group entries will be disabled In order to test the target destinations then test output datasets require to be transmitted ACCEPT the Product OS 390 MVS A new release of PP ROUTER should be allowed to run for a reasonable period of time in production before doing an SMP accept When the ins...

Page 50: ......

Page 51: ...S system parameters Additionally you may do the following optional tasks to customize SPS to your installation needs 1 Add SPS reentrant phases to SVA Basic Machine Readable Material SPS is shipped as 2 products a base product and a ROUTER print distribution driver The distribution medium for SPS is one no label cartdrige for the base product and one cartdrige for the PP ROUTER driver productThe t...

Page 52: ...PE MTC REW SYS006 EXEC MSHP INSTALL PRODUCT FROMTAPE PRODUCTION INTO PRD2 SPSvrm MTC RUN SYS006 EOJ Figure 1 Sample MSHP Install Job to install base product SPSINST Z In Figure 1 the version release and modification level of the SPS product are designated by the characters vrm You may override the sublibrary name when running the MSHP restore job The base and PP ROUTER products should be installed...

Page 53: ...Installation and Customization U20944 J Z247 6 7600 Entries are created in your System History File by these jobs as follows 5999 SP S00 vrm base SPS product 5999 PS 800 vrm SPS driver for PP ROUTER ...

Page 54: ...k only if you are installing SPS under POWER version 2 3 or a later release otherwise refere to the SPSZPARM section The following statements should be added to the list of the POWER AUTOSTART statements in the startup procedure for the VSE POWER partition See ROUTER install section for the POWER defintions required ...

Page 55: ...s you may load the following phases in the SVA SPSDFSS 304 780 bytes All other phases can not be placed in the SVA 5 PP ROUTER Installation and Customization VSE Installation Overview The following tasks must be performed to install PP ROUTER 1 Install the product from tape using MSHP 2 Define extra JECL parameters in VSE POWER AUTOSTART 3 Define the PP ROUTER TCPIP target servers 4 Install extend...

Page 56: ...Installation and Customization U20944 J Z247 6 7600 6 Create the PP ROUTER router control table 7 Install the PP ROUTER License Key 8 Test the PP ROUTER installation ...

Page 57: ...PRISMAproduction ROUTER feature product tape PTF tape for SPS base component The tapes are in standard MSHP backup restore format The following PRODUCT ID s are used SPSvrm SPS base product PS8vrm PP ROUTER driver product where vrm is the version release and modification level of the product Install product from Tape Install theproduct into a sublibrary whose name is specified in the MSHP job in F...

Page 58: ...reated in your System History File by this jobs for the following product 5999 PS 800 vrm PP ROUTER driver product PP ROUTER printer definitions in VSE and VM There are no system definitions required for the print devices that will be controlled by the DDS SPS for the PP ROUTER driver POWER JECL defines in AUTOSTART The following statements should be added to the list of the POWER AUTOSTART DEFINE...

Page 59: ... 1 65535 DEFINE L OVERLAYB 40 1 8 C DEFINE L OVERLAYF 3F 1 8 C DEFINE L PRTQUEUE 38 1 127 DEFINE L RESFMT 46 1 4 C DEFINE L TITLE 2A 1 60 Define the PP ROUTER TCPIP target servers Definitions for the the PRISMAproduction target TCPIP servers should be made for all the servers that are to be defined in the routing table for PP ROUTER Install the PP ROUTER Start up Job A sample startup job is shown ...

Page 60: ...SP2nnnn SPSE DLI TRA2nnnn 0 SD EXTENT SYS001 volser 1 0 yyy zzz ASSGN SYS001 DISK VOL volser SHR TRACE FILE 2 EXEC SPSDFSS SIZE 512K PARM SPS EOJ Figure 3 Sample SPS Startup Job The above example assumes that you wish to create two trace files to be used in a flip flop fashion should they be required The labels for the trace files may be placed in the standard label area ...

Page 61: ...ilename must be the printer device number expanded to 4 digits as specified in the PRT parameter from the SPSPRINT member These trace files must be allocated if TRACEFILE USER is specified or defaulted in the SETUPcuu system parameter member Trace output alternates between both data sets It is suggested to allocate approximately 20 cylinders of 3380 disk space or equivalent per trace file but you ...

Page 62: ...ch member is a collection of one or more control statements related to a printer or form Each control statement contains one or more parameters defining some facet of the processing A control statement is coded in positions 1 71 of the records in the parameter members with any non blank character in 72 indicating continuation to the next record A control statement may be a maximum of 10 records lo...

Page 63: ...is comment to the blank line following the end of example comment This comment is 5 null control statements of 1 line each Statement 1 KEYWORD1 value1 valuen Possible comment C KEYWORD2 value1 valuen Possible comment C KEYWORDn value1 valuen Possible comment The following statement illustrates key word continuation C situations that are allowed This comment is 1 null control C statement of 3 lines...

Page 64: ...ing system in HOLD status following the transmission of 3500 records Required MSGSU MSGSURTR The supplied MSGSU table must be used Required SETUP setup member name This file is optional and has the following parameter support They define the defaults for the FSA that will be used for all jobs transmitted by this FSA when those parameters that are possible to be given at a job level are not given t...

Page 65: ...table When a dataset has been selected from the spool system for distribution the router control table is referenced A matching group entry is sought the basis being a valid combination of DEST CLASS and FORMS entries from the datasets output characteristics Having found a matching group entry the IPADDR and PORTNUM are used as the target destination Multiple group statements can exist for a singl...

Page 66: ...te lines and must begin with ROUTER controls the parameters for syntax as the print device is started giving messages when errors are found for KEYWORDS PARAMETERS to keywords and also over GROUP validity TCPNAME TCPIP UNIX BOX IN COMPUTER CENTRE DEST PRISMA1 CLASS ABC FORMS UNIX IPADDR 160 120 17 233 PORTNUM 6401 RETRYINT 20 RETRYNUM 2 YEAR_FORMAT YYYY SEND_REC_LENGTH YES Figure 17 Example Router...

Page 67: ...by a blank character Optional However when not specified then CLASS or DEST must be given IPADDR Server ip address Is the address of the remote server system Specify a valid ip address in the format nnn nnn nnn nnn Required PORTNUM server port number Is the port number used on the remote server system This parameter is required Required RETRYINT retry interval 0 Is the number of seconds between re...

Page 68: ...R License Key PRISMAproduction ROUTER requires a license key in order to run in production mode Without the license the application runs in DEMO mode this is indicated as the print device is started and a spool file is processed the following message will be given SPS0944E PRTnnnn NO VALID AUTHORIZATION KEY CONT PROVIDED FOR SPS RUNNING IN RESTRICTED MODE In restricted DEMO mode datasets with a re...

Page 69: ...ation In order to test the installation start the print device that was defined in 2 7 Errors in router table entries will be shown Any router table groups that have missing required group entries will be disabled In order to test the target destinations then test output datasets require to be transmitted ...

Page 70: ......

Page 71: ...SPS Start up Procedures U20944 J Z247 6 7600 ...

Page 72: ...TF can be used instead of the user trace data sets However GTF often loses many trace records depending on the activity of the system The user trace facility provides a wrap around trace table on disk that does not lose trace records The data may also be directed to tape SPS defaults as delivered generate a comprehensive trace to disk The use of trace data collection to disk or tape after installa...

Page 73: ...uple of control modules that are required in order to allow PP ROUTER to function correctly in the system These modules are supplied on the PP ROUTER product tape During the installation of the PP ROUTER product the REXX control modules IRXFLOC and IRXPARMS where installed into the standard SPS libraries ...

Page 74: ...RMODE ANY TITLE IRXFLOC REXX LOCAL FUNCTION PACKAGE DIRECTORY DC CL8 IRXFPACK INITIALIZE THE ID FIELD DC FL4 24 LENGTH OF HEADER DC FL4 7 NUMBER OF FUNCTIONS IN PACK DC FL4 0 RESERVED FIELD DC FL4 32 LENGTH OF EACH FUNC ENTRY DC CL8 PPRL01 PP ROUTER LI INTERFACE ROUT DC V PPRL01 LOAD ADDRESS OF FUNCTION DC FL4 0 RESERVED DC CL8 PPRL01 INITIALIZE THE ID FIELD DC CL8 RESERVED DC CL8 PPRPDSB PP ROUTE...

Page 75: ...OAD DC V PPRTAB LOAD ADDRESS OF FUNCTION DC FL4 0 RESERVED DC CL8 PPRTAB INITIALIZE THE ID FIELD DC CL8 RESERVED DC CL8 SOCKET PP ROUTER ROUTER TABLE LOAD DC V SOCKET LOAD ADDRESS OF FUNCTION DC FL4 0 RESERVED DC CL8 SOCKET INITIALIZE THE ID FIELD DC CL8 RESERVED DC CL8 STORAGE PP ROUTER ROUTER TABLE LOAD DC V STORAGE LOAD ADDRESS OF FUNCTION DC FL4 0 RESERVED DC CL8 STORAGE INITIALIZE THE ID FIEL...

Page 76: ...C is the standard REXX module with the required external functions for ROUTER ARXFLOC CSECT ARXFLOC AMODE 31 ARXFLOC RMODE ANY TITLE ARXFLOC REXX LOCAL FUNCTION PACKAGE DIRECTORY DC CL8 ARXFPACK INITIALIZE THE ID FIELD DC FL4 24 LENGTH OF HEADER DC FL4 7 NUMBER OF FUNCTIONS IN PACK DC FL4 0 RESERVED FIELD DC FL4 32 LENGTH OF EACH FUNC ENTRY DC CL8 PPRL01 PP ROUTER LI INTERFACE ROUT DC V PPRL01 LOA...

Page 77: ...CL8 PPRTRPPX INITIALIZE THE ID FIELD DC CL8 RESERVED DC CL8 PPRTAB PP ROUTER ROUTER TABLE LOAD DC V PPRTAB LOAD ADDRESS OF FUNCTION DC FL4 0 RESERVED DC CL8 PPRTAB INITIALIZE THE ID FIELD DC CL8 RESERVED DC CL8 SOCKET PP ROUTER ROUTER TABLE LOAD DC V SOCKET LOAD ADDRESS OF FUNCTION DC FL4 0 RESERVED DC CL8 SOCKET INITIALIZE THE ID FIELD DC CL8 RESERVED DC CL8 STORAGE PP ROUTER ROUTER TABLE LOAD DC...

Page 78: ... DC CL8 RESERVED END ARXFLOC ARXPARMS The supplied ARXPARMS module is the standard REXX module enabled for LOCAL FUNTION PACKAGES with the PARMBLOCK flags field set as follows PARMBLOCK_FLAGS DC X 0146C000 Issue alternate messages and ...

Page 79: ... of this command is P procid where procid is the procedure id used to start the SPS procedure and corresponds to the FSS id specified in the JES2PARM When any printer is started for the specified procedure and the STOP command is issued SPS rejects the command with a message indicating that printer s are still active Another STOP command has to be given later after all FSS related printers are dra...

Page 80: ...ll terminate with a system abend code 33E termination because of detach macro This command should be used only if the ROUTER printer is hanging wait or looping and you are not able to drain it for JES2 PPRTx The advantage of this command to a simple MVS CANCEL command is that other printers running under the same procedure are not affected If you have just one printer running under this FSS you ma...

Page 81: ...e JES printer name as specified in the JES2PARM and SPSPRINT SPSPARM member SPS always uses the WTOR interface for printer commands in direct printing mode TOPE Command This command requests that SPS open the trace files Any previous information contained in the trace files is lost after they are opened If the trace files are already open this command is ignored After successfully opening the trac...

Page 82: ...S APA Messages Guide for more information about this command TINT Command This command requests that SPS write its internal trace table into the trace file trace level 2 is required Events from some special components of SPS are only traced in the internal trace table JES X memory routines open close put routines The TINT command is automatically executed at normal and abnormal termination time an...

Page 83: ... specifications should be changed only on request from an Océ representative The format of this command is F procid PRTx TSET xxxxxxxxxxxxxxxx or R xx TSET xxxxxxxxxxxxxxxx where xxxxxxxxxxxxxxxx is a 16 character hex string specifying the new traceset value Each digit may be 0 9 or A F one hex digit representation All 16 digits must be specified each time this command is 6 VSE VSE Commands SPS su...

Page 84: ...te printers is the devname PSTOP DEV devname EOJ RESTART FORCE PFLUSH DEV devname HOLD DDS Commands The operator may change the class or logical destination of a printer using the following POWER operator command PXMIT DEV devname ALTER CLASS c LOGDEST cccc DEV Code this operand as shown devname Specifies the device name This parameter must correspond to the name specified for the printer in the P...

Page 85: ...the description of the mentioned messages for an explanation of the status information displayed The PXMIT command may be also used to display and change the trace environment The following 5 subcommands are allowed PXMIT DEV devname TDIS PXMIT DEV devname TOPE PXMIT DEV devname TCLO PXMIT DEV devname TLEV n PXMIT DEV devname TSET hhhhhhhhhhhhhhhh TDIS Requests SPS to display the status of the tra...

Page 86: ...APA componet of SPS via this command On the other hand when running with this options a smaller and optimized version of the PS APA driver is used When you specify trace level 0 in this command or in the SETUPcuu sublibrary member SPS forces an in storage only trace level 1 of the L base component of SPS This reduced trace has a minimum performance impact and may help when only a dump is available...

Page 87: ...L statements the parameter on the DD statement is used These JCL parameters are used to build a header file that is transmitted to the ROUTER server together with the spool data The server stores this header file in reference to the print data for later printing The following JCL parameters are supported ADDRESS address_lines BUILDING building CHARS font_names CKPTSEC seconds CLASS class COPIES nn...

Page 88: ...TXF nnnn mmm unit OFFSETYB nnnn mmm unit OFFSETYF nnnn mmm unit OUTBIN bin_number OVERLAYB overlay_name OVERLAYF overlay_name PAGEDEF pagadef_name PRMODE SOSI1 SOSI2 SOSI3 aaaaaaaa PRTQUEUE print_queue_name RESFMT P240 P300 ROOM room SEGMENT page_count SYSOUT class form_name TITLE title UCS font_name TRC YES NO For a detailed clarification of the parameters above refer to the relevant OS 390 MVS a...

Page 89: ...d to specify the Extended Output Features There are some more sources from where the data set characteristics may be obtained The print data stream APA resources PAGEDEF FORMDEF CHARS can also be specified in the SETUPxxx member for the ROUTER device The JECL has priority over the SETUPxxx member parameters Extended JECL Keywords The following keywords may be specified in the POWER LST statement Y...

Page 90: ... the LST statement If the output to be printed has fewer pages than the checkpoint value specified here then no checkpointing will be done Do not take checkpoints too frequently as for each checkpoint the printer has to provide the operating system with certain control information LST CKPTPAGE sheets APA CKPTSEC seconds APA RTR CONTROL SINGLE DOUBLE TRIPLE PROGRAM APA DATACK BLOCK UNBLOCK BLKCHAR ...

Page 91: ...eported to SPS UNBLOCK specifies that all data check error types should be reported to SPS BLKCHAR specifies that invalid character data errors will not be reported to SPS BLKPOS specifies that print position errors will not be reported to SPS The default for this parameter is UNBLOCK This parameter can be also specified in the printer parameter phase SPSZPARM in the control file or in the DTF FOR...

Page 92: ...ouble font you must start the line with an SO control irrespective of how the last line ended TRC Specifies whether the print records contain embedded font table reference characters TRC s to identify the font to be used to print each record DUPLEX NO NORMAL TUMBLE Specifies whether printing is to be done on one or both sides of each sheet NO Requests printing on the front side of each sheet NORMA...

Page 93: ...ROUTER converts all values to millimeters IN Specifies a unit of inches CM Specifies a unit of centimeters MM Specifies a unit of millimeters PELS Specifies a unit of picture elements 1 240 inch POINTS Specifies a unit of points 1 72 inch OFFSETXF nnnn mmm unit Specifies the offset in the x direction of the logical page origin from the media origin for the front side of each sheet For unit specify...

Page 94: ...unit of millimeters PELS Specifies a unit of picture elements 1 240 inch POINTS Specifies a unit of points 1 72 inch OUTBIN bin_num ber Specifies the number of the output bin OVERLAYB overl ay_name Specifies the name of a medium overlay to be placed on the back side of each page The complete name of the overlay must be given inclusive of the prefix O1 if that is being used to identify overlays OVE...

Page 95: ...Maintenance U20944 J Z247 6 7600 P300 TITLE title Specifies a 1 to 60 character description of the output data set ...

Page 96: ...Maintenance U20944 J Z247 6 7600 ...

Page 97: ...set The ROUTER server administrator may have to amend exits or scripts in order to support additional parameters that are appended by the sending system A Sample source exit is loaded into the sample library from the install tape PPRTRX01 This sample exit builds an opa string of device_name PRTnnnn outgrp_name nn The input buffer that is passed to the exit contains access points to the following O...

Page 98: ...RTnnnn outgrp_name nn The input buffer that is passed to the exit contains access points to the following VSE fields JECL statements OPTB parameters Refer to the sample exit for a full explanation of the INPUT OUTPUT requirements of the exit To install the Print Parameter Exit complile and link edit the suplied sample into a library that is available to the PP ROUTER partition If the name used is ...

Page 99: ...ard must be activated and modified to show its name and location The jobs also assume that all SPS data sets have been defined to SMPE for dynamic allocation as was suggested in the SPS installation procedures see SPS MVS Installation Guide section Allocate the SPS MVS Install Data Sets If this is not the case DD cards for each data set required must be added to the model jobs RECEIVE EXEC SMPPROC...

Page 100: ...NNNNNN SMP SYSIN DD SMPCNTL SET BDY SPSvrmT APPLY CHECK Figure 19 Example SMP PTF Apply Job An accept should be performed only after SPS has been run with the new sysmods for a while without problems A good approach is to accept old sysmods when new sysmods are to be applied ACCEPT JOB ACCOUNT NAME MSGLEVEL 1 1 ACCEPT EXEC SMPPROC SMP SYSIN DD SMPCNTL SET BDY SPSvrmD ACCEPT Figure 20 Example SMP P...

Page 101: ...y each SPS procedure If an lpalib approach has been used there is little advantage in having more than one printer per SPS procedure Most SPS code and dynamic areas are located above the line Just some code and areas must remain below the line because of system restrictions and compatibility reasons Data management buffers and control blocks trace files system resource libraries are located below ...

Page 102: ... of a steplib will reduce search time and possibly load time If an installation requires more than one start up procedure it is desirable to place SPS in lpalib to avoid multiple copies of SPS in the system see Memory on page Error Bookmark not defined This approach also keeps search and load time to a minimum When all the SPS printers in the system can be driven by one procedure little advantage ...

Page 103: ... convenient a listing of all members used in the initialization of the printer and execution of the job This should include the following members for printer nnn and form aaaa4 if they are used Member Contents SPSPRINT Printer table SETUPnnn SPS initialization parameters MSGSUnnn Message table A SYSLOG listing Tape copy of the PP ROUTER trace data set s covering the time when the problem occurred ...

Page 104: ... be recreated so a dump is available to the Océ service representative If one SPS printer is hanging and you have other printers running under the same procedure you should cancel the hanging printer via the F SPSx PRTx CANCEL command See the SPS Administrator s Guide for more information When to Trace The SPS internal trace facility is one of the most useful tools for diagnosing system or SPS int...

Page 105: ... the PRISMAproduction ROUTER Administrator s Guide For all reproducible problems in the absence of any special instructions from an Océ service representative the trace information should be At trace level 4 Directed to large user trace data sets or to tape TRACEFILE USER Run with options TRACETYPE ALL and TRACESET FFFFFFFFFFFFFFFF for these parameters in the SETUPnnn member for the printer These ...

Page 106: ...EXAMPLE JOB TO GENERATE ITF TAPE S1 EXEC PGM SPSMPTRC STEPLIB DD DSN SPS SPSLINK DISP SHR TRMSG DD SYSOUT TROUT DD DSN ITF desc data VOL SER volser UNIT TAPE DISP NEW KEEP TRIN1 DD DSN SPS TRA1nnnn DISP SHR TRIN2 DD DSN SPS TRA2nnnn DISP SHR SYSIN DD OUTPUT ITF Figure 23 Example Trace Generation Job ...

Page 107: ...ational message W Warning message Some unusual situation occurred PRTn JES printer name for the printer to which the message refers The printer name is not repeated in each of the message descriptions below but will be present in all messages that are associated with a particular printer All messages issued by SPS are in the following format SPxnnnnt PRTn TEXT where SP Prefix identifier of all SPS...

Page 108: ... for the printer to which the message refers The printer name is not repeated in each of the message descriptions below but will be present in all messages that are associated with a particular printer All SPS messages are issued with routing code 7 and no descriptor code If NOTIFY user list is specified in the SETUPxxx member A and E type messages are sent to the requested userids also ...

Page 109: ...urn to the spool in HOLD Operator Response None Programmer Response Either make the required parameter file entries to include a valid License Key for this CPU for product PP ROUTER V3 8 or contact you Océ Representative in order to obtain one RTR0002E PRTnnnn J jobname JID jobnumber NO MATCHING ROUTER TABLE ENTRY FOUND Explanation There was no valid routing group found in the router control table...

Page 110: ...d and the dataset is returned to the spool in HOLD Operator Response Release and retransmit the dataset if the problem persists then inform the Network Administrator Programmer Response None RTR0004W PRTnnnn J jobname JID jobnumber ROUTER EOF VALUE DOES NOT MATCH SERVERS BYTES RECEIVED S ipaddress DATASET WILL BE HELD Explanation The EOF byte count from ROUTER does not match the number of bytes re...

Page 111: ...RTR0006I PRTnnnn J jobname JID jobnumber CHECKPOINT RESTART FAILED ROUTER CHECKPOINT VALUE DOES NOT MATCH SERVERS S ipaddress DATASET WILL BE RESTARTED FROM THE BEGINNING Explanation The current dataset has a valid ROUTER checkpoint record However when a restart was attempted from the checkpoint restart position the server rejected the restart as the checkpoint values did not match The transmissio...

Page 112: ...perator Response When the keywords that where in error are corrected then STOP and START the printer in order to activate the corrected ROUTER control table Programmer Response Correct the keyword entries that are in error RTR0009W PRTnnnn ERROR IN ROUTER TABLE GROUP group_number ALL REQUIRED KEYWORDS ARE NOT DEFINED THE GROUP IS DISABLED Explanation The Group entry number group_number is failing ...

Page 113: ...ord was found identified by KEYWORD at line LINE with a parameter that has a length greater than the allowed maximum_length_parm for that keyword SPS Action The keyword entry is ignored Processing continues with the next keyword Operator Response When the keywords that where in error are corrected then STOP and START the printer in order to activate the corrected ROUTER control table Programmer Re...

Page 114: ...p addresses SPS Action The keyword entry is ignored Processing continues with the next keyword Operator Response When the keywords that where in error are corrected then STOP and START the printer in order to activate the corrected ROUTER control table Programmer Response Correct the keyword entries that are in error Explanation SPS Action None Operator Response None Programmer Response None RTR10...

Page 115: ...performed without a dump and the printer is terminated Operator Response Report this error to your ROUTER administrator Programmer Response Correct the PPRTRPPX keyword entry in the SETUPxxx member for the printer Explanation SPS Action None Operator Response None Programmer Response None ...

Page 116: ...ve with the following Console output SPS trace level 3 SETUP member Dump if produced TCPIP trace if required RTR8002E PRTnnnn UNABLE TO CREATE SOCKET RC socket_rc Explanation ROUTER was unable create a socket in the current active socket set for the reason indicated by socket_rc SPS Action The current dataset is returned to the spool in HOLD Operator Response Check that the TCPIP application is ac...

Page 117: ...rrect server and port destination are defined Problem Determination Report this problem to your Océ Representative with the following Console output SPS trace level 3 SETUP member Dump if produced TCPIP trace if required RTR8004E PRTnnnn UNABLE TO CONNECT TO S server_ip_address P server_port_number RC socket_rc ATTEMPT attempt_number OF retry_count RETRY INTERVAL retry_interval SECONDS Explanation...

Page 118: ...network connection to the server and that the download application on the server is functioning correctly Problem Determination Report this problem to your Océ Representative with the following Console output SPS trace level 3 SETUP member Dump if produced TCPIP trace if required RTR8008E PRTnnnn ERROR WHEN CLOSING SOCKET CONNECTION S server_ip_address P server_port_number USING SOCKET socket_rc E...

Page 119: ...fied connection Operator Response Check that the server is active and that the download application on the server at the specified port is active Programmer Response Check for network errors to the specified server Problem Determination Report this problem to your Océ Representative with the following Console output SPS trace level 3 SETUP member Dump if produced TCPIP trace if required RTR8010E P...

Page 120: ...ownload application on the server is functioning correctly Problem Determination Report this problem to your Océ Representative with the following Console output SPS trace level 3 SETUP member Dump if produced TCPIP trace if required Explanation SPS Action None Operator Response None Programmer Response None ...

Page 121: ...S Insert the SPSnnnnn messages from the MVS message guide VSE Insert the SPSnnnnn messages from the VSE message guide SPS Abend Codes Please report the problem and abend termination code information to your Océ support representative ...

Page 122: ...lation problems they must be sent exactly as they are given here 1 Determine if the IBM Library for SAA REXX 370 Release 3 FMID HWJ9130 or the Alternate Library FMID HWJ9133 is installed If either one is installed you need take no further action If Release 1 FMID HWJ9110 or Release 2 FMID HWJ9120 of the Library is installed you must install Release 3 Once Release 3 is installed you need take no fu...

Page 123: ...llowing ddnames SEAGALT AEAGMOD1 SEAGMENU AEAGMENU SEAGSAM AEAGSAM SEAGJENU AEAGJENU You can do it with this UCLIN 5 Alternate Library Data Set Characteristics Data Set Name Space RECFM LRECL BLKSIZE SPS V380 REXX V1R3M0 SEAGALT 32760 12 12 4 U 32760 SPS V380 REXX V1R3M0 AEAGMOD1 32760 20 190 32 U 32760 SPS V380 REXX V1R3M0 SEAGMENU 27998 10 10 2 VB 255 27998 SPS V380 REXX V1R3M0 AEAGMENU 27998 10...

Page 124: ...AGSAM SHR ADD DDDEF SEAGJENU DA SPS V380 REXX V1R3M0 SEAGJENU SHR ADD DDDEF AEAGJENU DA SPS V380 REXX V1R3M0 AEAGJENU SHR ENDUCL SET BDY DLIBZONE UCLIN ADD DDDEF AEAGMOD1 DA SPS V380 REXX V1R3M0 AEAGMOD1 SHR ADD DDDEF AEAGMENU DA SPS V380 REXX V1R3M0 AEAGMENU SHR ADD DDDEF AEAGSAM DA SPS V380 REXX V1R3M0 AEAGSAM SHR ADD DDDEF AEAGJENU DA SPS V380 REXX V1R3M0 AEAGJENU SHR ENDUCL The UCLIN can be fo...

Page 125: ...sors and their corresponding interface routines to TSO E When a program is compiled by the REXX 370 Compiler the compiled exec contains the name of the REXX 370 Library as the alternate exec processor The CPT must be updated to include the Alternate Library Your installation uses either the default table in SYS1 LINKLIB shipped with TSO E or an installation defined CPT To replace the default IRXCM...

Page 126: ...KUMOD in REXX V1R3M0 SEAGSAM c Set the number of entries in the table to the number of entries in the installation defined CPT plus 1 This ensures that the Alternate Library can be used concurrently with the other runtime libraries specified in the installation defined CPT d Assemble and link edit the updated IRXCMPTM e Replace the existing IRXCMPTM f Update the REXX 370 program directory The prog...

Page 127: ...Messages U20944 J Z247 6 7600 Do not place the Alternate Library either in the LPA or in a STEPLIB for the application ...

Page 128: ......

Page 129: ...d ENVIRONMENTAL data is helpful for the analysis of any problem 1 Description of the sequence or process that produced the message or abend termination code 2 List of any special system components 3 System log output 4 Output from the PTFI PRTI SDIS and FDIS SPS commands or PRINTSET and PRINTOPT SPSPARM options PRINT DATA producing the problem 1 Print file 2 JCL used 3 Resources requested form def...

Page 130: ...4 J Z247 6 7600 4 Sniffy trace will require FE help in collection SYSTEM DUMP is always required to diagnose abend conditions 1 DUMP s produced by SPS termination routines Any other dumps produced during the failure ...

Page 131: ...List of Tables U20944 J Z247 6 7600 List of Tables Fehler Es konnten keine Einträge für ein Abbildungsverzeichnis gefunden werden ...

Page 132: ...U20944 J Z247 6 7600 ...

Page 133: ...Bibliography U20944 J Z247 6 7600 Bibliography SPS MVS APA Administrator s Guide U21020 J Z247 X 7600 SPS MVS APA Messages Guide U21745 J Z247 X 7600 ...

Page 134: ......

Page 135: ...0 41 42 Checkpoint interval 139 CKPTPAGE 139 CKPTSEC 139 Classes altering 128 commands SPS 123 component id 75 94 CONTROL 139 50 50 Control File concept 133 control statement format 65 99 customization 73 data sets allocation 49 50 50 execution 49 62 109 113 install 24 56 87 DATACK 139 34 35 81 82 35 39 58 89 81 82 descriptor codes 156 DEVICE statement JES 39 diagnosis 150 distribution tapes forma...

Page 136: ... application FSI See functional subsystem interface FSS See functional subsystem FSSDEF statement JES 39 58 89 functional subsystem 13 39 58 89 functional subsystem application 13 functional subsystem interface 13 IEAAPF00 30 IEFSD060 31 IEFSDPPT 31 See also program properties table install POWER JECL defines in AUTOSTART 95 TCPIP server definitions 97 install jobs 19 accept 52 71 107 apply 28 56 ...

Page 137: ...sing 13 PAGEDEF 140 parameter library members 49 performance 148 libraries 149 memory 148 PIMSG 140 PPT See program properties table Printer status obtaining 129 PRINTERnn statement JES 39 PRMODE 140 problem reporting 150 product id 75 94 program properties table 31 PRTnnnnn statement JES 39 58 89 PXMIT command 128 FORM subcommand 129 JOBS subcommand 129 STAT subcommand 129 TCLO subcommand 129 TDI...

Page 138: ...onsiderations 61 109 112 STAT subcommand of PXMIT command 129 statement syntax 65 99 Status of printer obtaining 129 STEPLIB 63 111 114 support summary APA 16 syntax 65 99 SYSABEND 63 111 114 system parameter members control statement format 65 99 system parameters syntax 65 99 SYSUDUMP 63 111 114 tapes of SPS product 73 TCLO subcommand of PXMIT command 129 TDIS subcommand of PXMIT command 129 TLE...

Page 139: ...mmand of PXMIT command 129 VSE VM printer definitions install 95 VSE start up job installing 97 VSE POWER AUTOSTART 80 AUTOSTART statement 80 DEFINE statement 80 35 81 XA See operating system requirements See operating system requirements ...