Operating instructions

ManualsBrandsSharp ManualsComputer equipmentJX-9500H

Xprint F.A.Q.

Document revision 10

(16.09.2008)

Page 1/89

Xprint Frequently Asked Questions

XPRINT – GENERALITIES..........................................................................................................................................4

A.1

ACKUP

ERVER

.......................................................................................................................................................4

A.2

OMPATIBILITY OF SHELL SCRIPTS THAT USE

PRINT COMMANDS

...........................................................................4

A.3

OW TO CONFIGURE A

PRINT DOMAIN

? .................................................................................................................5

A.4

CHANGE THE LEFT MARGIN VALUES ON HEADER

TRAILER PAGES

? ....................................................5

A.5

OW CAN

GRANT USERS THE LOCAL

PRINT ADMINISTRATOR ROLE

?....................................................................6

A.6

OW CAN

MODIFY THE SIZE OF THE HEADER PAGE CHARACTERS

?..........................................................................6

A.7

OW CAN

PRINT SPECIAL CHARACTERS THAT ARE NOT RECOGNIZED BY THE PRINTER

?..........................................7

A.8

OW CAN

PRINT A START SHEET IN LANDSCAPE MODE

?.........................................................................................8

A.9

OW CAN

SEND ESCAPE SEQUENCES AT THE BEGINNING OR AT THE END OF A JOB

? ...............................................8

A.10

OW TO ATTRIBUTE A

TCP/IP

ADDRESS TO A PRINT SERVER

? (

: A

XIS BOX

)........................................................9

A.11

OW TO CHANGE THE NAME OF A HOST DEFINED WITHIN AN

PRINT DOMAIN

? .......................................................9

A.12

OW TO CONFIGURE CORRECTLY THE

LANG

AND

NLSPATH

VARIABLES

? ..........................................................10

A.13

OW TO STOP THE LPDAEMON ON

AIX?..................................................................................................................10

A.14

OW TO SUPPRESS RESTRICTIONS ABOUT VERTICAL MOTION VALUES

?...................................................................10

A.15

OW TO TAKE THE

EADER

& T

RAILER PAGES FROM SPECIAL HOPPER

?................................................................11

A.16

AXIMUM NUMBER OF DEVICES PER SUPERVISOR

SERVERS OBJECTS

...................................................................12

A.17

HAT HAPPENS IF A USER LAUNCHES A JOB CONTAINING MORE PAGES THAN STILL AVAILABLE IN HIS QUOTA

?.....12

A.18

HICH

PRINT CONCEPTS CAN BE USED TO ENSURE AVAILABILITY OF THE PRINT SERVICE

? .................................13

LIST OF SUPPORTED PRINTERS............................................................................................................................17

INSTALLATION UNIX................................................................................................................................................18

INSTALLATION WINDOWS .....................................................................................................................................19

STARTING AND STOPPING......................................................................................................................................20

E.1

OW CAN

REDUCE THE DELAY BETWEEN A STOP

START OF

?...................................................................20

E.2

OW MUST THE

-M

ASTERS BE REBOOTED

? .........................................................................................20

E.3

HY DO

GET THE ERROR MESSAGE

XP000158 : D

ATABASE INSTALLATION ERROR

? ...........................................20

PRODUCT LICENSING ..............................................................................................................................................21

F.1

OW TO USE XPKEY

I WITH CODES DISPLAYED ON

LINES

IN THE LICENSE FILE

? ................................................21

F.2

HAT ARE THE

EMO LICENSE CONDITIONS

?.........................................................................................................21

LICENSE GENERATION TOOL (DMG)..................................................................................................................22

G.1

HAT KIND OF KEYS CAN BE GENERATED WITH THE

DMG

LICENSE GENERATION TOOL

? ......................................22

G.2

OW CAN

PRODUCE SUCH KEYS

? ..........................................................................................................................22

G.3

HERE IS THE

DMG

KEY FILE LOCATED

?...............................................................................................................23

G.4

HERE IS THE EVENT COLLECTOR KEY FILE LOCATED

? ..........................................................................................23

PRINTER CONNECTION ...........................................................................................................................................24

H.1

OW TO DEFINE A PRINTER CONNECTED TO AN

XIS BOX

? ....................................................................................24

H.2

OW TO CONFIGURE THE PORTS OF AN

XIS BOX

?.................................................................................................25

PRINTING .....................................................................................................................................................................26

I.1

ISPLAY ON

PJL

PRINTERS IS NOT RESET

.....................................................................................................................26

I.2

OW TO PRINT

LINES IN

10LPI

AND

ANDSCAPE ON AN

HP-LASERJET

PRINTER

? ..............................................26

I.3

OW TO DEFINE THE NEW FORMS FOR THE FORMAT

LETTER ? ..................................................................................34

I.4

OBS SENT TO PRINTER WITH BSD FAST FILTER REMAIN

ACTIVE

FOREVER

.................................................................34

PRINT JOB PROCESSING .........................................................................................................................................35

J.1

HICH

PCL

DO WE RECOMMEND ACCORDING TO A PRINTER

?....................................................................................35

BSD PROTOCOL BASED INTEROPERABILITY ..................................................................................................51

Summary of content (89 pages)

PAGE 1
Xprint F.A.Q. Document revision 10 (16.09.2008) Xprint Frequently Asked Questions A. XPRINT – GENERALITIES .......................................................................................................................................... 4 A.1 A.2 A.3 A.4 A.5 A.6 A.7 A.8 A.9 A.10 A.11 A.12 A.13 A.14 A.15 A.16 A.17 A.18 BACKUP SERVER .......................................................................................................................................................
PAGE 2
Xprint F.A.Q. Document revision 10 (16.09.2008) K.1 HOW TO SEND A JOB FROM BS2000 BY USING RSO (IN RAW MODE) TO A XPRINT NT PRINTER WITH APPLICATION OF FILTER ? ............................................................................................................................................................................ 51 K.2 BSD JOBS SENT TO DPRINT ARE ONLY PRINTED WHEN SUBMITTED FROM THE HOST OF THE LOCAL XPRINT BSD GATEWAY ..................................................................
PAGE 3
Xprint F.A.Q. X.1 X.2 X.3 Document revision 10 (16.09.2008) HOW CAN I SEARCH FOR A STRING IN THE DMG WINDOW USING A FIREFOX WEB BROWSER ?............................... 86 HOW CAN I CHANGE THE TEXT SIZE IN THE DMG WINDOW USING A FIREFOX WEB BROWSER ? ............................. 86 HOW CAN I CUSTOMIZE MY FIREFOX WEB BROWSER ? ........................................................................................... 86 Y. LIMITATIONS AND RESTRICTIONS ....................................................
PAGE 4
Xprint F.A.Q. Document revision 10 (16.09.2008) A. Xprint – Generalities A.1 Backup Server Xprint provides internally two features ensuring a basic high availability: the device group for the printing and the replicated database mechanism for the product management. The device group is an Xprint resource providing the possibility to associate a set of printing devices with a logical name.
PAGE 5
Xprint F.A.Q. Document revision 10 (16.09.2008) For example, if you have a shell script that uses the output from the A.3 How to configure a Xprint domain ? The steps to configure a Xprint domain are the followings: 1. Create an entry "Xprint_db" in the file /etc/services: Xprint_db xxxx/tcp where xxxx is a port number which must be the same on all the hosts belonging to the domain. 2. Install Xprint and the licence on each computer. 3.
PAGE 6
Xprint F.A.Q. Document revision 10 (16.09.2008) If you don't set the sequence \E&l0U in the pbod capability, the left margin set in the pboj will be used during all the job. - Save the file. - Add the new Pcl in the Xprint DB : xpadd -pcl -fi xpterm - Create the device : xpadd -dev -pc A.5 How can I grant users the local Xprint administrator role ? This kind of user is called a "subroot" user by Xprint.
PAGE 7
Xprint F.A.Q. Document revision 10 (16.09.2008) @PJL JOB NAME = "Xprint job"\015\012 @PJL RDYMSG DISPLAY = "%g$C%s"\015\012 @PJL USTATUSOFF\015\012 @PJL USTATUS JOB=ON\015\012 @PJL USTATUS TIMED=15\015\012 @PJL USTATUS PAGE=ON\015\012 @PJL ENTER LANGUAGE = PCL\015\012 \EE\E&l1H\E&l8C\E&k2G\E(s5H %e\E\%\-12345X@PJL ENTER LANGUAGE = PCL\015\012 \EE\E&l1H\E&l8C\E&k2G\E(s5H%;, - Save the file.
PAGE 8
Xprint F.A.Q. Document revision 10 (16.09.2008) "ISO-100:ECMA-94" language except the 134 and 174 (replaced via map table char_map). So, depending on the used Pcl, choose your reference language. If this line is the last of the capability, replace %e by %; 4. Register the Pcl modification in the Xprint database with the following command: xpmod -pcl -fi xpterm -ho5. You can now add a new job on a printer defined with the modified Pcl.
PAGE 9
Xprint F.A.Q. Document revision 10 (16.09.2008) 4) - If this Pcl is non PJL one : o o Associate the sequences of the begin of job to the "boprt" capability. If you want the sequences to be sent before each document, associate it to "bodoc" capability. Associate the sequences of the end of job to the "eoprt" capability. If you want the sequences to be sent after each document, associate it to "eodoc" capability. - If this Pcl is a PJL one: o o o o pboj match to boprt. pbod match to bodoc.
PAGE 10
Xprint F.A.Q. Document revision 10 (16.09.2008) A.12 How to configure correctly the LANG and NLSPATH variables? If you receive the following error: “The message catalogue can't be opened. Please, verify your LANG and NLSPATH variables. " or "The message or message catalogue seems to be removed or not present. Contact your administrator if problem is still present. " You can fix it this way: 1. Set the LANG variable to any authorized value.
PAGE 11
Xprint F.A.Q. Document revision 10 (16.09.2008) # = number of 1/48 inch. In the formula (lpi=\e&l%{48}%p1%/%dC,) the result of 48 divided by p1 has to be an integer. This leads to restrictions in the values for the lpi (1,2,3,4,6,8,12,16,24,48) A workaround is to use a conditional structure where the result of 48/p1 is already computed : lpi=%?%p1%{1}%=%t\e&l48C%e %p1%{2}%=%t\e&l24C%e %p1%{3}%=%t\e&l16C%e %p1%{4}%=%t\e&l12C%e %p1%{5}%=%t\e&l9.6C%e %p1%{6}%=%t\e&l8C%e %p1%{7}%=%t\e&l6.
PAGE 12
Xprint F.A.Q. Document revision 10 (16.09.2008) and eodoc=\EZ\EE\E&l1H\E&k2G, to eodoc=\EZ\EE\E&l1H\E&l3H \E&k2G, - Set the default hopper 1 (\E&l1H) sequence for the body of your jobs in the bodoc capability. Change: # bodoc=, to bodoc=\E&l3H, - Save the file.
PAGE 13
Xprint F.A.Q. Document revision 10 (16.09.2008) A.
PAGE 14
Xprint F.A.Q. Document revision 10 (16.09.2008) 2. Database replication The replicated database mechanism for the product management is based on the active master/potential master roles of the hosts in the Xprint domain. When the active master is down, a potential master takes automatically its place. Ex: If active master is down, the first Potential Master in the hierarchy will automatically take its place. 1.
PAGE 15
Xprint F.A.Q. Document revision 10 (16.09.2008) If the backup node did not acquire the same system name as the primary node, some changes on the Xprint side could have to be done: • In Xprint V6, man can take profit of the $XPCONF/DB.local/localconfig file to assign a virtual host name to the system. If this files exists and contains a line of the type LOCALHOST=hostname, the mentioned hostname is used as the node name of the local host.
PAGE 16
Xprint F.A.Q. Document revision 10 (16.09.
PAGE 17
Xprint F.A.Q. Document revision 10 (16.09.2008) B. List of supported printers Please have a look at the section 7.1 of the reference manual or at the section “J.1 Which PCL do we recommend according to a printer ?” of this F.A.Q.
PAGE 18
Xprint F.A.Q. Document revision 10 (16.09.2008) C. Installation UNIX Please read the Xprint 8 release nopte from section 8.4.4 to 8.4.10.
PAGE 19
Xprint F.A.Q. Document revision 10 (16.09.2008) D. Installation Windows Please have a look at the section 7.
PAGE 20
Xprint F.A.Q. Document revision 10 (16.09.2008) E. Starting and stopping E.1 How can I reduce the delay between a stop-start of Xprint ? On a Xprint-Net configuration the port Xprint_db stays for a while in TIME-WAIT after the processes are already gone. During this period Xprint can not be re-started, the message that is returned is: "XP000161: Database public port open failed" Following the platform, this period takes about some seconds, to several minutes on the Solaris operating system.
PAGE 21
Xprint F.A.Q. Document revision 10 (16.09.2008) F. Product Licensing F.1 How to use xpkey -i with codes displayed on 2 lines, in the license file ? For instance, to register the following key: Mq GB Fu 5Z tD gI rD CW 1D wr CX fI Sq Bb: LJ f4 W6 LL MM:: ========== # File : # Product : - version <05.2A00> # Expiration date : <2025/12> # Devices : <256> # Detailed list : Net Server GW_BSD GW_GIP2 FF_BSD FF_AXIS Mercator # Supported O.S.
PAGE 22
Xprint F.A.Q. Document revision 10 (16.09.2008) G. License generation tool (DMG) G.1 What kind of keys can be generated with the DMG license generation tool? The license key generator has been designed to generate keys for two purposes: Keys that control the number of sessions within the domain monitoring GUI Keys that control whether the event collector saving information is turned on or not G.
PAGE 23
Xprint F.A.Q. Document revision 10 (16.09.2008) Program output: Interactive Mode Vendor Name: OSL License ID : Event_Collector Number:1 The program creates the key within a file (guiKey file). This file is created in the current directory. Afterwards, this file has to be sent to the customer and must be copied in the right directory. Be careful, the name of this file is very important ! G.
PAGE 24
Xprint F.A.Q. Document revision 10 (16.09.2008) H. Printer connection H.1 How to define a printer connected to an Axis box ? Printing to a printer connected to an Axis box is possible by using the axis fast filter. This filter allows not only to submit print jobs but also to have a follow-up of the printer status (as for example Printer Off, Paper End , ....).
PAGE 25
Xprint F.A.Q. Document revision 10 (16.09.2008) Restrictions : When a printer exception occurs while printing a job, the printer will be seen as being in error during the whole job printing. This is due to a wrong behaviour of the Axis box which sends an error message when a problem occurs on the printer ( for example: Paper End, Printer Off, .. ), but does not notify when the problem is repaired. No printer status information is returned by AXIS box Firmware version 5.02. Firmware version 4.22 and 4.
PAGE 26
Xprint F.A.Q. Document revision 10 (16.09.2008) I. Printing I.1 Display on PJL printers is not reset On a device configured in Xprint with the pcl object PJL-PCL5e, the display of the printer is not reset to "ready" after printout, but displays the job name, until next job arrives. This is the default behavior. But you can choose another option in the pcl object.
PAGE 27
Xprint F.A.Q. Document revision 10 (16.09.2008) # ############### # LVM10, # Printing Rate and Buffer Size # If you whish that Xprint synchronizes itself with the printer, # please use the "cps" capability given here below as a comment. # Adjust its value if necessary. It is given here as a comment # in order to avoid useless waiting times that could occur. # cps#1200, bufsz#2048, # beginning of sequences # bodoc=, # bolin=, # bopag=, boprt=\EE\E&k2G, # boprt=\E&l4.
PAGE 28
Xprint F.A.Q. Document revision 10 (16.09.2008) # sides # SINGLE : 1 # DOUBLE_WIDE 2 # DOUBLE_NARROW 3 sides=%?%p1%{1}%=%t\e&l0S%e %p1%{2}%=%t\e&l1S%e %p1%{3}%=%t\e&l2S%;, # character set # PM A0259586 - SPOOL V4.
PAGE 29
Xprint F.A.Q. Document revision 10 (16.09.2008) %p1%"8859-1"%=%t@map_tab.HPLJT ISO-100:ECMA-94%; # lines per inch # lpi=\e&l%{48}%p1%/%dC, lpi=%p1, # characters per inch cpi=\e(s%p1%PA%gA%dH, # style (Italics, Normal) sitm=\E(s1S, ritm=\E(s0S, # typeface # A0273944 : extended typefaces HP LaserJet 4 # Two iternal typefaces are proportional typefaces, these are "Univers" # and "CG-Times" typefaces.
PAGE 30
Xprint F.A.Q. Document revision 10 (16.09.
PAGE 31
Xprint F.A.Q. Document revision 10 (16.09.
PAGE 32
Xprint F.A.Q. Document revision 10 (16.09.
PAGE 33
Xprint F.A.Q. Document revision 10 (16.09.2008) Put the XpcomFAX.sh script in the backends directory ( $XPRINT_HOME/backends ) with next access rights ( 0550 bin bin ). 3. Send a job. The phone number is specified in the job comment flag –jc. xpadd -de -dr ….. -jc 003281554320 The file /tmp/comFAX.log is updated when a job fax is send. Care : The job fax disappear of the Xprint BD after the submission to comFax.
PAGE 34
Xprint F.A.Q. Document revision 10 (16.09.2008) debug=$1 jobid=$2 comment=$3 files=$4 echo " `date` fax : jobid $jobid, comment $comment , files $files " >> $DBGFILE if [ then echo echo exit fi -z "$comment" ] " job ${jobid} : NO phone number see comment " >> $DBGFILE " job will be SUSPEND" >> $DBGFILE 3 cat $files | ${FAXPATH}/comfaxpr -phone $comment echo " `date` fax $jobid send exit = $? " >> $DBGFILE exit 0 I.3 How to define the new forms for the format LETTER ? You must : 1.
PAGE 35
Xprint F.A.Q. Document revision 10 (16.09.2008) J. Print job processing J.
PAGE 36
Xprint F.A.Q. Document revision 10 (16.09.
PAGE 37
Xprint F.A.Q. Document revision 10 (16.09.
PAGE 38
Xprint F.A.Q. Document revision 10 (16.09.
PAGE 39
Xprint F.A.Q. Document revision 10 (16.09.
PAGE 40
Xprint F.A.Q. Document revision 10 (16.09.
PAGE 41
Xprint F.A.Q. Document revision 10 (16.09.
PAGE 42
Xprint F.A.Q. Document revision 10 (16.09.
PAGE 43
Xprint F.A.Q. Document revision 10 (16.09.
PAGE 44
Xprint F.A.Q. Document revision 10 (16.09.2008) HP LaserJet IIIP HP-LASERJET HP LaserJet IIISi PostScript v52.3 POSTSCRIPT HP LaserJet IIISi HP-LASERJET HP LaserJet IIP HP-LASERJET HP LaserJet IIP Plus HP-LASERJET HP LaserJet IIP PostScript Cartridge v52.
PAGE 45
Xprint F.A.Q. Document revision 10 (16.09.
PAGE 46
Xprint F.A.Q. Document revision 10 (16.09.
PAGE 47
Xprint F.A.Q. Document revision 10 (16.09.
PAGE 48
Xprint F.A.Q. Document revision 10 (16.09.
PAGE 49
Xprint F.A.Q. Document revision 10 (16.09.
PAGE 50
Xprint F.A.Q. Document revision 10 (16.09.
PAGE 51
Xprint F.A.Q. Document revision 10 (16.09.2008) K. BSD protocol based interoperability K.1 How to send a job from BS2000 by using RSO (in raw mode) to a Xprint NT printer with application of filter ? This is a possible solution : Use the "TCP/IP" print server on Windows NT and define a printer with WPRINT sending the document with GIP2. In the Wprint port definition , you can specify job options like for example, filter to be applied on Xprint. K.
PAGE 52
Xprint F.A.Q. Document revision 10 (16.09.2008) You can check it with the "netstat –a | grep 9999" command, which returns you the list of the connections using this port. K.5 How to define a RSO printer using the protocol LPD ? Configuration of RSO printers Connecting a printer to BSD-LPD : A printer that is connected to a BSD-LPD must be defined with the SPSERVE statement ADD-SPOOL-DEVICE or MODIFY-SPOOL-DEVICE. To do this, the following operands are used.
PAGE 53
Xprint F.A.Q. Document revision 10 (16.09.2008) has actually been printed. Restart rules : The printer error code "LpdJobAborted" has been introduced in order to draw attention to problems such as "request rejected", "timeout detected" etc. in dialog with a BSD-LPD. If this error code is displayed, the print job is entered in the KEEP queue. In addition, message SR00993 is issued if the printer status is queried by means of /SHOW-SYSTEM-STATUS INF=*REMOTE(...).
PAGE 54
Xprint F.A.Q. Document revision 10 (16.09.2008) The smallest permissible port number from the BSD-LPD server for its BSD-LPD client (i.e. RSO); the preset value is 721. For Xprint, see option -op of the xpadd -gtw command. The largest permissible port number from the BSD-LPD server for its BSD-LPD client (i.e. RSO); the preset value is 731. For Xprint, see option -op of the xpadd -gtw command. 2.
PAGE 55
Xprint F.A.Q. Document revision 10 (16.09.2008) Configuration of RSO printers Execution example The following example summarizes the definitions of the operatin environment required to give RSO V3.0A access to a 4822 Printer that is controlled from a UNIX host. RSO V3.0A accesses the printer via the Xprint-BSD gateway server running on the UNIX host.
PAGE 56
Xprint F.A.Q. Document revision 10 (16.09.2008) control characters) to the printer, and finally conversion of this data by the printer (according to the printer language). Establishing the connection Before a dialog can commence with the printer controller, a logical connection must be established between RSO and the printer (definition of the communication attributes of the two partners). In order to access the printer, RSO must know the communication attributes of the partner.
PAGE 57
Xprint F.A.Q. Document revision 10 (16.09.2008) L. Xprint (GIP2) protocol based interoperability (except with Dprint) L.1 • Gateway activation problem A common problem, that can prevent you to activate a gateway, is when several gateways are using the same port number, which is set by the "-ga" option. You can easily check it by typing xpshow –gtw –scl "-ga 9999" where, for example, 9999 is the port number. This command will show you all the gateways using this address.
PAGE 58
Xprint F.A.Q. Document revision 10 (16.09.2008) M. Interoperability with Dprint Please visit the web site of fujitsu-siemens to get the DPRINT manuals. http://www.fujitsu-siemens.com/products/software/doc_printing/bs2000osd/dprint.
PAGE 59
Xprint F.A.Q. Document revision 10 (16.09.2008) N. Graphical Administration Interface (Mercator) N.1 Missing libraries at Mercator start The start of Mercator V6 displays sometimes error messages of the form dynamic linker: mais: can't find libCstd.so.1 or libCrun.so.1 file is missing at mercator start Actually, Xprint 6.
PAGE 60
Xprint F.A.Q. Document revision 10 (16.09.2008) O. Wprint O.1 Controlling printer access for Wprint User. The owners of Wprint print jobs cannot be defined as Xprint users. If you attach an access list to a Xprint device, the Wprint job submission requests for this device will be rejected. A work around can be to configure the gateways to allow only certain windows PCs to submit requests. This can be done by the option -oh of the partner gateway definition.
PAGE 61
Xprint F.A.Q. Document revision 10 (16.09.2008) P. WebPrint P.1 HTTP error 403, you are not authorized to view this page If your Web server is misconfigured, you can get this HTTP error message when you try to access the WebPrint PrinterList or JobList pages. For example with an Apache Web server, you must be sure that the sections Alias and ScriptAlias of the Apache configuration file srm.conf are correctly defined and that the directories of the WebPrint binaries are specified in the file access.
PAGE 62
Xprint F.A.Q. Document revision 10 (16.09.2008) The solution is to create a new User for the Webserver and change the User and Group in the httpd.
PAGE 63
Xprint F.A.Q. Document revision 10 (16.09.2008) Q. Diagnose Q.1 How to grant access to Xprint log files to a specific group Issue the command xpgrant. - xpgrant – without parameters, the log files & debug files are made readable/writable to any user. - xpgrant - with the groupid parameter, every user belonging to the specified group will have the read/write permissions on Xprint’s log & debug files.
PAGE 64
Xprint F.A.Q. Q.3 Document revision 10 (16.09.2008) How to make the difference between Xprint & system error messages? The system errors are always preceeded by “errno”. Q.4 How to get debugging for the DMG Server The file $APACHE_HOME/logs/error_log contains all the errors encountered by the Apache web server. It is necessary to purge this file from time to time. Q.
PAGE 65
Xprint F.A.Q. Document revision 10 (16.09.2008) On Unix/Linux - PROC_DBG=YES export PROC_DBG Start Xprint normally On Windows - Go to the properties of the “My computer” icon and click on the “Advanced” tab, there click on the button “Environment variable”. Create PROC_DBG in the system list and start Xprint normally. On all the platforms - xpstart –dg DBG_CL_SIM You will need to restart Xprint whatever method you have chosen. The file $XPRINT_HOME/RP/Xprint.dbg contains the debugging information.
PAGE 66
Xprint F.A.Q. Document revision 10 (16.09.2008) Go to the properties of the “My computer” icon and click on the “Advanced” tab, there click on the button “Environment variable”. Create DIST _DBG in the system list. Restart the DMG_Distributor service. All the debug information is written in $DMGRelay_HOME/Xp_Distributor.dbg. Q.8 How to get debugging for the DMG Relay – callback collector Create the file Xp_Collector.dbg in the directory $DMG_COLLECTOR_HOME/ - Q.9 touch Xp_Collector.
PAGE 67
Xprint F.A.Q. Document revision 10 (16.09.2008) - Track the processing Create the following file: /tmp/.xpexpimpdata.log using the touch command. Xpexpimpdata will write information about the processing into that file. - To get a deeper level of diagnosis information (set –x output) Create the following file: /tmp/.xpexpimpdata.debug using the touch command. Xpempimpdata will write complete information about the processing and the commands that are executed into that file.
PAGE 68
Xprint F.A.Q. Document revision 10 (16.09.2008) find . -name "*.dbg" -print | cpio -ocvBd > < /tmp/Xpdbg 4. Xprint configuration In /var/spool/Xprint/goodies/tools, there is a script xpdbls. Execute this script, and redirect the output in a file: /var/Xprint/goodies/tools/xpdbls > /tmp/Xprint.
PAGE 69
Xprint F.A.Q. Document revision 10 (16.09.2008) R. Installation – DMG R.1 What are the different architectural possibilities about the DMG components installation? The DMG components are independent and may be installed on separate machines. They are splitted over three installation packages.
PAGE 70
Xprint F.A.Q. R.2 Document revision 10 (16.09.2008) How can I bind the DMG components? As the DMG components can be installed on separate machine, you will need to bind them yourself. The DMG components may be considered as a chain and each component is a link of that chain. To build that chain, you have to configure a special Xprint loadable resource. This LRS can be easily created thanks to specific tools delivered along with Xprint 8.
PAGE 71
Xprint F.A.Q. Document revision 10 (16.09.2008) Here is a list of configuration changes you should do before using the DMG Interface - Authorizing popup windows for the DMG Interface Click on Tools -> Options -> Web features, click on the button labelled “Allowed site” in front of the “Block popup Windows” option and add the address of the DMG Interface. - Bypassing your proxy server to logon to the DMG Interface. To bypass your proxy server, click on Tools -> Options -> General -> Connexion Settings.
PAGE 72
Xprint F.A.Q. Document revision 10 (16.09.2008) S. DMG benchmark S.1 What can I expect from the DMG in terms of performance? A series of tests has been realized on several platforms in order to measure the rapidity of the DMG components. Xprint and all the DMG components were installed on the same machine. This benchmark involves these platforms with these hardware characteristics.
PAGE 73
Xprint F.A.Q. Document revision 10 (16.09.2008) Here are the test results Machine Spoolin Time hh:mm:ss.cc Spoolout Time hh:mm:ss.cc Aix 00:00:40.94 00:01:05.23 Linux 00:00:08.57 00:00:15.43 Solaris 00:00:15.81 00:00:26.
PAGE 74
Xprint F.A.Q. Document revision 10 (16.09.2008) T. Xprint Environment Variables T.1 What are the available Xprint environment variables that can be used to tune the system ? XP_DESTIN Context: official and documented interface from Xprint 1.2A / Spool 4.
PAGE 75
Xprint F.A.Q. Document revision 10 (16.09.2008) Description: specifies the maximum time in seconds spent on flushing data returned by a LAN printer when closing the connection. The variable was supported in the function taclan_disconnect(). As this function is no longer called in the recent versions of Xprint, the variable is no longer supported.
PAGE 76
Xprint F.A.Q. Document revision 10 (16.09.2008) Behaviour if unspecified: The default value is 20 seconds. Reference: not documented seeing that only for specific needs (turnaround, ...) XPSP_DBCHECK Context: documented variable introduced in Xprint 6.0A Description: specifies if the startup of Xprint should test the DB consistency in any case or never (value “NO”). Initialisation time: before xpstart Possible values: “NO” means never checks the DB, other value means checks at each startup.
PAGE 77
Xprint F.A.Q. Document revision 10 (16.09.2008) Behaviour if unspecified: /var/spool/Xprint/config is used Reference: LANG Context: Official and documented Description: This variable is used in union with the NLSPATH environment variable. This variable specifies the language in which the Xprint messages must appear to the user. Initialisation Time: This variable could be set at any time.
PAGE 78
Xprint F.A.Q. Document revision 10 (16.09.2008) This behaviour have been described in the Xprint V05.0A00 release note. Reference: DBG_XPPOLL Context: Present since Xprint version 4.1 and not documented Description: The set of this environment variable will engage the debugging mechanism in the different calling entities when executing xppoll command. Initialisation Time: Before executing xppoll command.
PAGE 79
Xprint F.A.Q. Document revision 10 (16.09.2008) Initialisation time: before xpadd -job, before xpstart so that the supervisor has access to the information Possible values: full path name including the name of an equivalent mount command Behaviour if unspecified: the standard mount command with its path Reference: xpadd -job -de in Xprint Reference Manual XP_STOP_FAST Context: Introduced in Sispl start/stop to reduce the Xprint shutdown at shutdown host time.
PAGE 80
Xprint F.A.Q. Document revision 10 (16.09.2008) Reference: None XP_SHOW_PERMANENT_ID Context: Introduced in V7.0A to show the new permanent job identifier at job submission. Description: If set, the client receives a permanent job identifier instead of a local job alias when a xpadd, xpdel and xpmod are submitted. Initialisation time: before xpadd -job, xpmod -job or xpdel -job Possible values: Any value other than 1 disables this functionnality.
PAGE 81
Xprint F.A.Q. T.2 Document revision 10 (16.09.2008) Mercator Environment Variables XPSP_MERCATOR_NBDISP Context: official and documented interface from Xprint 6.
PAGE 82
Xprint F.A.Q. Document revision 10 (16.09.2008) U. Xprint migration aspects U.1 Are there different migration scenarios for upgrades from Xprint 5.2 to 6.0 to 7.0 to 8.0 ? No, there is no difference. The migration aspects between the version 5.2 and a higher version are detailed in the Xprint release note in sections 8.4.1 and 8.4.2 There is only one exception on windows platforms. Here are the steps to follow when migrating from Xprint 5.2 to Xprint 8 on Windows - Backup of DB.
PAGE 83
Xprint F.A.Q. Document revision 10 (16.09.2008) V. Extended options V.1 What are the available extended options ? The table below lists all the extended options that are used for both tunning/internal purposes. Xprint extended option name XP_FORCE_PRINTING Xprint object JOB XP_FORCE_SILENT_PRINTING JOB Description Used in multi-document jobs to ignore missing documents. Without this option, a job is put in state SUSPEND if a data file is not available at printing time.
PAGE 84
Xprint F.A.Q. GUISRV_PATH DISTRIBUTOR_HOST Document revision 10 (16.09.
PAGE 85
Xprint F.A.Q. Document revision 10 (16.09.2008) W. Useful links to get support UNIX Sun http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/patch-access Win http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/patch-access HP Packages libraries http://hpux.cs.utah.edu/hppd/ Support http://www.hp.com/country/us/en/support.html?pageDisplay=support AIX http://www.ibm.com/support/us/ Linux Suse https://portal.suse.com/PM/page/login.pm?portal_language=en Redhat https://www.redhat.
PAGE 86
Xprint F.A.Q. Document revision 10 (16.09.2008) X. Useful hints X.1 How can I search for a string in the DMG window using a Firefox Web browser ? Hit simultenaously the control key and the letter “f” (CTRL/f). This will give you the possibility to enter the text you are looking for with a few search options. This feature is available in any firefox window X.2 How can I change the text size in the DMG window using a Firefox Web browser ? Hit simultenaously the control key and the key “+” (CTRL/+).
PAGE 87
Xprint F.A.Q. Document revision 10 (16.09.
PAGE 88
Xprint F.A.Q. Document revision 10 (16.09.2008) Y. Limitations and restrictions Please have a look at the following sections of the manuals: - Section 10 of the Xprint release note Section 9 of the DMG Server release note Sections 4.3.2 and 7.5.
PAGE 89
Xprint F.A.Q. Document revision 10 (16.09.2008) Z. Operating systems tips Z.1 How to create, modify or delete a windows service ? To manage the windows services, you can use the command sc.exe which is available on each Windows system. The following example creates a service named 'newservice' on the local computer as an auto-start service. It has dependencies on the Xprint service. Note that you must add quotes around the list of space-separated dependencies.