SELIMP

Contents


Selimp is used to choose the printer and change some parameters upon launching the print.

Syntax

   Selimp param = id_serveur with param_list

Parameters

Element

Description

Restrictions

param

 

 

id_serveur

identification of a print server as:
machine.domain:port@

list_param

List of id_param separated by the character ','.

The expressions must be alphanumerical and are limited to 255.

Examples

Local Char PARAMETRE(250)(1..100)
Local Char SERVEUR(30)

# Example 1: without default value
Selimp PARAMETER = SERVER

# Example 2: with default value
PARAMETRE(1)="_PrinterDriver="+chr$(1)+"WINSPOOL"
PARAMETRE(2)="_PrinterName="+chr$(1)+"
HP LaserJet 4M Plus"
PARAMETRE(3)="_PrinterPort="+chr$(1)+"
\\LEONARD\HP4Mplus"
PARAMETRE(4)="_PrinterCopies="+chr$(1)+"
1"
PARAMETRE(5)="_PrinterCollate="+chr$(1)+"
0"
PARAMETRE(6)="_PrinterStartPage="+chr$(1)+"
1"
PARAMETRE(7)="_PrinterStopPage="+chr$(1)+"
10"
PARAMETRE(8)="_Orientation="+chr$(1)+"
1"
Selimp PARAMETRE = SERVEUR With PARAMETRE(1..8)

# Example 3: with default value (other writing method)
Selimp PARAMETRE = SERVEUR With
& "_PrinterDriver="+chr$(1)+"WINSPOOL
",
& "_PrinterName="+chr$(1)+"
HP LaserJet 4M Plus",
& "_PrinterPort="+chr$(1)+"
\\LEONARD\HP4Mplus",
& "_PrinterCopies="+chr$(1)+"
1",
& "_PrinterCollate="+chr$(1)+"
0",
& "_PrinterStartPage="+chr$(1)+"
1",
& "_PrinterStopPage="+chr$(1)+"
10",
& "_Orientation="+chr$(1)+"
1"

# Example 4: no display of the selection window
Selimp PARAMETRE = SERVEUR With
& "_PrinterName="+chr$(1)+"HP LaserJet 4M Plus"
,
& "_NoVisible="+chr$(1)+"
1"

Description and comments

Selimp is used to choose the printer and change some parameters upon launching the print.

The 1st parameter param contains all the parameters returned after entry by the user. (Parameters on exit)

The 2nd parameter id_server contains the name of the print server.

The 3rd parameter param_list contains the list of parameters used as default value in the entry window. (parameters on entry). The stat1 Adonix system variable will return the number of parameters on exit of the Selimp instruction.

The input/output parameters are the following:

Parameter

Description

_PrinterDriver

Name of the printer driver

_PrinterName

Printer name

_PrinterPort

Printer port

_PrinterServer

Print server

_PrinterCopies

Number of copies

_PrinterCollate

Group of pages ( 0 or 1)

_PrinterStartPage

Selection of a start print range

_PrinterStopPage

Selection of an end print range

_Orientation

Portrait or landscape ( 0 or 1)

The input parameters are the following:

Parameter

Description

_NoVisible

Used to avoid displaying the selection window of the printers (0 or 1)
It is necessary to have entered this parameter
_PrinterName

The output parameters are the following:

Parameter

Description

_PrinterDescription

DEVMODE (structure internal to Windows for the definition of printers)

Note

parametere     _PrinterServer:

The string used to identify the print server on the network contains a mandatory and an optional part (in italic below).
_PrinterServer="machine.domain:port"

For instance:
_PrinterServer="impserv.com:1969"
_PrinterServer="impserv.com"   

If the optional part is not entered, then the communication with the print server will be set up using by default the current connection port of the X3 session executing the "Selimp" instruction.

When the print server is specified, the selection window of the printers linked to the print server is sytematically displayed and the "_NoVisible" parameter is then inactive. Furthermore this parameter, if it is present, necessarily implies that the optional field "id_server" must not be filled.

In order not to display the selection window of the printers, when the user need to speak to a printer server, it is necessary
- to load the "_PrinterName" parameter,
- not to load the " _PrinterServer" parameter,
- to load the "id_server" field with the name of the print server in the form "machine.domain:port@"

Associated errors

Error

Description

 

 

Associated keywords

Stat1 - Listimp


CONTENTS

Copyright © Sage 1999 - 2007