AVM HP 3000 User manual

PAGE 1 / 12
GLOBALCOMSERVER
HP 3000 GATEWAY
ADMINISTRATOR/USER MANUAL
©OCTOBER 2002 AVM INFORMATIQUE
(UPDATED:AUGUST 22, 2006))

PAGE 2 / 12 LICENSE
AVM – Documentation [phone] [e-mail]
22-Aug-06 Fax [phone]
LICENSE
Information in this document is subject to change without notice.
This document cannot be reproduced in any ways without AVM Informatique written
authorization.
GlobalComServer is an AVM Informatique product.
GlobalComServer is protected by copyrights.
All products mentioned in this manual are trademarks of their respective owners.

PAGE 3 / 12 TABLE OF CONTENTS
AVM – Documentation [phone] [e-mail]
22-Aug-06 Fax [phone]
TABLE OF CONTENTS
Check our web site for updates:
http://www.avm-informatique.com/
LICENSE........................................................................................................................................2
TABLE OF CONTENTS ................................................................................................................3
PRESENTATION...........................................................................................................................4
Architecture..................................................................................................................................4
PRE-REQUIREMENTS .................................................................................................................5
On the GCS platform ...................................................................................................................5
INSTALLATION.............................................................................................................................6
GlobalComServer installation on PC...........................................................................................6
PSPOSR installation on HP3000 ................................................................................................6
Installation............................................................................................................................6
Starting PSPOSR .........................................................................................................................6
How it works.................................................................................................................................6
Stopping PSPOSR .......................................................................................................................7
CREATING A SPOOL FILE..........................................................................................................8
Including the transmission parameters in a SPOOL-PCL file.................................................8
The overlay 500............................................................................................................................8
Other available parameters.........................................................................................................8
Using a cover page (different than default) .........................................................................8
Using specific options..........................................................................................................8
Notion of user to obtain follow-up files.................................................................................8
Using a key..........................................................................................................................8
Using a subject....................................................................................................................9
Using a second subject .......................................................................................................9
Using a third subject............................................................................................................9
Using an OpenDesk address to send back the GCS message report to............................9
Using a company name.......................................................................................................9
COBOL program sample to create an overlay..........................................................................9
In the section “working storage” ..........................................................................................9
In the section “division”........................................................................................................9
Criterion to select Spool-PCL files...........................................................................................10
GCS MESSAGE FOLLOW-UP (SUIFXS)...................................................................................11
Principle......................................................................................................................................11
How to use it...............................................................................................................................11
Necessary files...........................................................................................................................11
INSTALLATION FILES ...............................................................................................................12

PAGE 4 / 12 PRESENTATION
AVM – Documentation [phone] [e-mail]
22-Aug-06 Fax [phone]
PRESENTATION
An HP3000 application prints into a spool file that has a special name (avmfax).
The spool file must contain an overlay 500 in which are the 4 following sending parameters:
- GCS address
- Recipient’s name
- Sender’s name
- GCS message subject
Architecture
HP3000
GlobalComServer
Print queue
daemon
Reflection®
Network
lo
g
book E-mail
Notifications /
follow-u
p

PAGE 5 / 12 PRE-REQUIREMENTS
AVM – Documentation [phone] [e-mail]
22-Aug-06 Fax [phone]
PRE-REQUIREMENTS
We advise you to be assisted by an HP3000 administrator to install the product:
-To authorize new logins (HELLO MGR.TRAFIC and HELLO PSPOSR.TRAFIC)
-To install Reflection® and to test file transfer
On the GCS platform
Reflection® (version 5.10 minimum required), for Windows®, must be installed on the GCS
platform.

PAGE 6 / 12 INSTALLATION
AVM – Documentation [phone] [e-mail]
22-Aug-06 Fax [phone]
INSTALLATION
GlobalComServer installation on PC
Install the GCS platform from GlobalComServer CD-ROM
(See GlobalComServer manual)
Choose the GlobalComServer option.
After installation, you need to perform the following operations:
-Copy the file ..\Trafic$\System32\Suitpc.exe in the directory ..\Trafic$
-Create a sub directory \HP3000 in ..\Trafic
-In the file ..\Trafic\Admin.mdb, modify the line HP3000 by replacing the 2
alphabetical characters identifier (automatically created) by the 2 numeric characters 00.
PSPOSR installation on HP3000
Installation
-Create the account TRAFIC
-Create the group PCL.TRAFIC
-Restore the files from the CD-rom in the group PUB.TRAFIC
-Create the user PSPOSR when logged as MGR.TRAFIC
-Catalog UPSPOSR UDC for the user PSPOSR by typing
SETCATALOG UPSPOSR.USER=PSPOSR
After installation has succeeded, please make sure that the following files are on the HP3000:
PSPOSR : spool file interface program (restored)
PARMPCL : parameter file (created)
UPSPOSR : UDC file (restored)
TUSPOS : program to stop PSPOSR (restored)
Starting PSPOSR
On the GCS platform, with Reflection®, connect to the HP3000 then type:
HELLO PSPOSR.TRAFIC
How it works
In the PSPOSR.TRAFIC session the PSPOSR program do the following operations:
-Searches for the spool files named AVMFAX
-Opens these files and finds the sending parameters
-Creates a file named Pxxx from the spool file without the spool codes (in Pcl format)
-Creates an Hxxx file which contains the sending parameters
-Transfers those 2 files (using Reflection ®) to the GCS platform
-Purges the processed spool files.
The alphanumeric counter for the Pxxx and Hxxx files is located in the FCOMPT file (file created
by PSPOSR).

PAGE 7 / 12 INSTALLATION
AVM – Documentation [phone] [e-mail]
22-Aug-06 Fax [phone]
Stopping PSPOSR
To stop correctly the PSPOSR.TRAFIC session (if you are connected in Trafic account), type:
RUN TUSPOS.PUB.TRAFIC
From an other account, type:
FILE STOPSPOS.PUB=STOPSPOS.PUB.TRAFIC
RUN TUSPOS

PAGE 8 / 12 CREATING A SPOOL FILE
AVM – Documentation [phone] [e-mail]
22-Aug-06 Fax [phone]
CREATING A SPOOL FILE
Including the transmission parameters in a SPOOL-PCL file
The parameters are:
-The GCS address
-The recipient’s name
-The sender’s name
-The GCS message subject
Only the first three parameters appear on the GCS message cover page.
The four parameters must be contained in a non-editable overlay.
In order to locate this overlay easily, it should be placed as close as possible to the beginning of
the file.
One SPOOL-PCL file = one GCS message.
The overlay 500
The seven following fields are required in the overlay:
Esc&f0500Y
Esc&f0X
GCS address (100 characters max.)
it contains the fax number (for example 33472399169)
or the e-mail adress beginning with ‘SMTP:’
(for example SMTP:[e-mail])
Recipient’s name (40 characters max.)
Sender’s name (20 characters max.)
GCS message subject (40 characters max.)
Esc&f1X (Esc is the Escape character: 33 octal, 27 decimal, 1B
hexadecimal)
Other available parameters
Each parameter must be placed after the GCS message subject and must begin with a keyword.
Using a cover page (different than default)
LOGO=cover_page_name Keyword: LOGO=
Using specific options
Keyword: OPTION=
Notion of user to obtain follow-up files
Keyword: USER=
The user’s name has only two alphabetical characters. (AA, XY...)
Using a key
Keyword: KEY= (16 characters max.)

PAGE 9 / 12 CREATING A SPOOL FILE
AVM – Documentation [phone] [e-mail]
22-Aug-06 Fax [phone]
Using a subject
Keyword: /SUJET= (80 characters max.)
Using a second subject
Keyword: /SUJET1= (80 characters max.)
Using a third subject
Keyword: /SUJET2= (80 characters max.)
Using an OpenDesk address to send back the GCS message report to
Keyword: /MA= (80 characters max.)
Using a company name
Keyword: /SOC= (40 characters max.)
COBOL program sample to create an overlay
In the section “working storage”
1 WF0500Y
5 FILLER PIC X VALUE %33
5 FILLER PIC X(7) VALUE "&f0500Y"
1 WF0X
5 FILLER PIC X VALUE %33
5 FILLER PIC X(7) VALUE "&f0X"
1 WF1X
5 FILLER PIC X VALUE %33
5 FILLER PIC X(7) VALUE "&f1X"
In the section “division”
MOVE WF0500Y TO LINE
MOVE -8 TO LOUT
CALL INTRINSIC "FWRITE" USING NWLP,LINE,LOUT,\%320\
MOVE WF0X TO LINE
MOVE -5 TO LOUT
CALL INTRINSIC "FWRITE" USING NWLP,LINE,LOUT,\%320\
MOVE "GCS address" TO LINE
MOVE -20 TO LOUT
CALL INTRINSIC "FWRITE" USING NWLP,LINE,LOUT,\%320\
MOVE "recipient’s name" TO LINE
MOVE -40 TO LOUT
CALL INTRINSIC "FWRITE" USING NWLP,LINE,LOUT,\%320\
MOVE "sender’s name" TO LINE
MOVE -20 TO LOUT
CALL INTRINSIC "FWRITE" USING NWLP,LINE,LOUT,\%320\
MOVE "GCS message subject" TO LINE
MOVE -40 TO LOUT
CALL INTRINSIC "FWRITE" USING NWLP,LINE,LOUT,\%320\
MOVE WF1X TO LINE
MOVE -5 TO LOUT
CALL INTRINSIC "FWRITE" USING NWLP,LINE,LOUT,\%320\

PAGE 10 / 12 CREATING A SPOOL FILE
AVM – Documentation [phone] [e-mail]
22-Aug-06 Fax [phone]
Criterion to select Spool-PCL files
This criterion is contained in the parameter file PARMPCL.PUB.TRAFIC
A line must begin with SPOOLFAX
This keyword must be followed by the selection criterion FILEDES=AVMFAX.
The SPOOL-PCL files must be directed to a printer with a priority lower than this printer's
OUTFENCE to make sure they remain in the spool.
To be selected, the SPOOL-PCL files must have the filename AVMFAX
Example in PARMPCL
SPOOLFAX:FILEDES=AVMFAX

PAGE 11 / 12 GCS MESSAGE FOLLOW-UP (SUIFXS)
AVM – Documentation [phone] [e-mail]
22-Aug-06 Fax [phone]
GCS MESSAGE FOLLOW-UP (SUIFXS)
Principle
This SUIFXS program allows to view the file where are the GCS message status.
The name of this file is SUITPCxx.PCL.TRAFIC (xx is the user’s name).
This file comes from the GCS platform.
How to use it
Connect as MGR.TRAFIC
RUN SUIFXS
The appearing screen will ask to identify the user you want the follow-up for.
You need to use the alphanumeric user ID.
The SUIFX program reads the SUIPCxx.PCL.TRAFIC file (xx is the user’s identifier).
Then it displays on another screen the information about the status of the first GCS message
stored in the SUITPCxx.PUB.TRAFIC file.
GCS message follow-up screen
If there is an error, the status zone shows ER (error).
F1 finds again the SUITPCxx.PCL.TRAFIC file.
F5 displays the next GCS message status.
The “file” and “origin” fields show where this GCS message comes from.
Time is given as indication.
F8 exits the program.
Necessary files
XSUIFXS : logbook program.
FFFAXSRV : forms file.

PAGE 12 / 12 INSTALLATION FILES
AVM – Documentation [phone] [e-mail]
22-Aug-06 Fax [phone]
INSTALLATION FILES
Those files are located on the GlobalComServer CD-Rom in the HP3000 directory.
JIPSPOSR.PUB.SYS : installation job
ESPOFA :testprogram
PSPOSR : protocol program
UPSPOSR : PSPOSR ‘s UDC
TUSPOS : stop program
SUIFXS : status view program
FFFAXSRV : forms file
CSPOSR : program to send an editor file as a GCS message
DPSPOSR : files list
OSPOSR : forms file