Overview
Q1 - Does my AX3000 Support AS400/5250
Connections?
The Axel Thin
Client offers both session connection (tn5250 protocol) and printer
connection (Prt5250 and LPD protocols).
To connect to an AS/400 the AX3000 must contain 5250 emulation
firmware. This emulation is available as a standard feature with most
of AX3000 models. If not, the thin client must be upgrade with a
firmware including the I52 option..
Q2 - How to Change the Keyboard Type (PC or
AS/400)?
The AX3000 supports both a 5250 (122 keys) and a PC/AT keyboard
(102/105 keys). The keyboard type is not auto-detected. So the keyboard
type must be specified through the AX3000 Set-Up.
If the AX3000 setting is not consistent (a PC keyboard is attached but
a 5250 keyboard is declared, or vice versa), the keyboard won’t work. A
specific keystroke allows to dynamically modify the keyboard type.
This keystroke is <Ctrl><Alt><K>
with a PC keyboard, and <Rest><Alt><K>
with a 5250 keyboard.
Q3 - Using the 5250 Keyboard or the PC/AT
Keyboard
Q4 - Giving a Name to a Screen Session
As with an SNA terminal, a name can be associated with an AX3000
session. This name is negotiated by the AX3000 at the connection time.
Note:
a unique name must be given to each session.
To associate a name with a session, enter the AX3000 Set-Up, select
[Configuration]-[Sessions]-[Session X]. Within the displayed box, set
the "Terminal Name (DEVNAME)" parameter.
If this name is left blank, a dynamic name will be given by the AS/400
(QPADEVxxx)
This modification will take effect at the next AX3000 connection (the
current AX3000 session can be closed by pressing <Ctrl><Alt><D>
or the AX3000 can be shutdown by pressing <Ctrl><Alt><Del>)
Q5 - Using
<Memor> and <Exec> with a PC
Keyboard?
The Axel 5250 emulation allows function keys to be programmed. For
example a series of keystrokes can be recorded and played back by
pressing a single key. The recorded data is stored in non-volatile
memory so is not affected by switching off.
Recorded keystrokes can be assigned to any of the 24 function keys
(<F1> to <F12> or
<Shift><F1> to
<Shift><F12>).
Reminder: on a PC keyboard, <Alt Gr><F4>
and <Alt Gr><F5> are the
<Memor> and <Exec> keys of a 5250 keyboard.
Programming a
Function Key
To record a series of keystrokes proceed as follows:
- press <Alt Gr><F4>
to set the record mode,
- press any one of the 24 function keys to which
you want to assign the sequence,
- type the key sequence you want to record,
- press <Alt Gr><F4>
to exit the record mode.
Note:
for each session there is a maximum of 1500 keystrokes
recordable. Each individual function key has a maximum 256
keystrokes recordable.
Processing a
key sequence
To execute a series of keystrokes that have been recorded:
- press <Alt Gr><F5>
to set the Process mode,
- press the recorded function key,
- the key sequence is processed.
Deleting a
Recorded Function Key
To delete a series of keystrokes proceed as follows:
- press <Alt Gr><F4>
to set the record mode,
- press any one of the 24 function keys to which
you want to delete,
- press <Alt Gr><F4>
to exit the record mode.
Q6 - How to Use the Rule Function?
The "rule" function allows the cursor to be located easily among other
characters. Three types of rules are available:
- cross: a horizontal line and a vertical line
indicate the cursor location,
- horizontal: a horizontal line is displayed at
the cursor line,
- vertical: a vertical line is displayed at the
cursor column.
Press <Alt
Gr><F12> to enable/disable the rule
function from a 5250 session..
Printer Sessions
I1 - How to Handle a Thin Client's Printer?
Two
printer protocols are available: LPD or Prt5250.
Normally the Prt5250 protocol is preferred. (No printer declaration is
needed at OS/400 level), but the LPD protocol allows the printer to be
shared between different operating systems.
The PRT5250
Protocol
The PRT5250 protocol (RFC 2877) is OS/400 oriented. We strongly
recommend using this PRT5250 protocol.
A printer controlled by Prt5250 is seen a real Printer Device. (related
command: CHGDEVPRT).
When the AX3000 is powered up, the AX3000 auxiliary ports associated
with the PRT5250 protocol are automatically connected to the AS/400
through a telnet PRT5250 session. Then, the information of each
auxiliary port (with the AX3000 Set-Up) is sent to the AS/400. The
related printers are automatically created and enabled (no need to use
the CHGDEVPRT command). A PRT5250 remains established until the AX3000
is powered-off.
For more information about the PRT5250 protocol, see next FAQ
.
The LPD
protocol
This protocol (RFCs 1048 and related) is provided as a standard feature
by major operating systems (Unix/Linux, NT, etc.). The main benefit of
this protocol is an LPD printer can be shared by different operating
systems. But LPD restrictions are:
- the printer must be manually added to OS/400,
- the printer is accessed through an outqueue (and
not a device),
- the printer job manipulation is not fully
supported.
A printer controlled by LPD is seen as an OUTQUEUE (related command:
CHGOUTQ).
The AS/400 host establishes an LPD connection when a print job is sent
to the associated OUTQUEUE. This connection is closed when the print
job is completed. The disconnection releases the printer. Then this
printer is available for other servers.
For more information about the LPD protocol, see next FAQ I6.
I2 - Setting-Up a Printer with the PRT5250
Protocol
Enter the AX3000 Set-Up and select [Configuration]-[Ports]-[xxx]-[yyy].
In the displayed box, set the "Associated
Service" to "Prt5250", then select "Net Service Parameters" and press
<Space>.
The displayed box allows the Prt5250 protocol to
be customized . The following
parameters must be set:
- Host: the hostname to which
the AX3000 opens a printer connection (press
<space> to get a list of available hosts).
- Advanced: access to a group
of parameters. The default values of these parameters
are suitable for most of the use.
- Printer Name (DEVNAME):
printer device name. This
name must be
unique
- Queue for Writer Messages (MSGQNAME): Message
queue name to which the printer messages will be sent.
Default value: QSYSOPR
- MSGQNAME Library (MSGQLIB): Associate
message queue library.
Default value: *LIBL
- Font Identifier (FONT): Font
number (3, 4 or 5 digits).
Default value: 011
- Host Print Transform (TRANSFORM): This
parameter is not available. its value is always 'yes'.
- Manufacturer Type and Model (MFRTYPMDL): Enter
the printer driver name (ex: *NONE, *HP4, *NECP2...).
Default value: *NONE
- Paper Source 1 (PPRSRC1): Selected
through list.
Default value: *MFRTYPMDL
- Paper Source 2 (PPRSRC2): Selected
through list.
Default value: *NONE
- Envelope hopper (ENVELOPE): Describes
the paper source 3 (selection through list).
Default value: *NONE
- ASCII 899 support (ASCII899): Specifies
if the code page ASCII 899 is supported by the printer.
Default value: *NO
- WSCST name (WSCSTNAME):
Qualified name of the customising object.
- WSCST library (WSCSTLIB): Associated
library.
Note: when a new
printer device is created, the Prt5250 connection is immediately
established when the set-up is exited. But, when
an
existing printer device is modified, the modifications will take effect
after
the current printer session disconnection (enter the
AX3000 set-up and
select [Diagnostics]-[Connection
State]-[Close])
of after the AX3000 is shutdown
(use
<Ctrl><Alt><Del>). .
I3 - Understanding the "Manufacturer Type and
Model" Option
Whatever the selected printer protocol (Prt5250 or LPD), the printer is
considered by OS/400 as an "OUTQUEUE type 3812" with the "Host Print
Transform (TRANSFORM)" mode enabled.
The printer is handled by the AS/400 with the information given either
by the PRT5250 protocol, either by the CHGOUTQ with the LPD protocol.
When the "Host Print Transform (TRANSFORM)" parameter is set to "YES",
the AS/400 converts EBCDIC characters of the printer flow into ASCII
characters. But sometimes this basic operation is not enough for a
enhanced print function (attributes, fonts, etc.). Another parameter,
"Manufacturer Type and Model" (MFRTYPMDL) allows to specify the printer
driver.
A printer driver list is provided as a standard feature. But
when it's required, a customized driver can be created (see next FAQ).
To know what is the printer driver advised by IBM, we strongly
recommend to visit this site where printer manufacture are listed:
http://www-01.ibm.com/support/docview.wss?uid=nas8N1019605
I4 - Connecting Specific Printers
(industrial, barcode, etc.)
Most
industrial printers use a language specifically designed by the
manufacturer. In this case no printer driver is used. Printer commands
are sent directly
We advise to use one of the two following settings:
Manufacturer type and Model (MFRTYPMDL): *NONE"
WCST name (WSCSTNAME) :
WCST library (WSCSTLIB) :
or
Manufacturer type and Model (MFRTYPMDL) : *WSCST
WCST name (WSCSTNAME) :QWPDEFAULT
WCST library (WSCSTLIB) : *LIBL
I5 - How to Create a Printer Driver
Various printer drivers are provided by the OS/400
– covering most requirements.
However the printer driver can be customized if
required. This is
done by the RTVWSCST and CRTWSCST commands. For more information, see
the IBM Manual "Printer Device Programming" ref.: SC41-5713-03
This method has the benefit of modifying an
existing driver to suite your requirements.
Example: using *HP4 to create HP4WSCST:
- Extracting the source code of the existing
driver:
===>
RTVWSCST DEVTYPE(*TRANSFORM) MFRTYPMDL(*HP4) SRCMBR(HP4WSCST)
SRCFILE(MYLIB/QTXTSRC) |
- Customizing the driver source code:
===>
STRSEU SRCFILE(MYLIB/QTXTSRC) SRCMBR(HP4WSCST) |
- Creating a WSCST object:
===>
CRTWSCST WSCST(MYLIB/MYHP4) SRCMBR(HP4WSCST) SRCFILE(MYLIB/QTXTSRC) |
- Modifying the AX3000 settings :
- Enter the AX3000 Set-Up
- Select [Configuration]-[Ports
aux.]-[xxx].
- Within the dialog box set "Associated Service" to
"none" then select "Net
Service Parameters" and press <Space>
- The displayed box allows the Prt5250
service to be customized: The following list the parameters to set in
regard of the created printer driver :
-
Manufacturer Type and Model (MFRTYPMDL) .
: *WSCST
- WCST Name (WSCSTNAME) . . . . . . . . .
. : HP4WSCST
- WCST Library (WSCSTLIB) . . . . . . . .
. : MYLIB |
.
I6 - Setting-Up a Printer with the LPD
Protocol
Note:
If the printer
is accessed by a
single AS/400, we recommend using the PRT5250 protocol.
An LPD printer is set both at the AX3000 level and
at the
OS/400 level.
AX3000 Level
An LPD printer can be configured with 3 parameters:
- an IP address (the AX3000’s IP address),
- an identifier for the auxiliary port
(character string),
- an optional filter to pre-process the
file before
printing (but generally this processing is done at the operating system
level).
Enter the AX3000 Set-Up and select [Configuration]-[Aux.
Ports]-[xxx]. In the displayed box, set the "Associated
Service" to "LPD", then select "Net Service Parameters" and press
<Space>.
The displayed box allows to customize the LPD
protocol. The following
parameters must be set:
- Printer Port Name:
It's the OS/400 RMTPRTQ name (Uppercase
letters are required)
- NL=CR+NL Filter:
Always No
- Auto Form Feed:
Always No
OS/400 Level
Note: only an OUTQUEUE can be created but we
advise to create first a Printer DEVICE.
(The device itself will not be used, only its OUTQUEUE will be used).
Printer Device Creation (the DEVD parameter is the
printer,
other parameter value are always the same).
===> CRTDEVPRT DEVD(AXPRT01)
DEVCLS(*VRT) TYPE(3812) MODEL(1) FONT(11) |
Outqueue Modification (to associate it with the
AX3000
auxiliary port):
===> CHGOUTQ OUTQ(AXPRT01)
RMTSYS(*INTNETADR) RMTPRTQ('PARALLEL') CNNTYPE(*IP) DESTTYPE(*OTHER)
TRANSFORM(*YES) MFRTYPMDL(*NECP2) INTNETADR('192.168.1.240') |
Where:
- AXPRT01 :
Outqueue name (same as printer device name)
- PARALLEL :
It's the AX3000 "Printer Port Name".
Uppercase letters are required.
- *NECP2 :
Manufacturer type and model (here a NEC type
P2)
Attention: this name
must be an existing entry within the OS/400 driver list.
- 192.168.1.240 :
AX3000 IP address.
The run the following command to start the
outqueue:
===> STRRMTWTR OUTQ(AXPRT01) |
Miscalleneous
M1 - Editing a TCP/IP Trace on AS/400
There is an OS/400 utility allows the network
traffic between the AS/400 and a specific AX3000 to be recorded
and the resultant TCP/IP trace emailed to Axel for investigation.
1 - Before running the trace
From an AX3000, be ready to run the application
you want to
trace.
2 - Running the trace
- From another terminal, log on as QSECOFR
and invoke the following:
- Start the service:
- Select the following command:
3. Work with communications trace |
- Start the trace:
- Within the displayed menu, modify the following
parameters (to find the name of TCP/IP line, invoke: cfgtcp, then
option 1. Work with TCP/IP interface):
Configuration object . . . . .
name of the TCP/IP line
Buffer size . . . . . . . . . 4
Number of bytes to trace
Beginning bytes . . . . . . *MAX |
- Select the use of a filter
- Enter the IP address of the spied Platine
Remote IP
address . . . . . . xxx.xxx.xxx.xxx |
Then on the AX3000, run the software you want to
trace.
3 - Stopping and editing the trace
- Stop the trace:
- Format and edit the trace:
- Enter the following information:
Controller . . . . . . . . . . *ALL
Data representation. . . . . . 3
Format RR, RNR commands . . . N
Format Broadcast data . . . . N
Format UI data only . . . . . N
Format SNA data only. . . . . N
Format TCP/IP data only . . . Y
Format IPX data only. . . . . N
Select Ethernet data. . . . . 3 |
- And...
IP address . . . . . . . . . . *ALL
IP address . . . . . . . . . . *ALL
Port . . . . . . . . . . . . . *ALL |
The trace is now edited. From a Windows box
running "Client
Access", transfer the spool file and send it by email to
our support department.
M2 - How to Connect a Serial Device (scanner,
scales, etc....)?
A bidirectional serial device (scanner, scales, etc.) can be connected
to either AUX1 or AUX2.
1 - Receiving
Data sent by the serial device
Data sent by the serial device is put into the thin client keyboard
buffer in order to emulate keyboard data entry.
As the AS/400 uses an EBCDIC character set and most serial devices use
an ASCII character set, the EBCDIC to ASCII converter has to be enabled
within the Axel
thin client .
To set-up this functionality perform the following:
- Enter the AX3000 Set-Up
- Select
[Configuration]-[Terminal]-[Miscellaneous] and set "Default Port" to
"AUX1" or "AUX2"
- Select [Configuration]-[Ports]-[Ports
aux.]-[AUXx] and
- set "Network Service" to "none"
- set "Operating Mode" to "ASCII to EBCDIC".
- set the communication parameters (baudrate, format, handshake, etc.).
2 - Sending
Data to the Serial Device (if required)
This functionality allows a command to be sent to the serial device
(for example requesting weight from scales).
To set-up this functionality perform the following:
- Enter the AX3000 Set-Up
- Select the auxiliary port previously set
as "ASCII to
EBCDIC"
- Set
"Aux. Sequencet" to the required ASCII string.
Pressing <Alt Gr><F2> will send this ASCII
string to the serial device.
M3 - Transparent Mode: Sending ASCII Data to
Session
his function allows developers to send ASCII data
from RPG programs to AX3000 auxiliary ports or screen session.
1 - Setting a Screen Session
Enter the AX3000 Set-Up and select [Configuration]-[Sessions]-[Session
X] then [Addtional
Parameters]
//
Transparent
mode :
yes
On/off ASCII
sequence : .
. . .
// |
Enable the transparent
mode and select the transparent sequence (default value: @%@)
2
- Setting a Printer Session
Enter the AX3000 Set-Up
and select [Configuration]-[Ports]-[Auxiliary
Ports]-[xxx] then [Enhanced
parameters]
//
Transparent
Mode :
yes
On/off ASCII sequence : .
. . .
// |
Enable the transparent
mode and select the transparent sequence (default value: @%@)
3 - How to use
* For a screen session,
enable the transparent mode by sending the transparent sequence (seq)
followed by a resource number:
- Seq 0 ->
addressing the default auxiliary port
- Seq 1 ->
addressing AUX1.
- Seq 2 ->
addressing AUX2.
- Seq 3 ->
addressing the parallel port.
* For a printer session,
send only the transparent sequence to enable the transparent mode
* In both case, the
transparent mode is disabled when the transparent sequence is sent a
second time.
* The character
remapping is based on PC850 ASCII table (as with the ASCII to
EBCDIC function).
* The '/' character is
used to code an ASCII hexadecimal code. A '/' must be followed by two
characters (between 0 and F).
* To send a '/', send the
related hexadecimal ASCII code (/2F).
* Both transparent mode
and "ASCII to EBCDIC" function can be used.
4 - Examples
Transparent sequence is @%@
1) Screen session data flow:
data received by the thin client:
@%@1/1Bat/2F@%@ (446C44F161F1C281A361F2C6446C44)
data send to the AUX1 port: <ESC>at/
(1B61742F)
2) Printer session data flow :
data received by the thin client:
@%@/1Bat/2F@%@ (446C44 61F1C281A361F2C6446C44)
data send to the printer: <ESC>at/ (1B61742F)
M4 - IBM API Socket: Addressing Auxiliary
Ports through an RPG Program
The serial and parallel ports can be addressed by an RPG program. This
is done via the IBM API
socket. This API is
provided as a standard feature of OS/400.
The scenario is the following. A TCP/IP port is associated with an
auxiliary port of the Axel thin client. The RPG program opens a
connection to the Axel thin
client (using AX3000 IP
address and this TCP/IP port). When the connection is established, a
pipe (i.e socket) is available. Data can be read from (or written to)
this pipe.
1 - Setting
the Axel thin client
Enter the thin client
Set-Up and select [Configuration]-[Ports]-[xxx]-[yyy]. Set "Associated
service" to "rtty". Then select "Net Service Parameters" and press
<Space>. Modify "TCP port" value if required (default
value is 2048).
2 - Using the
API Socket
Documentation had been published by IBM. <Click here>.
Contact Axel for a sample RPG program.
Troubleshooting
P1 - In Event of Problems with PRT5250
Printing...
If a problem occurs when the 5250 printer is established an error code
is sent to the thin
client .
To establish why a Prt5250 session has been refused, enter the thin
client Set-Up and select the menu [Diagnostics]-[Connections].
Within the displayed dialog box, select the REFRESH button and press
<CR>. Read the information displayed for the printer
printer port. Note the error code at the end of the line:
- If no
information is displayed, double-check that the auxiliary port is
correctly set
- When the
connection status continually cycles through CLOSED to CONNECT and
there is no error number displayed at the end of the line, the device
name is already used by another connection.
- If
the Prt5250 connection status is ";Connected" and if the error code is:
- I902: at the AS/400
level, the printer is correctly set and ready (this can be checked by
the WRKWTR command). If the printer problem remains, check using
following method that the AX3000 is able to send data to the printer:
enter the AX3000 Set-Up, select [Configuration]-[Aux. Ports]-[xxx].
Within the displayed box, select the [TEST] button. A test printer
banner should be printed.
- Whatever the
Prt5250 connection status, check the error code value. These are the
main values (all possible errors are listed in the RFC 2877):
- 8902 / 8903 (Device
not available / Device not valid for session): the printer
name is used for another connection.
- 8925 (Creation of
device failed : during the printer creation operation, at least one
parameter is detected wrong (ex.: non-existing printer model).
- 8928 (Change of
device failed): during the printer modification operation (reconnection
with different parameters), at least one parameter is detected wrong
(ex.: non-existing printer model).
- 8930
(Message queue does not exist): the message queue or its library
doesn't exist.
- 8940
(Automatic configuration failed or not allowed): the "QAUTOVRT" value
is not correct. To modify it enter the following command:
===>
CFGTCPTELN
Option
10 . Autoconfigure Virtual Devices
Note: in event of
problem use the *NOMAX value
- AX01 (Terminal type
not recognized) : the TERM variable (by default IBM-3812-1) associated
with the thin
client printer port is
not correct.
P2 - Disconnection Problems with OS V5R1,
V5R2 and V5R3
Screen or printer sessions may be suddenly disconnected when running an
OS V5.x
This issued is fixed by the following PTFs:
- V5R1: PTF MF34316
- V5R2: PTF MF34380
- V5R3: PTF MF34559
We advise to apply the related PTF in any case.
P3 - Reconnection Problems with OS V5R4
For V5R4, if power is cut or if the terminal is switched off without
using the Ctrl-Alt-Del keystroke combination it may be impossible to
reconnect to the session. This problem may also be experienced if the
terminal is switched off from the sign-on screen.
This issued is fixed by the cumulative PTFs: SF99315
We advise to apply the related PTF in any case.
If you haven't found your answer here
please try the General FAQ
page
|