Run IBM i Access Client Solutions

Data Transfers
on the IBM i

Craig Pelkie
[email protected]
Run IBM i Access Client Solutions Data Transfers on the IBM i
v1.01 2012-09-06 Initial version

v1.02 2012-11-12 Update for Oct. 2012 IBM release. Move VNC section to end of
document (no longer needed for initial configuration on IBM i), update several figures to
match Oct. 2012 version.

v1.03 2012-11-15 Update for Oct. 2012 IBM release. Move VNC section to end of
document (no longer needed for initial configuration on IBM i), update several figures to
match Oct. 2012 version. Revised the XFRDTAC program, XFRDTA command to include
the CLDOWNLOAD plugin option. Several updates to figures.

Copyright © 2012, Craig Pelkie, ALL RIGHTS RESERVED

Contents
About this document .................................................................................................................... 3 
PC Prerequisites .......................................................................................................................... 5 
IBM i Prerequisites ....................................................................................................................... 6 
Download and install IBM i Access Client Solutions............................................................................ 8 
Download the software .............................................................................................................. 8 
Download using the Download Director .................................................................................... 10 
Download using HTTP ........................................................................................................... 12 
Extract the downloaded files ..................................................................................................... 13 
Start the ACS program ............................................................................................................ 14 
Start using a startup program ................................................................................................ 14 
Start using a startup script .................................................................................................... 15 
Startup (startup program or startup script) .............................................................................. 15 
Run the Data Transfer with Display output .................................................................................. 16 
Run the Data Transfer with File output ....................................................................................... 18 
Save the Data Transfer download request ................................................................................... 22 
Run the Data Transfer from a command line .................................................................................. 23 
Install the IBM i Access Client Solutions program on the IBM i .......................................................... 25 
Create directories in the Root file system .................................................................................... 25 
Copy the ACS code from your workstation to the /IAC directory ..................................................... 26 
Change the directories in the saved transfer description file ............................................................. 28 
Copy the Data Transfer description files to the IBM i IFS.................................................................. 31 
Start the Data Transfer program ............................................................................................... 32 
Discussion ........................................................................................................................... 33 
Run the Data Transfer program from a 5250 command line ............................................................. 34 
Use the QSH command to invoke the Data Transfer ..................................................................... 34 
Use the RUNJVA command to invoke the Data Transfer ................................................................ 36 
Review additional options for the RUNJVA command .................................................................. 38 
Submit a Data Transfer request to batch ....................................................................................... 39 
Use the QSH command to invoke the Data Transfer ..................................................................... 39 
Use the RUNJVA command to invoke the Data Transfer ................................................................ 39 
The Command Line Download option ............................................................................................ 40 
Create and work with the XFRDTA command ................................................................................. 41 
Review and compile the XFRDTAC CL program ............................................................................ 41 
Review and create the XFRDTA command ................................................................................... 45 

1
Run IBM i Access Client Solutions Data Transfers on the IBM i
Copyright © 2012, Craig Pelkie, ALL RIGHTS RESERVED
 The XFRDTA command in operation ........................................................................................... 46 
Parameters used with the XFRDTA command .............................................................................. 47 
Check for, install the IBM Tools for Developers for i5/OS LPP (OBSOLETE) ......................................... 49 
Use the Display Installed Licensed Programs program to check for the LPP ...................................... 49 
Check for the vncserver_java file (5799PTL already installed) ........................................................ 50 
Download the IBM Tools for Developers for i5/OS LPP .................................................................. 51 
Install the IBM Tools for Developers for i5/OS LPP ....................................................................... 55 
Work with the VNC Server........................................................................................................... 57 
Check to see if the VNC server is already running ........................................................................ 58 
What is the ps command and what do the gaxuw options mean? ................................................. 60 
What does the grep command do? .......................................................................................... 61 
Create the VNC password file .................................................................................................... 62 
Create the VNC password ......................................................................................................... 64 
Start the VNC sever — Initial Start ............................................................................................ 65 
Verify that the VNC server is running ......................................................................................... 66 
Stop the VNC server ................................................................................................................ 67 
Review files that were created by starting the VNC server ............................................................. 68 
Start the VNC Server — Production Start .................................................................................... 70 
Working with the VNC sever in a production environment ........................................................... 70 
Open firewall ports used by the VNC server ................................................................................ 71 
Work with the VNC Viewer .......................................................................................................... 72 
Start the Data Transfer program on the IBM i ................................................................................ 75 
Check for environment variables ............................................................................................... 75 
Remove environment variable(s) ............................................................................................... 76 
Change environment variable(s)................................................................................................ 77 
Add environment variables ....................................................................................................... 78 
Start the Data Transfer program ............................................................................................... 79 

2
Run IBM i Access Client Solutions Data Transfers on the IBM i
Copyright © 2012, Craig Pelkie, ALL RIGHTS RESERVED
About this document
This document describes how to run the IBM i Access Client Solutions Java–based data transfer program
on the IBM i.

Your IBM i server must be at OS/400 V5R4 or above to use the steps shown in
this document.

The IBM i Access Client Solutions (ACS) product is a new offering from IBM. It provides some of the
features of the traditional IBM i Access for Windows (5250 emulation, data transfer) in a Java
environment. Any client computer that has the Java 6 or Java 7 runtime environment can use the ACS
programs. For example, the program can be installed on a Macintosh computer or on a PC running Linux.

Because the product is entirely Java–based, it is also possible to run the Data Transfer features (file
download / file upload) on the IBM i. It is important to understand that installing and running the IBM i
Access Client Solutions product on the IBM i is not supported by IBM.

Installing and using the ACS data transfer components on the IBM i may be useful for some scenarios
where you need to extract data from the IBM i database into PC file formats, or where you need to upload
data from PC file formats to the IBM i database. By moving the data transfer components to the IBM i, you
can take advantage of the IBM i batch processes to run the data transfer programs. This may lessen the
need for creating and maintaining cumbersome PC–based data transfer mechanisms, which traditionally
use remote command features.

The PC format files that are produced (file download) or consumed (file upload) are located in the IBM i
IFS

After installing and configuring the ACS components on the IBM i, you can use a workstation–based
version of ACS to develop the data transfer applications. The outputs of the workstation development are
PC files that describe the data transfers. After creating and saving the description files on the workstation,
you copy the description files to the IBM i IFS. When you run the data transfer programs on the IBM i, you
reference the description files.

IMPORTANT
USE THE STEPS DESCRIBED IN THIS DOCUMENT AT YOUR OWN RISK.
IBM WILL NOT PROVIDE SUPPORT FOR THE STEPS DESCRIBED IN THIS DOCUMENT.

IF YOU ARE UNSURE ABOUT WHAT YOU ARE DOING, DO NOT CONTINUE. SEEK QUALIFIED HELP IF
NECESSARY.

BEFORE RUNNING THE PROGRAMS DESCRIBED IN THIS DOCUMENT, BE SURE YOU HAVE ADEQUATE
BACKUPS OF ALL IMPORTANT DATA THAT YOU ARE WORKING WITH.

IMPORTANT

3
Run IBM i Access Client Solutions Data Transfers on the IBM i
Copyright © 2012, Craig Pelkie, ALL RIGHTS RESERVED
Why

At each major section of this document, you will see a heading labeled Why. Within that heading, there is
a brief description of why you need to perform the steps in the section.

Although it looks like performing all of the steps in this document will be a laborious task, you should be
able to complete all of the steps and have Data Transfer running on your IBM i within a few hours. By
explaining why you need to perform the steps shown in a section, you should have a better understanding
of what you are trying to accomplish within that section and how the steps fit in with the rest of the
procedures described in this document.

4
Run IBM i Access Client Solutions Data Transfers on the IBM i
Copyright © 2012, Craig Pelkie, ALL RIGHTS RESERVED
PC Prerequisites
Why y: To run the ACS code on your PCC, you need the Java 6 or higher ru
untime on your worksta ation. You
will rrun the ACS
S code on yo also to develop the Data
our PC to test the progrrams, and a a Transfer d
description
files.

___
___ Open the
e Command
d Prompt pro
ogram.

___
___ Enter the
e following command:
c

java -ve
ersion

___
___ If Java is
s installed on your work
kstation, you will see ou ar to what is
utput simila s shown in F
Figure 1.

iac090

Figurre 1: Use the

e java -version command to
t verify thatt Java is insta
alled on your workstation..

___
___ If you do
o not get the
e expected output from
m the java ––version com mmand, or if the versio
on is lower
than 1.6, you need to downloadd and install the curren t version off Java.
Go to htttp://www.ja
ava.com and
d download the version
n for your wo s operating s
orkstation’s system.

5
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
IBM
M i Prer
requisite
es
Why y: To run the ACS code on the IBM M i, you needd the Java 6 or higher rruntime on the IBM i. Y
You need to
M Developerr Kit for Java (Licensed Program Prroduct [LPP]
veriffy that you have the correct featurre of the IBM
57xxx-JV1) installed on the IBM i.

 400 V5R4, the LPP is 57

For OS/4 722-JV1
 For IBM i V6R1 and IBM i V7R1, the LPP is 5761-JV1

___
___ On a 525
50 command entry disp
play, enter the
t comman
nd:

GO LICPGM
M

___
___ On the Work
W with Licensed Programs
P menu,
m enterr option 10, Display installed lice
ensed
programms.

___
___ Scroll through the list of installe
ed licensed programs u
until you locate the 57x
xxJV1 IBM Developer
r
Kit for Java.
J

___
___ Verify that LPP 57xx
x-JV1 optio
on 11 (Java SE 6 32 b bit) is installed (Figure 2) and/or L
LPP
57xx-JV V1 option 12
1 (Java SE
E 6 64 bit) (Figure 3) i s installed.

___
___ If neither of the Java SE 6 optio
ons are installed, you n
need to insta
all the LPP p
product options and
he current PT
install th TFs before continuing.
c

iac091

Figurre 2: Use the

e Display Insttalled License
ed Programs program
p to v
verify that the
e Java SE 6 p
product is installed on the
IBM ii.

6
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
 iac092

Figurre 3: This is a continuation

n of the Display Installed Licensed Pro
ograms outpu
ut, showing th
hat the 64 bit Java SE 6
runtiime is installe
ed on the IBM
M i.

7
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Download and ins
stall IBM
M i Acce
ess Clien
nt Soluttions
Whyy: You need to get the IBM i Access Client Solutions code to complette the steps shown in th
his
docu
ument.

At th
he time this document was
w prepare ed, the IBM i Access Cliient Solutions licensed program prroduct
(57333-XJ1) wass available fo
or download
d from IBM’s
s web site. TThe download that was s available w
was a “beta”
”
version of the product.
p

Dow
wnload th
he software
___
___ Go to the
e following URL:

http://www-03.ibm..com/system
ms/power/software/i/acccess/solutions.html

___
___ On the web
w page, cllick the Dow
wnload the
e technolog
gy preview
w link as sho
own in Figurre 4.

iac001v2

Figurre 4: Downloa
ad the IBM i Access
A Clientt Solutions prroduct from tthe IBM site ((screen grab:: 2012-11-14
4).

8
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
___
___ You are prompted too enter yourr IBM ID and password (Figure 5). If you do n
not have an IBM ID,
you can register and
d create an ID on this page.
p
Note: doo not enterr your IBM i user ID and
d password.. The IBM ID
D and passw
word is an ID
D that is
used to access
a IBM web pages.

iac002

Figurre 5: You nee

ed to enter yo
our IBM ID an
nd password to access the
e software do
ownload page
e.

___
___ After enttering your ID and passsword, you are
a asked to
o confirm pe
ersonal info
ormation and
d accept the
e
license agreement
a (Figure 6).

iac003

Figurre 6: You are

e asked to con
nfirm your se
elections and agree to the
e license before downloadiing the softw
ware.

9
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
___
___ The IBM i Access Cliient Solution
ns download
d page show
wn in Figure
e 7 is display
yed.
There arre two techn
niques you can
c use to download
d the
e software:

 Dowwnload Dire ector — this s launches a Java appliccation on yo

our PC. You can select b
both files
for do
ownload. Th he IBM Dow wnload Director is typica
ally used whhen you are downloadinng very
large
e files (severral hundred MB and up)), as it mayy be faster th
han the HTT
TP download d. When
downnloading thee ACS file, th bably no perrformance advantage using the Download
here is prob
Direc
ctory.
The Download
D Director
D requ
uires that yo a installed o
ou have Java on your worrkstation.

 HTTP
P — this use
es the tradittional brows
ser–based d
download prrocess.

___
___ If you wa
ant to use the Downloa n the next section.
ad Director, use the ste ps shown in

___
___ If you wa
ant to use HTTP,
H use th
he steps sho
own starting
g on page 12.

Dow
wnload usin
ng the Dow
wnload Dire
ector

___
___ Select bo
oth files for download and
a click the d now link, as shown in Figure 7.
e Download

iac004v2

Figurre 7: You can

n use the Dow
wnload Directtor to downlo
oad the files.

10
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
___
___ The conffirmation dia
alog shown in Figure 8 is displayed
d. Click the Run button
n to continue
e.

iac005

Figurre 8: You are

e asked if you
u want the Do
ownload Direc
ctor (a Java a
application) tto run.

___
___ If the Inttial Setup dialog is disp
played (Figure 9), enterr the directo
ory on your PC where y
you want the
e
files dow
wnloaded to,, then click the
t OK buttton.

iac006

Figurre 9: The Dow

wnload Directtor prompts for
f the directtory on your P
PC where you
u want the so
oftware down
nloaded to.

___
___ The Dow
wnload Direc
ctor progress dialog is displayed
d wh
hile the dow
wnload is in progress (F
Figure 10).

iac007v2

Figurre 10: The Do

ownload Director displays a progress dialog
d during the download.

___
___ Go to Ex
xtract the downloade
d ed files on page
p 13 to ccontinue insstalling ACS on the workstation.

11
1
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Dow
wnload usin
ng HTTP
___
___ If you do
o not want to
t use the Download
D Director, click
k the Download using
g http tab as shown in
Figure 11.

___
___ Click the
e Download
d now link for
f both of the
t files.

iac011v2

Figurre 11: You ca

an download using
u HTTP iff you do not want to use tthe Download
d Director.

___
___ In the File Download
d dialog (Fig
gure 12), cliick the Save
e button. Sa
ave the ACS
S files to a d
directory on
your PC.

iac012

Figurre 12: You arre prompted to

t open or sa
ave the file th
hat is downloa
aded.

12
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Exttract the downloaded files

Why
y: The code that you do
ownload is in a ZIP file. You need tto extract th
he files from
m the ZIP.

___
___ Go to the
e directory where
w you download
d th
he ACS code e. Figure 13 shows the .txt and th
he .zip file
that were downloaded. (The dlm mgr.pro file is only pres
sent if you u
used the Do
ownload Dire
ector. If youu
e HTTP down
used the nload, the file will not be
b present. IIt is not nee
eded and may be deleteed.)

iac021v2

Figurre 13: Go to the directory

y where you downloaded
d the
t ACS code .

___
___ Extract all
a of the file es from the IBMiAccess_ _v1r1.zip fille. You can extract the files to the same
directory
y that you downloaded the files to, or to anoth her directoryy on your wworkstation. Figure 14
shows alll of the files
s in the zip, extracted to
t the same directory w where the files were dow wnloaded.

iac022

Figurre 14: The dirrectory will lo

ook like this after
a extractin
ng all of the files from the
e .zip file.Run
n an ACS Datta Transfer
Down nload on your workstation n

13
3
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Why
y: You need to run a Da
ata Transferr download on your worrkstation to verify that the code works.

Befoore installing
g the ACS co
ode on the IBM
I i, you should
s test it on your w
workstation. For this tes
st, you will
startt ACS and perform
p ata Transferr download (data will be
a Da e transferre
ed from an IIBM i databa
ase file to a
file o
on your worrkstation).

By running the test, you wiill verify hatt the ACS co

ode works, a and you willl see how it works. Wheen done
with the transfeer, you will save
s the transfer descriiption to a ffile on your workstation
n. The transffer
cription will be used when you run the ACS cod
desc de on your IBM i.

Start the AC
CS progra
am
You can start th
he ACS prog
gram using either
e a starrtup program
m provided by IBM, or by running a startup
scrip
pt provided by IBM.

Starrt using a startup

s pro
ogram

___
___ Go to the
e directory where
w you extracted
e th
he download
ded file.

___
___ In the St
tart_Programms directory
y, open the subdirectory
s y for the wo
orkstation op
perating sys
stem that
you are using, as sh
hown in Figuure 15.

___
___ In the su
ubdirectory, run the exe
ecutable pro
ogram to sta
art the ACS
S program.

iac031

Figurre 15: You ca

an start the ACS
A client from
m the Start_Programs dirrectory.

14
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Starrt using a startup
s scr
ript

___
___ Go to the
e directory where
w you extracted
e th
he download
ded file.

___
___ In the St
tart_Scripts directory, open the su
ubdirectory for the worrkstation operating systtem that
you are using, as sh
hown in Figu
ure 16.

___
___ In the su
ubdirectory, run the scrript to start the ACS pro
ogram.

iac032

Figurre 16: You ca

an start the ACS
A client from
m the Start_Scripts directtory.

Starrtup (startup program

m or startu
up script)

___
___ The ACS program sttarts. While starting, yo
ou will see tthe Workingg panel sho
own in Figurre 17. The
e displayed in
message i the panell changes as s the progra am is loaded
d.

iac035

Figurre 17: The Working

W panel shown here is displayed when you sta
art the ACS p
program.

15
5
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Run
n the Datta Transfer with Display
D ou
utput

Why y: For your first test, yo

ou will run a Data Trans
sfer downlo ad to a disp
play. This is the simples
st and
quickest way to verify that the download works.

___
___ The IBM
M i Access Client
C Soluttions dialog
g is displaye
ed, as shown in Figure 18.

___
___ In the General secttion, click th
he Data Tra
ansfer item .

iac041v2

Figurre 18: Click th

he Data Tran
nsfer item in the
t IBM i Acc
cess Client So
olutions dialo
og.
___
___ The Dataa Transfer dialog show
wn in Figure
e 19 is displa
ayed. Verify
y that the Frrom IBM i – 2 tab is
the selec
cted tab.

iac042

Figurre 19: Enter the

t System name,
n File na
ame and outp
put device on the Data Tra
ansfer dialog..

16
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
___
___ Enter the
e following items
i in the
e Data Trans
sfer dialog:
System (e
enter your IBM i TCP/IP
P host name
e or IP addre
ess)
File nam
me qi
iws/qcustcdt

Output device
d Display

___
___ Click the
e Start Tran
nsfer button
n.

___
___ The Sign
non to IBM M i dialog shown in Figure 20 is disp
played. Ente
er your IBM
M i user ID and
password
d, then click
k the OK buutton.

iac043

Figurre 20: Enter your

y user ID and passworrd when prom
mpted.

___
___ The dataa transfer ru
uns. It displa
ays the outp n Figure 21. When done viewing th
put shown in he output,
close the
e output display panel.

iac044v2

Figurre 21: The re

esults of the data
d transfer are displayed
d.

17
7
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Run
n the Datta Transfer with File
F outpu
ut

Whyy: You need to test the Data Transsfer downloaad with outp
put to a CSV
V file. This s
step shows y
you how to
use the Data Trransfer program to conffigure a dow
wnload requ est.

___
___ When yo play panel you are returrned to the Data Transfer dialog..
ou close the output disp

___
___ Change the
t Outputt device selection to File and click
k the Details button, as
s shown in F
Figure 22.

iac051

Figurre 22: Select the File outp

put device and click the De
etails button..

___
___ The File Details dia
alog shown in Figure 23 ed. Select Comma Sep
3 is displaye parated Vallues (.csv)
as the fille type.

iac052v2

Figurre 23: Select the Comma Separated Va

alues file type.

18
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
___
___ In the Fiile Details dialog, chec
ck the Save
e client file descriptioon checkbox
x and enter the path
and file name
n for the Client file
e description file, as shown in Figure 24.
Note: a directory na amed IACXFER is used to contain th he file descrription file and transfer description
file (whic
ch will be crreated later)). You can create
c and u
use that direectory name e or you can
n use
another directory na ame on your workstatio on.

___
___ Click the e File Details dialog.
e OK button to close the

iac053v2

Figurre 24: Specify

fy the file des
scription file name.
n

___
___ On the Data
D Transffer dialog, enter
e ath and file name for th
the pa he File nam
me, as shown in Figure
25.
Note: a directory na amed IACOUT T is used to contain the
e file descrip
ption file and transfer d
description
file (whic
ch will be crreated later)). You can create
c and uuse that direectory name e or anotherr directory
on your workstation n.

___
___ Click the
e Start Tran
nsfer button
n to run the
e data transffer.

iac054
4

Figurre 25: Specify

fy the file nam
me for the CS
SV file, click the
t Start Tran
nsfer button.
19
9
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
___
___ The transfer runs. When
W it is do
one, the Inq
quiry Mess
sage shown in Figure 26 is displayed.

___
___ Click the
e OK button to close the
e Inquiry Message.
M

iac055

Figurre 26: The co

ompletion me
essage is disp
played when the
t transfer iis done.

___
___ On your workstation
n, go to the directory where
w the ou
utput file (th
he .csv file) was created. Figure 27
7
shows th
he qcustcdt.csv file in the
t UT directory .
c:\IACOU

iac056v2

Figurre 27: Verify that the CSV

V file is in the
e output direc
ctory.

20
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
___
___ Open thee qcustcdt.ccsv file. Figu
ure 28 show
ws the file op
pened in Microsoft Exce
el. If you do
o not have
Excel ins
stalled on yo
our workstation, open the
t .csv file in a text ed
ditor.

___
___ When do
one reviewin
ng the .csv file, close th
he program that you ussed to view it.

iac057

Figurre 28: The CS

SV file is open
n in Microsofft Excel.

21
1
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Sav
ve the Da
ata Transfer down
nload request

Whyy: You need to save the

e Data Trans
sfer requestt so that you can copy the saved rrequest file tto your
IBM i.

___
___ Go back to the Data
a Transfer dialog (it sh
hould still be
e open, with
h the values
s set to dow
wnload to
the .csv file).
___
___ Select th
he File, Sav
ve As menu item, as sh
hown in Figu
ure 29.

iac061

Figurre 29: Select the File, Sav

ve As menu ittem.

___
___ In the Sa
ave dialog (Figure
( 30),, navigate to
o the c:\IAC
CXFER directo
ory.
___
___ Save the
e transfer de
escription fille as qcustc
cdt.dtfx.

iac062

Figurre 30: Save the

t transfer description
d as
s qcustcdt.dtffx.

___
___ You are returned to the Data Transfer
T dia
alog.
___
___ Close the
e Data Tran
nsfer dialog
g.
___
___ Close the
e IBM i Acc
cess Client Solutions dialog.

22
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Run the Data Tran
nsfer fro
om a co
ommand
d line
Why y: These steeps use the saved data transfer req
quest with a Java comm
mand line. T
This is the te
echnique
that you will use
e when you run the Data Transfer on the IBM i.

At th
his point, yo
ou have insttalled the IB
BM i Access Client Soluttions program on your w workstation. You have
teste
ed the Data Transfer do ownload fea ature to dow
wnload a .cs e workstation. You have
sv file to the e also saved
d
the d
data transfeer descriptio
on file (.dtfx
x).

In th
his section, you will run
n the Data Transfer
T from
m a Java co mmand line e, you will not use the D
Data
Trannsfer GUI. The Data Tra ansfer uses the
t .dtfx fille that you s
saved in the
e previous ssection.

The steps shown in this sec

ction are whhat you will do on the IB
BM i. When you run the e Data Transfer
proggram on the IBM i, you will not use
e the Data Transfer
T GUII. You will use the Java features off the IBM i
to ru
un the saved
d data trans
sfer descripttion.

___
___ Open a Command
C Prompt
P program on your workstatio
on.

___
___ Enter the
e following command
c in
n the Comm
mand Promptt window, as shown in Figure 31.
 Note
e: the values s that you enter
e (other than drive letter and d
directory names) are ca
ase–
sensiitive. Be surre that you enter the va
alues as sho
own here.
 Notee: if you created different directory
y names (IA C, IACXFER) substitute tthe directory
y names
that you
y created
d.
 Note
e: enter the java command line on the same liine, as show
wn in the fig
gure. The co
ommand is
wrapped in this document.
d

java
a -jar c:\IAC\a
acsbundle
e.jar /PLUGIN=d
download
/file=c:\IACXFER
R\qcustcd
dt.dtfx

iac071v2

Figurre 31: Enter the

t java com
mmand line to run the data
a transfer.

23
3
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
___
___ The first time you ru
un the java command line Data Tra ansfer, you will be prom
mpted to en
nter your
IBM i useer ID and pa
assword, ass shown in Figure
F 32. N
Note: you mmay be prom mpted twice for your
user ID and
a password.

iac072v2

Figurre 32: You wiill be prompte

ed to enter your
y IBM i use
er ID and passsword the firrst time you run the java command
line d
data transferr.

___
___ The Data
a Transfer program
p runs. The output of the prrogram is sh
hown in Figu
ure 33.

iac073v2

Figurre 33: The ou

utput of the Data
D Transferr program sho
ows that it iss done.

24
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Ins
stall the
e IBM i Access
A Client
C Solutions
s progra
am on tthe IBM i
Why
y: You need to install th
he code thatt you downlload onto yo
our IBM i to run the Data Transfer..

his section, you will insttall the IBM i Access Client Solutio ns program on the IBM
In th M i. You will copy files
from
m your works station to directories in
n the IFS.

The steps shown in this sec o work with the IFS. If you prefer another
ction use the System i Navigator to
technique to acc
cess and woork with the
e IFS, you do System i Navigator.
o not have tto use the S

Cre
eate direc
ctories in
n the Root file system
___
___ In the Sy
ystem i Nav
vigator program, expand the File S em, then Integrated F
Systems ite File
System,, then Roott.

___
___ Right-clic
ck the Roott item and select
s the New Folder item in the pop-up me
enu, as show
wn in Figure
34.

iac101

Figurre 34: Right-c

click the Root item, selectt the New Follder item in tthe pop-up m
menu.

25
5
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
___
___ Create th
he following
g three direc
ctories in the
e Root file ssystem:
Directory Used
d For

IAC
Conta
ains the ACSS program, copied from m your
works
station (insttructions sh own below)).

IACOUT
Direc
ctory where the output from a Data
a Transfer
(download) is wrritten to.

IACXFER
Direc
ctory where the data tra
ansfer descrription files that
you create
c on yo
our workstattion will be located.

___
___ When do one, verify that the Root
t file system
m directory ccontains the
e three subd
directories, as shown in
n
Figure 35
5.

iac102

Figurre 35: When done, verify that the thre

ee directories are in the Ro
oot file system
m.

Cop
py the AC
CS code from your
r worksta
ation to tthe /IAC directory
y
___
___ On your workstation
n, navigate to
t the \IAC directory (tthe directory
y where the
e ACS code iis installed).

___
___ Select th
he acsbundle
e.jar file an
nd the AcsCo rties file.
onfig.proper

Note: yo
ou can selec
ct and copy the files one at a time if you prefe
er.

___
___ Right-clic
ck and selec
ct the Copy
y item from the pop-up menu, as sshown in Fig
gure 36.

iac111

Figurre 36: Select the two files

s shown here and select th
he Copy optio
on.

26
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
___
___ Go back to the System i Naviga
ator. Right-c
click the IAC
C directory in
n the Root ffile system, then select
the Pastte item from
m the pop-up menu as shown
s in Fig
gure 37.

iac112

Figurre 37: Right-c

click the IAC directory, se
elect the Pastte item from tthe pop-up m
menu.

___
___ Wait for the file copy
y to comple
ete.
___
___ Verify that the two files
f are in the
t IAC direc
ctory, as sh own in Figu
ure 38. If yo
ou do not se
ee the files,
he steps sho
repeat th own above.

iac113

Figurre 38: Verify that the two files are in th

he IAC directtory.

27
7
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Cha
ange th
he directtories in
n the saved tran
nsfer de
escriptio
on file
Whyy: The saved d transfer description file on your workstation
w n points to d
directories on the works station. To
use the transferr description
n on the IBM
M i, you neeed to change
e the directoories to dire
ectories thatt are in the
IBM i IFS.

___
___ On your workstation
n, go to the IACXFER dire
ectory.

___
___ In the directory, right click the qucstcdt.dt
tfx file (you
u saved the file in the section Save
e the Data
Transfer download d request ono page 22)).

___
___ Select th
he Open item from the pop-up menu, as show
wn in Figure 39.

iac121

Figurre 39: Right-c

click the qcus
stcdt.dtfx file
e and select th
he Open optiion.

___
___ The file should
s openn in Notepad
d. If the Ope
en with dia alog is displa
ayed as sho
own in Figurre 40, selectt
Notepad d as the pro
ogram to be used to open the file.

iac122

Figurre 40: If the Open with dia

alog is displa
ayed, select Notepad
N as th
he program to
o open the .d
dtfx file type.

28
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
___
___ The qucs
stcdt.dtfx file
f is opened in Notepad (Figure 41
1).

iac123

Figurre 41: The qc

custcdt.dtfx file,
fi opened in
n Notepad.

29
9
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
___
___ Before making
m any changes,
c usse the File, Save As m menu item to o save the fiile as xqcust
tcdt.dtfx.
By saving the file wiith a new na
ame, you re etain the original file on
n your works station.
Note: when you use e the File, Save
S As item
m in Notepadd, change th he Save as type to Alll Files
(*.*). Iff you do sett the Save as
a type to that
t option, the file is ssaved with a .txt exten
nsion.

___
___ Make the
e following changes
c to the
t values shown
s in the
e file:
Iden
ntifier New Value
e
ClientFile /IACOUT/qcu
ustcdt.csv
FDFFile /IACXFER/qc
custcdt.fdfx
x

___
___ When do
one, verify that the valu
ues that are
e in the file a
are as show
wn in Figure 42.

Note: blank separattor lines were added be

etween each
h section. Yo
ou do not have to add tthe blank
separato
or lines.

iac124
4

Figurre 42: Chang

ge the ClientF
File and FDFFiile values, save the file ass xqcustcdt.d
dtfx.

___
___ Save the
e file after making
m the changes.
c

___
___ Close No
otepad.

30
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Cop
py the Data
D Tra
ansfer descript
d ion files
s to the IBM i IFS
Why y: When youu run the Da
ata Transferr program on
o the IBM i,, it will use the Data Trransfer desc
cription file
that you modifie
ed.

___
___ On your workstation
n, navigate to XFER directo ry.
t the \IACX

___
___ Select th
he qcustcdt.
.fdfx and xq tfx files, righ
qcustcdt.dt ht-click, and
d select the Copy item from the
pop-up menu,
m as sh
hown in Figu
ure 43.

iac131

Figurre 43: Select the two files

s in the IACXF
FER directory
y on your worrkstation.

___
___ Go go th
he System i Navigator.

___
___ Right-clic
ck the IACXF
FER directory
y and selectt the Paste item from tthe pop-up menu.

___
___ When the copy is do
one, verify that
t the two
o files are in the directo
ory, as show
wn in Figure 44.

iac132

Figurre 44: Verify that the files

s are in the IA
ACXFER direc
ctory in the IF
FS.

31
1
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Start the Da
ata Trans
sfer progr
ram
Whyy: You can now
n run the
e Data Trans
sfer program
m. For the first test, you
u will run th
he java com
mmand in the
e
QSH
HELL environnment.

___
___ On a 525
50 command line, enter the QSH (S
Start QSHEL L) command
d.

___
___ The QSH
H Command Entry panel is displaye
ed.

___
___ Enter the
e following command
c on the QSH Command
C E
Entry line.

Note: th
he data transfer runs with the auth
hority of the user profile
e of the inte
eractive sess
sion.

Note: th
he command
d is case–se
ensitive, enter it as sh
hown.

Note: th
he value for the os400.c heck parame
class.path.security.ch eter is zero, not the lettter “O”.

Note: ennter the enttire commannd on one lin

ne in the QSSH Commannd Entry pan
nel. The line
e will “wrap”
”
on the Command En ntry panel as you type it in. The co
ommand tex
xt shown in this example is
wrapped on this pag ge.

java –jar /I
IAC/acsbu
undle.jar
r -Dos40
00.class.
.path.sec
curity.ch
heck=0
/PL
LUGIN=dow
wnload /file=/IA
/ ACXFER/xq
qcustcdt.
.dtfx

___
___ The Data
a Transfer program
p runs. The messsages show n in Figure 45 are displayed when the
program ends. It may
m more thhan a minu ute or longe
er before yo
ou see any o
output. Let the
m run beforre doing any
program ything else on
o the QSH Command Entry panel.

___
___ Press the
e F3 (Exit) function
f key
y to close th
he QSH Com
mmand Entry
y panel.

iac235v2

Figurre 45: The Da

ata Transfer program
p runs
s and display
ys the messag
ges shown he
ere.

32
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
___
___ In the Sy
ystem i Nav
vigator, go to the output directory tthat you speecified (see the ClientF
File item in
n
Figure 42
2 on page 30).
3 In this example,
e th
he output dirrectory is IF
FS directory /IACOUT.

___
___ The qcus
stcdt.csv file is the output from the Data Tran
nsfer progra
am.

___
___ Copy the
e qcustcdt.c
csv file to yo
our workstation and op
pen it. You sshould see the same output as you
saw wheen you ran the Data Tra ansfer on yo
our workstattion, as show e 28 on pag
wn in Figure ge 21.

iac236

Figurre 46: The qc

custcdt.csv fille is in the ou
utput directorry used by th
he Data Transsfer program.

Disc
cussion
Part of the reason why the program ta
akes so long to respond d is because it incurs the overhead of starting
the JJava runtime environment. For sm
mall data tran h as shown in this exam
nsfers, such mple, the tim
me to
transsfer the records is exce
essive.

After you have worked

w thro
ough the steeps in this document, ruun the data transfer for a file with a greater
nummber of recorrds. You shoould see tha
at the transffer program
m performs m
much betterr, when cons sidered as
the n
number of records
r transferred per second.

On a test system m, a file con 83 rows, witth 53 fields and a recorrd length of 290, was downloaded
ntaining 648
to a .csv file in 70 seconds,, for a rate of
o 92.6 reco
ords per seccond.

33
3
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Run the Data Tran
nsfer pr
rogram from a 5250 co
ommand
d line
Whyy: Although you can go into the QS SH Comman nd Entry pannel and run the java co
ommand to iinvoke the
a Transfer, it is more lik
Data kely that you will want to run Dataa Transfers u
using IBM i commands.. When you
use commands, you can em mbed Data Transfer
T witthin CL prog
grams or youu can submit the Data T
Transfer
requ
uest to batch
h. You can use
u either th he QSH comm mand or thee RUNJVA commmand to innvoke the D
Data
Tran
nsfer program.

Use
e the QSH
H comma
and to inv
voke the Data Tra
ansfer
Whyy: In the pre
evious section, you wen
nt into the QSH
Q Comma and Entry panel to run the java co
ommand.
You can pass th
he java command as a parameter
p to
t the QSH co
ommand.

___
___ On a 525
50 command line, enter the QSH command and
d press F4 tto prompt fo
or its param
meters.

___
___ For the CMD
C parametter value, en
nter the com
mplete java command sstring that y
you previous
sly entered
on the QSH
Q Command Entry pa anel, as show
wn in Figure
e 47.

iac261v2

Figurre 47: Enter the

t java com
mmand with all of the parameters as th
he CMD value
e on the QSH command.

___
___ Press En
nter after yo
ou enter the
e complete java
j comma
and string.

34
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
___
___ A shell environmentt panel open
ns to display
y the messa
ages sent fro
om the Data
a Transfer p
program, as
shown inn Figure 48.

___
___ Press En
nter to close
e the shell environment
e t panel.

iac262v2

Figurre 48: This pa

anel is displayed when yo ou run the jav
va command from the QSH command. Some of thee messages
from the previous s use of the shell
s are show
wn, in additio
on to the messsages for the
e Data Transffer.

35
5
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Use
e the RUN
NJVA com
mmand to
o invoke the Data Transferr

Why y: You can use

u the RUNJJVA comman
nd as an alteernative to tthe QSH com
mmand. The RUNJVA com mmand uses
the ttraditional IBM i comma
and parame
eter style. Yo
ou may findd it easier to
o work with the RUNJVA command
inste
ead of the QSH command.

___ 50 command line, enter the RUNJVA

___ On a 525 A command and press F
F4 to promp
pt for its parrameters.

___
___ On the Run
R Java Program com
mmand prom
mpt panel, enter the fo
ollowing valu
ues for the parameters,
as shown
n in Figure 49:
4

Para
ameter Nam
me Value

CLASS ꞌ/IAC/acsb
bundle.jarꞌ

PARM (parameterr 1) ꞌ/PLUGIN=d

downloadꞌ

PARM (parameterr 2) ꞌ/file=/IA

ACXFER/xqcus
stcdt.dtfxꞌ

iac271v2

Figurre 49: Enter the

t CLASS an
nd PARM valu
ues, press F10 to display a
additional parameters.

___
___ Press the
e F10 key to display ad
dditional parrameters for the RUNJVA
A command..

36
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
___
___ On the second param
meter panel, enter the value *IGNO
ORE for the C
CHKPATH para
ameter, as s
shown in
Figure 50
0.

iac272v2

Figurre 50: Enter the

t CHKPATH
H value.

___
___ Press En
nter to run the
t RUNJVA command
c with
w the para
ameter values that you entered.
___
___ The Java
a Shell Displlay panel sh
hown in Figu
ure 51 is dissplayed. It d
displays the messages w
when the
Data Tra
ansfer program runs.
___
___ Press the
e Enter key
y to close the Java Shell Display an
nd return to the 5250 command display.

iac273v2

Figurre 51: The Ja

ava Shell Disp
play shows th
hese message
es when you run the Data
a Transfer.
37
7
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Review additio
onal option
ns for the RUNJVA
R co
ommand
y: The OUTPU
Why UT paramete
er for the RU
UNJVA command may be
e of interestt to you.

___
___ Enter the
e RUNJVA commmand from
m a 5250 co
ommand pro
ompt and en
nter the parrameter valu
ues that you
u
previously entered.

___
___ Press the
e F10 key to display all parameterrs for the co
ommand.

___
___ Roll forw
ward in the command
c prrompter to the
t 4th prom
mpt panel, sshown in Fig
gure 52.

___
___ The values that you can enter for
f the OUTPU
UT paramete
er are:
* — outpu
ut is display
yed in the Ja
ava Shell Display
Dest
tination *PRINT — output is se
ent to a spo
ool file
*NONE — output
o is no
ot displayed or spooled
*PAUSE — the Java Sh
hell Display remains op
pen until
you close it
Prog
gram end action
E — the Java
*CONTINUE a Shell Disp
play closes
automatic
cally

iac274
4

Figurre 52: The OU

UTPUT param
meter is the la
ast paramete
er on the RUN
NJVA comman
nd prompt.

38
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Submit a Data Transfer request to batch
Why: You can run a Data Transfer request as a batch job. By moving the request to batch, you make it
easier to create automated Data Transfer requests.

Use the QSH command to invoke the Data Transfer

Why: You can run the QSH command that invokes the java command to run the Data Transfer in batch.

_____ On a 5250 command line, enter the following SBMJOB command:

SBMJOB CMD(QSH CMD('java -jar /IAC/acsbundle.jar

-Dos400.class.path.security.check=0
/PLUGIN=download
/file=/IACXFER/xqcustcdt.dtfx')) +
JOB(QSHXFER) +
LOG(4 00 *SECLVL) +
LOGCLPGM(*YES)

Note: the JOB, LOG and LOGCLPGM parameter values are optional, you do not need to enter values for those
parameters.

Use the RUNJVA command to invoke the Data Transfer

Why: You can run the RUNJVA command to run the Data Transfer in batch.

_____ On a 5250 command line, enter the following SBMJOB command:

SBMJOB CMD(RUNJVA CLASS('/IAC/acsbundle.jar')

PARM('/PLUGIN=download'
'/file=/IACXFER/xqcustcdt.dtfx')
CHKPATH(*IGNORE)) +
JOB(RUNJVADTXF) +
LOG(4 00 *SECLVL) +
LOGCLPGM(*YES)

Note: the JOB, LOG and LOGCLPGM parameter values are optional, you do not need to enter values for those
parameters.

39
Run IBM i Access Client Solutions Data Transfers on the IBM i
Copyright © 2012, Craig Pelkie, ALL RIGHTS RESERVED
The Command Line Download option
Why: If you want to download all of the records and all fields in a database file to a stream file, you can
use the Command Line Download plugin. You do not have to specify a .dtfx file (data transfer description
file) with this plugin.

In addition to the download and upload plugin types, IBM provides the cldownload plugin. The
cldownload plugin provides a simplified way to download data from an IBM i database file to a stream file.
Because the cldownload plugin downloads all of the rows and fields that are in the database file, there is
no need to specify a data transfer description file (.dtfx).

The syntax of the command is:

java –jar acsbundle.jar

-Dos400.class.path.security.check=0
/PLUGIN=cldownload
/system=<system>
/hostfile=<library>/<file>(<member>)
/clientfile=<path><filename>.<extension>

The /system parameter value is set to the name of the IBM i system where the database file is located.
When you run the cldownload plugin on the IBM i, you can specify the system name LOCALHOST to
download a database file from the system where the plugin is running.

The /hostfile parameter is used to specify the qualified name (system format) of the database file to
download from. If you need to specify a member name, enclose the name in parentheses.

The /clientfile parameter specifies the complete path, file name and extension of the stream file that is
created as a result of the download. The file extension is used to determine the type of transfer to
perform. For example, if the file extension .xlsx is specified, an Excel 2007/2010 file is created.

40
Run IBM i Access Client Solutions Data Transfers on the IBM i
Copyright © 2012, Craig Pelkie, ALL RIGHTS RESERVED
Create and work with the XFRDTA command
Why: The Transfer Data (XFRDTA) command provides a simplified way to invoke the Data Transfer
program.

Review and compile the XFRDTAC CL program

Why: The XFRDTAC CL program is the Command Processing Program for the XFRDTA command.

The source code for this program can be downloaded at:

http://www.web400.com/downloads/ACS/xfrdta.clp.txt

Use the following CL command to compile this program:

CRTCLPGM PGM(your_lib/XFRDTAC) SRCFILE(your_lib/QCLSRC)

********************************************************************/
/* Program XFRDTAC */
/* Run the IBM i Access Client Solutions Data Transfer program */
/********************************************************************/
/* */
/* Copyright 2012, Craig Pelkie, ALL RIGHTS RESERVED */
/* [email protected] */
/* */
/* V1.01 - 2012-08-28 ORIGINAL VERSION */
/* V1.03 - 2012-11-14 UPDATE FOR OCT. 2012 ACSBUNDLE.JAR */
/* */
/********************************************************************/
/* You may freely make use of this program in any application that */
/* you develop, as long as you retain the copyright notice shown */
/* above. */
/* */
/* This program is provided for instructional purposes only. */
/* No warranty is expressed or implied. */
/* */
/* Craig Pelkie explicitly disclaims all responsibilty for your */
/* use of the program, and will not be held liable for any */
/* results or unforeseen consequences that result from your */
/* use of this program or any of the techniques that are */
/* demonstrated by this program. */
/* */
/* By using this program, you acknowledge that: */
/* */
/* 1. The techniques shown in this program have not been */
/* tested, documented, approved, or recommended by */
/* IBM. You should not expect any IBM support for */
/* the techniques shown in this program. */
/* */
/* 2. Running this program may result in changes to files */
/* on your system. The expected outputs include the */
/* data transfer output file in your IBM i IFS, and */
/* possibly one or more job log files. It is your */
/* responsibility to verify the outputs of running the */
/* program, and to ascertain that no other unwanted or */
/* unexpected changes occur on your IBM i as a result */
/* of running this program. */
/* */
/* 3. No support from Craig Pelkie is expressed or implied */
/* in the provision of this program and its accompanying */
/* documentation, if any. */
/* */
/* 4. If you do not understand how to use this program and */
/* the potential consequences of running it, DO NOT RUN IT. */
/********************************************************************/

XFRDTAC: PGM PARM(&jardir +

&plugin +
&xfrdsc +
&file +
&mbr +
&clientfile)
(continues)

41
Run IBM i Access Client Solutions Data Transfers on the IBM i
Copyright © 2012, Craig Pelkie, ALL RIGHTS RESERVED
 /*******************************************************/
/* The path, file name and extension of the stream */
/* file to transfer data to. */
/* */
/* This is only used with &direction CLDOWNLOAD */
/* (Command Line Download) */
/* */
/* Supported extensions: */
/* */
/* .csv - Comma Separated Variable */
/* .ods - Open Document Spreadsheet */
/* .xls - Microsoft Excel 97 - 2003 */
/* .xlsx - Microsoft Excel 2007, 2010 */
/* */
/* If an unsupported extension is specified, the */
/* default extension .csv is used. */
/*******************************************************/
dcl &clientFile *char 256

/*******************************************************/
/* The qualified name of the IBM i database file to */
/* transfer data from. This is only used with */
/* &plugin value *CLDOWNLOAD (Command Line Download) */
/*******************************************************/
dcl &file *char 20

/*******************************************************/
/* The IFS directory where the acsbundle.jar file */
/* is located */
/*******************************************************/
dcl &jardir *char 256

/*******************************************************/
/* The member in the IBM i database file to */
/* transfer data from. This is only used with */
/* &plugin value *CLDOWNLOAD (Command Line Download) */
/*******************************************************/
dcl &mbr *char 10

/*******************************************************/
/* The plugin to use for the transfer. */
/* */
/* *DOWNLOAD - transfer data from an IBM i database */
/* file to a stream file */
/* */
/* *CLDOWNLOAD - transfer the entire IBM i database */
/* file to a stream file */
/* */
/* *UPLOAD - transfer data from a stream file to */
/* an IBM i database file */
/*******************************************************/
dcl &plugin *char 11

/*******************************************************/
/* Variable used to set the value of the CLASS parm */
/* &jardir/acsbundle.jar */
/*******************************************************/
dcl &valCLASS *char 270

/*******************************************************/
/* Variable used to set the value of the /file parm */
/* /file=<filename> */
/*******************************************************/
dcl &valfile *char 262

/*******************************************************/
/* Variable used to set the value of the client file. */
/* clientfile=<filename> */
/*******************************************************/
dcl &valCfile *char 268

/*******************************************************/
/* Variable used to set the value of the host file/lib */
/* hostfile=<library>/<file> */
/* hostifle=<library>/<file>(<member>) */
/*******************************************************/
dcl &valHfile *char 43
(continues)

42
Run IBM i Access Client Solutions Data Transfers on the IBM i
Copyright © 2012, Craig Pelkie, ALL RIGHTS RESERVED
/*******************************************************/
/* Variable used to set the value of the /PLUGIN parm */
/*******************************************************/
dcl &valPLUGIN *char 18

/*******************************************************/
/* Variable used to set the value of the /system parm */
/* Used only with cldownload plugin */
/*******************************************************/
dcl &valSystem *char 17 +
value('/system=LOCALHOST')

/*******************************************************/
/* The path (directory) and file name of the transfer */
/* description file */
/* */
/* Example: file for upload */
/* .dttx = "transfer to IBM i" */
/* */
/* /path/upload_description.dttx */
/* */
/* Example: file for download */
/* .dtfx = "transfer from IBM i" */
/* */
/* /path/download_description.dtfx */
/* */
/*******************************************************/
dcl &xfrdsc *char 256

/*******************************************************/
/* Set the parameter values to pass to the data */
/* transfer program */
/*******************************************************/
chgvar var(&valCLASS) +
value(&jardir *tcat '/acsbundle.jar')

/*******************************************************/
/* Set values for cldownload (Command Line Download) */
/*******************************************************/
if (&plugin *eq '*CLDOWNLOAD') then(do)

chgvar var(&valPLUGIN) +
value('/PLUGIN=cldownload')

chgvar var(&valHfile) +
value('/hostfile=' *tcat +
%sst(&file 11 10) *tcat +
'/' *tcat +
%sst(&file 1 10))

if (&mbr *ne '*FIRST') then(do)

chgvar var(&valHfile) +
value(&valHfile *tcat +
'(' *tcat +
&mbr *tcat +
')')
enddo
chgvar var(&valCfile) +
value('/clientfile=' *tcat +
&clientfile)

enddo
/*******************************************************/
/* Set values for download / upload */
/*******************************************************/
if (&plugin *eq '*DOWNLOAD') then(do)
chgvar var(&valPLUGIN) +
value('/PLUGIN=download')
enddo

if (&plugin *eq '*UPLOAD') then(do)

chgvar var(&valPLUGIN) +
value('/PLUGIN=upload')
enddo

if ((&plugin *eq '*DOWNLOAD') *or +

(&plugin *eq '*UPLOAD ')) then(do)

chgvar var(&valfile) +
value('/file=' *tcat &xfrdsc)
enddo
(continues)

43
Run IBM i Access Client Solutions Data Transfers on the IBM i
Copyright © 2012, Craig Pelkie, ALL RIGHTS RESERVED
 /*******************************************************/
/* Run the data transfer */
/*******************************************************/
if (&plugin *eq '*CLDOWNLOAD') then(do)

runjva class(&valCLASS) +
parm(&valPLUGIN &valSystem &valHfile &valCfile) +
chkpath(*IGNORE)
monmsg msgid(CPF0000)
enddo

else cmd(do)

runjva class(&valCLASS) +
parm(&valPLUGIN &valfile) +
chkpath(*IGNORE)
monmsg msgid(CPF0000)
enddo

endpgm

44
Run IBM i Access Client Solutions Data Transfers on the IBM i
Copyright © 2012, Craig Pelkie, ALL RIGHTS RESERVED
Review and create the XFRDTA command

Why: The XFRDTA command can be used to run the Data Transfer program (XFRDTAC).

The source code for this command can be downloaded at:

http://www.web400.com/downloads/ACS/xfrdta.cmd.txt

Use the following CL command to compile this program:

CRTCMD CMD(your_lib/XFRDTA) PGM(your_lib/XFRDTAC) SRCFILE(your_lib/QCMDSRC)

/********************************************************************/
/* Command XFRDTA - transfer data using download/upload */
/* */
/* Copyright 2012, Craig Pelkie, ALL RIGHTS RESERVED */
/********************************************************************/
XFRDTA: CMD PROMPT('Transfer Data')
PARM KWD(JARDIR) TYPE(*PNAME) LEN(256) MIN(1) +
VARY(*NO) CASE(*MIXED) PROMPT('Directory +
for acsbundle.jar')

PARM KWD(PLUGIN) TYPE(*CHAR) LEN(11) +

RSTD(*YES) VALUES(*DOWNLOAD *UPLOAD +
*CLDOWNLOAD) MIN(1) PROMPT('Plugin +
to use')
PARM KWD(XFRDSC) TYPE(*PNAME) LEN(256) +
MIN(0) CASE(*MIXED) +
PMTCTL(NOTCLD) PROMPT('Path to .dtfx / +
.dttx file')

PARM KWD(FILE) TYPE(QUAL1) MIN(0) PMTCTL(ISCLD) +

PROMPT('Database file library to xfer')

PARM KWD(MBR) TYPE(*NAME) LEN(10) DFT(*FIRST) +

SPCVAL((*FIRST)) PMTCTL(ISCLD) PROMPT('Member')

PARM KWD(CLIENTFILE) TYPE(*PNAME) LEN(256) +

SPCVAL((*NONE)) MIN(0) +
CASE(*MIXED) PMTCTL(ISCLD) +
PROMPT('Client file path/name to write')

QUAL1: QUAL TYPE(*NAME) LEN(10)

QUAL TYPE(*NAME) LEN(10) PROMPT('Database file name')

ISCLD: PMTCTL CTL(PLUGIN) COND((*EQ *CLDOWNLOAD))

NOTCLD: PMTCTL CTL(PLUGIN) COND((*NE *CLDOWNLOAD))

45
Run IBM i Access Client Solutions Data Transfers on the IBM i
Copyright © 2012, Craig Pelkie, ALL RIGHTS RESERVED
The
e XFRDTA
A command in ope
eration
Figure 53 showss the Transffer Data (XFRDTA) comm
mand in the command p prompter. This is the co
ommand
prom
mpter displa
ay for when the PLUGIN parameter value
v is *DOW
WNLOAD or *U
UPLOAD.

iac281v2

Figurre 53: The Trransfer Data (XFRDTA)

( com
mmand, whe
en displayed iin the comma
and prompter.
Figure 54 shows s the Transffer Data com
mmand in th
he command
d prompter when the PLUGIN param
meter value
is *C
CLDOWNLOAD.

iac282v2

Figurre 54: The Trransfer Data command

c strring.
46
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Parameters used with the XFRDTA command

The parameters used with the Transfer Data command are described below.

Parameter Value Usage

JARDIR /path_name The path in the IFS where the
acsbundle.jar file is located. Do not
enter the name of the .jar file.

PLUGIN *DOWNLOAD The type of transfer to perform.

*UPLOAD
*CLDOWNLOAD

The following parameter is used when the value of the PLUGIN parameter is *DOWNLOAD or
*UPLOAD.

XFRDSC /path_name/file_name.dtfx The path in the IFS where the .dtfx

/path_name/file_name.dttx (download) or .dttx (upload)
description file is located.

The following parameters are used when the value of the PLUGIN parameter is *CLDOWNLOAD.

FILE Qualified name of an IBM i database This is the name of the database file
file that is to be downloaded. The entire
content of the file is download (all rows,
all fields).

MBR *FIRST The name of the member in the file

member_name specified in the FILE parameter to
download.

CLIENTFILE /path_name/file_name.extension The complete path and file name of the

file that is to be created as a result of
the download.

The extension must be a valid extension

for the data transfer download (.xls,
.xlsx, .csv, .ods, .txt).

If an invalid extension is specified, the

default extension value .csv is used.

47
Run IBM i Access Client Solutions Data Transfers on the IBM i
Copyright © 2012, Craig Pelkie, ALL RIGHTS RESERVED
48
Run IBM i Access Client Solutions Data Transfers on the IBM i
Copyright © 2012, Craig Pelkie, ALL RIGHTS RESERVED
Che
eck for,, install the IBM
M Tools for Dev
velopers
s for i5/
/OS LPP
(OB
BSOLETTE)

Notee: the steps

s shown starting in this section throough the ennd of this do
ocument are e not needed if you are
using the updatted version of
o the IBM i Access Clieent Solution s from Octoober 2012 (o or later). Yo
ou only need
d
se these ste
to us eps if you arre using the
e original version of the IBM i Accesss Client So
olutions prodduct.

Why y: To run the Data Tran

nsfer progra
ams using Ja
ava on the IIBM i, you n
need to use tools provid
ded by IBM
in th
he IBM Too ols for Deve
elopers forr i5/OS Lice
ensed Progrram Productt.

Use
e the Disp
play Insttalled Lice
ensed Pr
rograms p
program to check
k for the L
LPP
Why
y: You can check
c to see
e if the LPP is already in
nstalled on y
your system
m.

___ 50 command line, enter the followiing comman

___ On a 525 nd:

GO LICPGM
M

___
___ On the Work
W with Licensed Programs
P menu,
m enterr option 10, Display installed lice
ensed
programms.
___
___ When the Display Installed
I Licensed Prrograms pa
anel is displa
ayed, scroll through the
e list of
installed programs. Look for Lic
censed Program 5799P
PTL IBM To ools for Dev velopers foor i5/OS as
s
shown inn Figure 55.
Note: th
he 5799PTL LPP is not distributed
d with
w the ope erating syste
em, so if yo
ou did not ha
ave a
previous reason to work
w with th
he tools, it is unlikely th your system.
hat the LPP will be on y

iac141

Figurre 55: Look for

fo the Licensed Program Product
P 5799
9PTL.

49
9
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
___
___ If the LPP is not insttalled on your IBM i, co
ontinue with the steps in the sectio
on Downloa
ad the IBM
Tools foor Develope ers for i5/OOS LPP on page 51.
___
___ If the LPP is installed on your IB
BM i, continue with the steps in the next section to verify
y that you
have thee current version of the tools.

Che
eck for th
he vncser
rver_java
a file (5799PTL allready ins
stalled)
Why y: If you alrready have the
t 5799PTLL LPP installled on your system, you need to verify that th
he version
that is installed includes the Virtual Ne
etwork Comp puting (VNCC) server, w
which is used
d when you run the
Java
a–based Datta Transfer on o your IBM M i.

___
___ Navigate
e to the follo
owing directtory in your IBM i IFS:

/QOpenSys
s/QIBM/ProdDa
ata/Developer
rTools/vnc

___
___ In that directory,
d loo
ok for the vncserver_ja
ava file, as s
shown in Fig
gure 56.

iac142

Figurre 56: Look for

fo the vncserrver_java file
e.

___
___ If the file
e is not in th
he directory
y, you need to download d the currennt version of the IBM TTools for
Develop pers for i5/ /OS LPP. Usse the steps
s in the nextt section to download aand install th
he current
version.

___
___ If the file
e is in the directory, go to the secttion Work w
with the VN
NC Server o
on page 57 and
continue e with the stteps in that section.

50
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Dow
wnload th
he IBM Tools
T for Develope
ers for i5 /OS LPP

Why y: The IBM Tools for Developers

D s for i5/OSS LPP is distrributed via a
an IBM web bsite. The co
ode that you
u
will d
download is s a save file image that you will sub
bsequently upload to yo our IBM i to
o complete tthe
instaallation of th
he tools.

___
___ The IBM
M Tools for Developer rs for i5/OS S LPP is disttributed as a ZIP file th
hat contains a save file
image an
nd a readme.txt file of instructions
i . To obtain the ZIP file,, navigate too the follow
wing URL:

http://www14.softw
ware.ibm.com
m/webapp/d
download/se
earch.jsp?rss=iseriest

___
___ You shou
uld a web pa
age similar to what is shown
s in Fig
gure 57 (scrreen capture
e taken on 2
2012-09-
03).

___
___ If you do
o not see a web
w page th
hat includes
s a link to do
ownload the
e Tools for Developerrs, go to the
e
main IBMM web site (http://www
( w.ibm.com) and enter t he search teerm 5799PTLL. From the results
page, naavigate to th
he downloadd page.

___
___ Click the
e link (on the
e page, it is
s labeled iSe
eries Tools
s for Develo
opers).
Note: th
he Version shown on the page is V5
5R4M0. Thiss download is also used
d for later re
eleases
(V6R1M00 and V7R1M M0 when this document was prepa
ared).

iac151

Figurre 57: This is

s the landing page to down
nload the Too
ols for Develo
opers.

51
1
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
___
___ The nextt page that is displayed
d is shown in
n Figure 58.. Click the C
Continue lin
nk.

iac152

Figurre 58: Click th

he Continue button to sta
art the downlo
oad process.

___
___ You are prompted too enter yourr IBM User ID
I and Passsword, as shhown in Figu ure 59. If yo
ou do not
have an IBM User IDD, you can click
c the reg
gister here
e link on thiss page to crreate an ID. There is no
o
charge to
o create and
d use your ID
I for the purposes of tthis downloa ad.

iac153

Figurre 59: You arre asked to siign in with yo

our IBM ID. Iff you do not have an IBM
M ID, you can create an ID
D (register) on
n
this p
page.

52
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
___
___ After enttering your IBM user ID
D and passw
word, you arre taken to a page that asks you fo
or some
informattion, shown in Figure 60
0.
You are required to click the I agree
a check
kbox on thiss page to co
ontinue, the
en click the I confirm
link.

iac154
4

Figurre 60: You ne

eed to click th
he "I agree" checkbox
c to download
d the
e software.

53
3
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
___
___ You are taken
t to the
e download page, show
wn in Figure 61. You can
n use eitherr the Downlo
oad Directorr
or Download using HTTP
H to dow
wnload the ZIP
Z files.
See the previous de
escription for the downlo
oad optionss:

Download
D using
u the Download
D Director
D on
n page 10

Download
D using
u HTTP
P on page 12
2

___
___ Download the ZIP file to a direc ur workstati on.
ctory on you

iac155

Figurre 61: You ca

an use the Do
ownload Direc
ctory or Down
nload using H
HTTP optionss.

54
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Ins
stall the IBM
I Tools
s for Dev
velopers for
f i5/OS
S LPP

Why y: The ZIP file

f that you downloaded from the IBM web sitte contains a save file image and a readme.txt t
file. You need to ose files from the ZIP and
o extract tho a work th e files to insstall the too
ols on your IIBM.

___
___ On your workstation t the directory where you downlo
n, navigate to oaded the ZIIP file for th
he IBM
Tools fo
or Developeers for i5/OOS (file nam
me q5799ptl p).
l_v5r4m0.zip

___
___ Extract all
a of the file
es from the ZIP into a directory.
d Yo
ou can extra
act the files into the sam
me
directory
y where the ZIP file is lo
ocated.

___
___ Verify that the list of
o extracted files looks like the list sshown in Fig
gure 62.
he dlmgr.pro
Note: th o file is pres
sent only if you
y used th e Download
d Director. T
The file is no
ot needed
and mayy be delete.

iac161

Figurre 62: This sh

hows what th
he contents of the q5799p
ptl_v5r4m0.ziip file contain
ns after you e
extract all of the files.

55
5
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
___
___ Open the
e readme.txt
t file. The contents of the
t file are sshown in Fig
gure 63.
___
___ Follow th
he steps tha
at are descriibed in the readme.txt
r ffile to perform the follo
owing:
 Creatte save file QGPL/Q5799P
PTL on your IBM i

 FTP the
t save file
e image (q57 m0.savf) to the save file
799ptl_v5r4m

 Insta
all the 5799P
PTL LPP from
m the save file
f

iac162

Figurre 63: The re

eadme.txt file
e contains ins
structions on uploading the
e save file im
mage to a sav
ve file on you
ur IBM i, and
resto
oring the LPP from the savve file.

___
___ After you
u complete the
t RSTLICPGM step, use
e the steps sshown in th
he section Use the Disp play
Installe
ed Licensed d Programs s program to check fo or the LPP on page 49 9. Verify tha
at the
5799PTL L LPP is insta
alled, as sho
own in Figurre 55 on pagge 49.

56
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Work with the VNC Server
Why:

The IBM i Access Client Solutions product is designed to be used in a workstation environment, which
provides a graphical user interface (GUI). When you run the ACS programs, the Java code in the product
displays status messages and dialogs using Java GUI features.

When you run the ACS Data Transfer program on the IBM i, there is no support for the Java GUI. If you
simply try to run the Data Transfer program on the IBM i, it ends in error.

In some cases, you can run Java code on the IBM i and indicate that you do not want to use the GUI. That
is referred to as running in headless mode. You can find a description of that mode in the IBM Developer
Kit for Java documentation at this link:

http://publib.boulder.ibm.com/infocenter/iseries/v7r1m0/index.jsp?topic=%2Frzaha%2Fnawtsupport.htm

It would be ideal if the ACS programs could use headless mode, as using it is as easy as adding a
command line parameter to the java command (java.awt.headless=true). Unfortunately, even if you add
that parameter value to the java command, the program ends in error.

The alternative is to use what IBM calls the Native Abstract Windowing Toolkit (NAWT) that is also
described in the IBM Developer Kit for Java documentation at this link:

http://publib.boulder.ibm.com/infocenter/iseries/v7r1m0/index.jsp?topic=%2Frzaha%2Fguiintro.htm

The ACS programs will run on your IBM i when you configure NAWT. The NAWT support is provided by
using the Virtual Network Computing (VNC) server that is part of the IBM Tools for Developers LPP. The
VNC server runs in the IBM i Portable Application Solutions Environment (PASE), which provides support
for running AIX applications in the IBM i environment.

After installing and configuring the VNC server on your IBM i, you will work with a VNC viewer on your
workstation. When you use the ACS programs, the output of the programs is directed through the VNC
server to the VNC viewer.

Although it may sound very complicated to work with the tools, there are only a few steps that you need
to do to get everything installed and configured. The steps are shown in the following sections. Once you
have the VNC server and VNC viewer configured, you can use the ACS Data Transfer programs directly on
your IBM i.

57
Run IBM i Access Client Solutions Data Transfers on the IBM i
Copyright © 2012, Craig Pelkie, ALL RIGHTS RESERVED
Che
eck to see
e if the VNC
V serve
er is alrea
ady runn
ning

Why y: If the IBM

M Tools for
r Develope ers LPP was already insstalled on yo
our IBM i, th
he VNC serv ver might
alrea
ady be configured and running. If the
t server is
s already ru
unning, you need to wo ork with the existing
server environmment.

___ If you just installed the IBM To

___ ools for Developers, y VNC servers running, so
you will not have any V o
you can skip ahead to the section Create the t VNC pa
assword fille on page 662. You can
n also work
through the steps in n this section if you wan
nt to.

___
___ On a 52550 command line, enter the followiing CALL com
mmand to sstart the PAS
SE shell (the
e PASE shelll
is where you will enter the com
mmands to work
w with th e VNC serve
er):

CALL QP2T
TERM

___
___ The PASE shell is dis
splayed. It provides
p a command
c en
ntry display
y that is similar to the c
command
line display used to enter IBM i commands.

___
___ Enter the
e following PASE
P comm
mand to display any currrently active
e VNC serve
ers.
Note: all commands
s that are used in the PASE
P enviro nment are ccase–sensitive.

ps gaxuw | grep Xvnc

___
___ If there are ve VNC servers, you will see the ou
a no activ utput shown
n in Figure 6
64.

iac171

Figurre 64: This is

s what the ou
utput of the ps
s command looks
l like whe
en there are no active VN
NC servers.

58
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
___
___ If there is
i at least one active VN
NC server, you
y will see output similar to whatt is shown in
n Figure 65.
If any VN
NC servers are
a active, make
m a notee of the high
hest server instance nu
umber. The server
instance number is preceded by
y a colon (:) character.. You need tto know the
e highest serrver
instance number so that you ca
an start another VNC se erver using the next hig
gher numbe er.

Note: soome of the data

d he figure ha s been obsccured. You w
that is shown in th will see morre data
following
g the –deskt
top text, the
e data that is obscured is not releva
ant here.

iac172

Figurre 65: This is

s what the ou
utput of the ps
s command looks
l like whe
en at least on
ne VNC serve
er is running. The VNC
serveer instance number is 1.

59
9
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
What is the ps command and what do the gaxuw options mean?
The ps command, used in the PASE environment, displays the status of processes. It is similar to the IBM i
WRKACTJOB command.

The gaxuw options that are used on the command are a set of five individual options. The options are
described in the following IBM document, in the section titled Options:

http://publib.boulder.ibm.com/infocenter/pseries/v5r3/index.jsp?topic=/com.ibm.aix.cmds/doc/aixcmds4/
ps.htm

The options are used as follows. The descriptions of the options are from the IBM document linked to
above:

g — displays all processes

a — displays information about all processes with terminals (ordinarily only the own processes of
the user are displayed)

x — displays processes without a controlling terminal in addition to processes with a controlling

terminal

u — displays user–oriented output. This includes the USER, PID, %CPY, %MEM, SZ, RSS, TTY,
STAT, STIME, TIME and COMMAND fields.

w — specifies a wide–column format for output (132 columns rather than 80).

60
Run IBM i Access Client Solutions Data Transfers on the IBM i
Copyright © 2012, Craig Pelkie, ALL RIGHTS RESERVED
Wha
at does the
e grep com
mmand do?
The grep command searche
es for a patttern in a file
e.

The output of th
he ps command is piped
d to the grep command d, using the vertical barr (|) charactter. In other
word
ds, the outp
put of the ps
s command is the input to the grep
p command.

In th
he command
d that you entered,
e the was Xvnc. That pattern is used to identify the
e pattern to search for w
VNC servers.

If yo
ou run the ps gaxuw com e the outputt to grep, the resulting output migh
mmand and do not pipe ht look like
whatt is shown in Figure 66.

iac173

Figurre 66: This sh

hows the outp
put of the ps gaxuw comm
mand when tthe grep comm
mand is not used.

61
1
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Cre
eate the VNC
V pass
sword file
e
Why y: To use th
he Native Ab bstract Winddowing Toolk kit (NAWT) support, yo
ou must starrt a VNC serrver. The
VNC server thatt you start requires
r a VNC
V passworrd so that th wer can connect to the server. In
he VNC view
this section, you
u will create
e the directo
ory that will contain the
e VNC passw
word.

___
___ In the Sy
ystem i Nav n the Root file system.
vigator, go to the /home directory in

___
___ In the /h
home directory, identify the user pro
ofile name tthat you will use to starrt the VNC s
server.

In Figure
e 67, the user profile na
ame is CRAIG
GP.

On your IBM i, the list of subdirrectories in the /home d irectory willl obviously b
be different from what
is shown
n in the figurre.

iac181

Figurre 67: Identiffy the user prrofile name in

n the /home directory.

___
___ In the Sy
ystem i Nav
vigator, right–click the user
u profile that will be used to sta
art the VNC server.
Select th
he New Foldder item froom the pop– –up menu, a as shown inn Figure 68.

iac182

Figurre 68: Right-c

click the userr profile to us
se for the VNC, select New
w Folder from
m the pop-up menu.

62
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
___
___ The New
w Folder dia
alog (shown
n in Figure 69)
6 is displa yed. Enter tthe new fold
der name as
s:

.vnc

(note the
e leading pe
eriod charac
cter)

___
___ Click the
e OK button to create th
he folder.

iac183

Figurre 69: Enter the

t new folde
er name value as .vnc.

63
3
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Cre
eate the VNC
V pass
sword
Why
y: You need to enter the VNC password before
e you can co
onnect to th
he VNC serv
ver.

___
___ Enter the
e following command
c on a 5250 co
ommand line
e:

QAPTL/VNC
CPASSWD PASSW
WORD(your_vnc
c_password)
VERIF
FY(your_vnc_p
password)
USEHO
OME(*NO)
PWDFI
ILE(‘/home/yo
our_user_prof
file_name/.vn
nc/passwd’)

Where:

yo ssword is the
our_vnc_pas assword to assign.
e case-sensiitive 6 to 8 ccharacter pa

yo rofile_name is the name

our_user_pr e of your su
ubdirectory iin the /home
e directory

Note: th
he QAPTL librrary is the library where
e the IBM T
Tools for Developers LPP is insta
alled.

Note: do
o not use yo
our IBM i us
ser profile pa
assword as the VNC server passwo
ord.

___
___ When do
one, verify that the pass ubdirectory, as shown in Figure 70.
swd file is in the .vnc su

vnc184
4

Figurre 70: Verify that the pass

swd file is con
ntained in the .vnc subdirrectory.

Note
es

 The pass
sword that you
y enter on
n the VNCPAS
SSWD comma
and is encry
ypted within the passwd file.
 If you forget the pas
ssword valu
ue, delete th
he passwd file
e, then run the VNCPASS
SWD comman
nd again.

64
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Start the VN
NC sever — Initial Start
Why y: If you are
e working with
w a new VNC
V server (that
( is, you
u did not preeviously havve a VNC se erver
conffiguration on
n your IBM i),
i you need d to start thee VNC serveer so that it can build some files th
hat it needs..
Starrting the VNC server als
so lets you verify
v that the server caan be starteed.

___
___ Enter the
e following command
c on a 5250 co
ommand line
e:

QAPTL/STR
RVNCSVR NAME(
(ACS)

___
___ A termin
nal session display
d open
ns. You will see
s ges similar to those sho
messag own in Figure 71.
Note: soome of the text
t that is displayed
d in
n the termin
nal session iss omitted frrom the figu
ure. Text
that iden
ntifies the IB
BM i that thee command was run on n is omitted in the line tthat begins New ꞌACS’’
desktop p is and the line that beegins Log fiile is.

___
___ Press the
e Enter key
y to end the terminal se
ession and rreturn to the
e 5250 command line.

Note: en
nding the te
erminal sess
sion does no
ot end the V
VNC server..

iac191

Figurre 71: Theses

s status mess
sages are dis
splayed when you use the STRVNCSVR
R command.

65
5
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Verrify that the
t VNC server
s is running
Why
y: This step will prove that
t the VNC
C server tha
at you starte
ed in the prrevious step is active.

___
___ On a 525
50 command line, enter the followiing CALL com
mmand to sstart the PAS
SE shell:

CALL QP2T
TERM

___
___ Enter the
e following PASE
P comm
mand to display any currrently active
e VNC serve
ers.

ps gaxuw | grep Xvnc

___
___ You shou
uld see that the VNC se
erver is activ
ve, as show
wn in Figure 72.

___
___ The instaance numbe er is the num
mber on the
e third line o
of text that iis preceded by the colo
on (:)
characte
er. You will use
u the insta ance numbeer with the EENDVNCSVR co ommand, de escribed in the next
section.

___
___ When do
one, press th
he F3 key to
o return to the 5250 co
ommand line
e.

iac192

Figurre 72: Use th

he ps comman
nd to verify that
t the VNC server is run
nning.

66
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Sto
op the VN
NC server
Why
y: You will le
earn how to
o stop the VNC server.

___
___ Enter the
e following command
c on a 5250 co
ommand line
e:

QAPTL/END
DVNCSVR INSTA
ANCE(1)

Where th
he value tha
at you enterr for the INS
STANCE param
meter is the
e instance number of th
he active
VNC serv
ver (see Figure 72).

___
___ A termin
nal session display
d open
ns. You will see
s ges similar to those sho
messag own in Figure 73.

Note: th
he messages s that are sh
hown in Figure 73 inclu
ude the messsages from the STRVNCSSVR
command that you entered
e earlier. The me
essage for the ENDVNCSV
VR command d starts with
h the line
that begins Killing Xvnc.
X

Note: soome of the text

t that is displayed
d in
n the termin
nal session iss omitted frrom the figu
ure. Text
that iden
ntifies the IB
BM i that thee command was run on n is omitted in the line tthat begins New ꞌACSꞌꞌ
desktop p is and the line that beegins Log fiile is.

___
___ Press the
e Enter key
y to end the terminal se
ession and rreturn to the
e 5250 command line.

iac193

Figurre 73: You wiill see the “Kiilling Xvnc” message

m when
n you use the
e ENDVNCSV
VR command.

___
___ Use the steps shownn in the secttion Verify that the V
VNC server is runningg on page 66
6 to verify
that the VNC serverr is ended (y
you should not
n see it in the process list).

67
7
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Rev
view files
s that we
ere create
ed by starting the
e VNC serrver

Whyy: When you u start the VNC

V server the first tim
me, it creates files in your /home dirrectory and in the .vnc
subd
directory. If you decide to not use the VNC serrver for a usser profile, yyou may wa ant to removve the files
from
m the user /home directoory and the .vnc subdire ectory.

___
___ In the Sy
ystem i Nav
vigator, go to your userr directory in
n the /home subdirectorry.

___
___ When yo ou start the VNC serverr the first tim
me, two filess are added to your use
er directory, as shown
in Figure
e 74:

.sh_histo
ory

.Xauthority

iac194
4

Figurre 74: The .sh

h_history and
d .Xauthority
y files are add
ded to the us er directory w
when you sta
art the VNC s
server.

68
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
___
___ Click the
e .vnc subdirrectory to display its co
ontents.

___
___ When yoou start the VNC serverr the first tim
me, two filess are added to the .vnc
c subdirectory, as
shown in
n Figure 75:

.log (a file that end

ds with the .log extens
sion, name is based on your IBM i T
TCP/IP hostt name)

xstartup
p

Note: so
ome of the text
t that is displayed
d in
n Figure 75 iis omitted. T
Text that identifies the IBM i that
was used
d to get the screen capture is omittted in the n
name of the .log file.

iac195

Figurre 75: The .lo

og file and the xstartup fille are added to the .vnc su
ubdirectory.

69
9
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Start the VN
NC Server
r — Produ
uction Sttart

Whyy: Now that you’ve insttalled, starte

ed, ended and verified tthe VNC serrver, you ca
an start it fo
or
prod
duction use.

___
___ Enter the
e following command
c on a 5250 co
ommand line
e:

QAPTL/STR
RVNCSVR NAME(
(ACS)

___
___ The VNC
C server starrts, as descrribed in the section Sta
art the VNC
C sever — I
Initial Starrt on page
65.

Worrking with the VNC se

ever in a production environme
ent
If yoou plan to use the ACS Data Transffer program
ms on the IB M i on a reg
gular basis, you will pro
obably find
it to be most coonvenient to
o start the VNC
V server and
a leave it running.

The STRVNCSVR and

a VR command
ENDVNCSV ds can be ru
un in a batcch environment.

Figure 76 shows
s the spool file
f output that
t is creatted when yo
ou run the ST
TRVNCSVR co
ommand in b
batch.

Notee: some of the

t text tha
at is displaye
ed in the spool file is om
mitted from Figure 76. Text that id
dentifies the
e
IBM i that the command wa as run on is omitted in the line tha at begins Ne
ew ꞌACSꞌ deesktop is a and the line
that begins Logg file is.

iac198

Figurre 76: This is

s the spool file
e output whe
en the STRVN
NCSVR comm and is run in batch.

70
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Figure 77 shows
s the spool file
f output that
t is creatted when yo
ou run the ENDVNCSVR co
ommand in b
batch.

Note
e: the proce
ess ID show
wn in the figu
ure (2360) may
m be diffe you run the command on your
erent when y
IBM i.

iac199

Figurre 77: This is

s the spool file
e output whe
en the ENDVN
NCSVR comm
mand is run in
n batch.

Ope
en firewa
all ports used
u by the
t VNC server
s
Whyy: If your IB
BM i is behin
nd a firewall, you may need
n to ope
en one or moore ports in the firewall so that
you can access the VNC server from th he VNC view
wer programm (described
d in the nextt section).

___
___ If your workstation
w is not in the
e same netwwork as you r IBM i (for example, iff you are accessing
your IBMM i remotely via an Inteernet connec
ction), or if your IBM i iis protected
d by an interrnal firewall,
you will need to ope
en one or more ports.

___
___ The port(s) that you
u need to op
pen are in th
he 580x ran
nge, where “x” is a digit from 1 to 9.

___
___ The value of “x” that you speciffy is based on
o the VNC server insta
ance numbe
er. See Figure 72 on
page 66 for an exammple of how to find the VNC serverr instance number.

___
___ Using Fig
gure 72 as an
a example,, you would need to op en port 580
01 in your ffirewall to acccess the
VNC servver.

71
1
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Wo
ork with
h the VN
NC Viewer
Whyy: To work with
w the VNC server, yoou need a VNC
V viewer p
program on your works station. You can use
any VNC viewerr program thhat you wan
nt. The steps shown in tthis section describe ho
ow to use thhe browser–
–
base
ed VNC view
wer that is provided with
h the VNC server.
s

___
___ Before sttarting, iden
ntify the VNC server ins
stance numb
ber that youu will be wo
orking with. See Figure
72 on pa
age 66 for an example of o how to fin
nd the VNC server insta
ance numbe er.

___
___ Open your browser and enter a URL in the following fo
ormat:

http:/
//ibm_i_h
host_name
e:580x

or
o

http:/
//ibm_i_t
tcp_ip_ad
ddress:58
80x

Where:

ib name is the TCP/IP

bm_i_host_n T host name of your IBM i

ib p_address it the TCP/IP address of your IBM i

bm_i_tcp_ip

80x is the po
58 ort number of the VNC server. The
e “x” value iis a digit fro
om 1 to 9 th
hat
co
orresponds to the VNC server insta
ance numbe
er.

In Figure
e 78, the po
ort number specified
s is 5801.

___
___ The browwser display mation mes sage shown
ys the Security Inform n in Figure 7
78. Click the
e Run
button to
o continue.

vnc241

Figurre 78: Open your

y browserr to the VNC port
p on your IBM i, allow the applicatio
on to run.

72
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
___
___ You mayy see the Wa arning – Se
ecurity me essage showwn in Figure 79. If you g
get this mes
ssage, click
the No button
b to allow the application to ru
un (the Yes
s button blocks the appplication).

iac242

Figurre 79: If you get this Secu

urity message
e, click the No
N button to ccontinue.

___
___ The VNCC Viewer – Connectio on Details panel
p shownn in Figure 8
80 is display
yed. The Server value
may alre
eady be filled in; if it is, click OK to
o accept the
e value.

___
___ If the Se
erver value is not filled in, enter it in the form
mat

vnc_serve
er_name:insta
ance

Where vn name is the name

nc_server_n n erver instance number.
of your IBM i and instance iss the VNC se

iac243

Figurre 80: If nece

essary, speciffy the VNC se
erver and ins
stance numbe
er to connectt to.

73
3
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
___
___ The VNC
C Authentication panel shown
s in Fig
gure 81 is d isplayed.

___
___ Enter the
e VNC serve
er password that you crreated earlie
er (see the section Cre
eate the VN
NC
password on page 64).

___
___ Press En
nter after yo
ou enter the
e password.

iac244
4

Figurre 81: Enter the

t password
d that you ass
signed to the
e VNC server..

___
___ The VNC
C viewer pan
nel shown in
n Figure 82 is displayed
d. Leave the
e panel open
n on your wo
orkstation
desktop.

iac245

Figurre 82: The VN

NC viewer win
ndow is displlayed.

74
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Sta
art the Data
D Tra
ansfer program
p m on the
e IBM i
Why y: You now have everytthing configured to worrk with the D
Data Transffer program on the IBM M i. In this
section, you will start the Data
D Transfe
er program on your IBM
M i for the first time, an
nd handle so
ome of the
tasks that need to be done the first tim
me you run the program
m.

Che
eck for en
nvironme
ent variab
bles
Whyy: There aree two enviro
onment varia ables that are
a needed tto run the A ACS Data Transfer program. When
you start the Java application for the Data
D Transfe
er, the valuees assigned to the enviironment vaariables are
used
d in the Java
a environme ent. If the environmentt variables aare already d
defined, youu need to re
emove the
environment variable or change its vallue to the va alue require
ed by the Daata Transferr program.

___
___ On a 525
50 command line, enter the followiing comman
nd:

WRKENVVAR
R

___
___ The Wor rk with Env vironment Vars displa
ay (Figure 8
83) show the ent variables associated
e environme d
with the interactive job.

iac221

Figurre 83: The Work

W with Environment Varrs display sho
ows the envirronment varia
ables for you
ur interactive job.

75
5
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Remove environment variable(s)
Why: If the environment variable(s) that are needed by the Data Transfer program are already in use,
you can remove the variable(s) or change its value. This section shows how to remove the environment
variable(s).

_____ On the Work with Environment Vars display (Figure 83), look for an environment variable
named DISPLAY and an environment variable named XAUTHORITY.

_____ If the DISPLAY and XAUTHORITY environment variables are not defined, go to the section Add
environment variables on page 78.

_____ Make a note of the current value of the DISPLAY or XAUTHORITY environment variables.

_____ You can either remove and add the environment variables, or you can change the value of the
existing DISPLAY and XAUTHORITY environment variables.
If you want to change the existing value of the existing environment variables, go to the section
Change environment variable(s) on page 77.

_____ Use either of the following steps to remove the existing environment variables.
Note: use the steps shown here to remove the DISPLAY and XAUTHORITY environment variables only.
Do not remove any other environment variables that are shown in the WRKENVVAR display.

____ Use option 4 (Remove) on the WRKENVVAR panel to remove the environment variable.

____ Enter the command RMVENVVAR ENVVAR(DISPLAY) or RMVENVVAR ENVVAR(XAUTHORITY)

on a 5250 command line.

_____ Continue with the steps in the section Add environment variables on page 78.

76
Run IBM i Access Client Solutions Data Transfers on the IBM i
Copyright © 2012, Craig Pelkie, ALL RIGHTS RESERVED
Change environment variable(s)

Why: If the environment variables DISPLAY or XAUTHORITY are already defined, you can use the Change
Environment Variable (CHGENVVAR) command to set the value that is required by the ACS Data Transfer
program.

_____ Use either of the following steps to change the existing environment variables DISPLAY and
XAUTHORITY.

____ Use option 2 (Change) on the WRKENVVAR panel to change the value.

____ Use the Change Environment Variable (CHGENVVAR) command on a 5250 command line.

_____ Set the values of the environment variables as follows.

Environment Variable Value

DISPLAY ibm_i_host_name:vnc_instance_number

or

ibm_i_tcp_ip_address:vnc_instance_number

Where vnc_instance_number is the instance number

assigned when you started the VNC server (see Figure
72 on page 66 for an example of determining the
instance number).
/home/your_user_profile_name/.Xauthority

XAUTHORITY For your_user_profile_name, enter the name of the

user profile where the .Xauthority file is located (see
Figure 74 on page 68).

77
Run IBM i Access Client Solutions Data Transfers on the IBM i
Copyright © 2012, Craig Pelkie, ALL RIGHTS RESERVED
Add environment variables

Why: The ACS Data Transfer program uses two environment variables named DISPLAY and XAUTHORITY.
The values of the environment variable point to the VNC server and its configuration.

_____ Enter the following commands on a 5250 command line:

ADDENVVAR ENVVAR(DISPLAY) VALUE(ꞌibm_i_host_name:vnc_instance_numberꞌ)

or

ADDENVVAR ENVVAR(DISPLAY) VALUE(ꞌibm_i_tcp_ip_address:vnc_instance_numberꞌ)

ADDENVVAR ENVVAR(XAUTHORITY) VALUE(ꞌ/home/user_profile_name/.Xauthorityꞌ)

Notes

 Enter the environment variable names in upper–case, as shown in the commands above.
 The vnc_instance_number is the instance number assigned when you started the VNC server (see
Figure 72 on page 66 for an example of determining the instance number).
 For your_user_profile_name, enter the name of the user profile where the .Xauthority file is located
(see Figure 74 on page 68).

IMPORTANT!
The values that you enter for the environment variables in your 5250 session are not
persistent. When you sign-off from your 5250 session, the values for the environment variables
are not kept.
The next time you sign on to a 5250 session, you need to add the environment variables.
If you will be running Data Transfers frequently from your 5250 session, you may want to
consider adding the ADDENVVAR commands to your start up program.

IMPORTANT!

78
Run IBM i Access Client Solutions Data Transfers on the IBM i
Copyright © 2012, Craig Pelkie, ALL RIGHTS RESERVED
Start the Data Transfer program
Why: You can now run the Data Transfer program. For the first test, you will run the java command in the
QSHELL environment.

_____ Verify that the VNC viewer application is still running on your workstation. If it is not running, start
it and connect to the VNC server running on your IBM i. (See the section Work with the VNC
Viewer on page 72.)

_____ On a 5250 command line, enter the QSH (Start QSHELL) command.

_____ The QSH Command Entry panel is displayed.

_____ Enter the following command on the QSH Command Entry line.

Note: the command is case–sensitive, enter it as shown.

Note: the value for the os400.class.path.security.check parameter is zero, not the letter “O”.

Note: for the /userid parameter, enter the name of your user profile. This must be the same user
profile name that you used to start the VNC server.

Note: enter the entire command on one line in the QSH Command Entry panel. The line will “wrap”
on the Command Entry panel as you type it in. The command text shown in this example is
wrapped on this page.

java –jar /IAC/acsbundle.jar -Dos400.class.path.security.check=0

/PLUGIN=download /file=/IACXFER/xqcustcdt.dtfx
/userid=your_user_profile_name

79
Run IBM i Access Client Solutions Data Transfers on the IBM i
Copyright © 2012, Craig Pelkie, ALL RIGHTS RESERVED
___
___ The java
a command might take a few seconnds to start.. You should
d see the En
nd User Lic
cense
Agreemment display
yed in the VN
NC viewer, as
a shown inn Error! Refference source not fo ound..

iac231

Figurre 84: When you run the java

j comman
nd to start the Data Transsfer, the End User License
e Agreement iis displayed
in the
e VNC viewerr.

80
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
___
___ Use the scroll bar on
n the right side
s of the License
L Ag reement wwindow to sccroll to the e
end of the
License Agreement.
A When you get to the ende of the ag
greement, tthe Yes buttton is enabled.

___
___ Click the
e Yes button
n to accept the
t agreement. If you d
do not acce
ept the agree
ement, the Data
Transfer program will not run.

___
___ After you
u accept the
e agreementt, you can close
c the VN
NC viewer window and tthe browserr window
that you used to ope
en the viewer.

iac232

Figurre 85: Scroll to the end off the License Agreement, click the Yes button to acccept the agre
eement.

81
1
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
___
___ After you
u accept the
e agreementt, the Data Transfer pro
ogram that is running in the QSH C
Command
Entry panel promptss for your IB
BM i user ID
D, as shown in Error! R
Reference ssource not found..

___
___ Enter your IBM i use
er ID and prress Enter.

iac233

Figurre 86: Enter your

y IBM i us
ser ID when prompted.
p

___
___ You are prompted to
o enter yourr IBM i pass
sword, as sh
hown in Erro
or! Referen
nce source
e not
found..

___
___ Enter your IBM i pas
ssword and press Enter.

iac234
4

82
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Figurre 87: Enter your
y IBM i pa
assword when
n prompted.
___
___ The Data
a Transfer program
p runs. The mess
sages show n in Figure 45 are displayed when the
program ends.

___
___ Press the
e F3 (Exit) function
f key
y to close th
he QSH Com
mmand Entry
y panel.

iac235v2

Figurre 88: The Da

ata Transfer program
p runs
s and display
ys the messag
ges shown he
ere.

___
___ In the Sy
ystem i Nav
vigator, go to the output directory tthat you speecified (see the ClientF
File item in
n
Figure 42
2 on page 30).
3 In this example,
e th
he output dirrectory is IF
FS directory /IACOUT.

___
___ The qcus
stcdt.csv file is the output from the Data Tran
nsfer progra
am.

___
___ Copy the
e qcustcdt.c
csv file to yo
our workstation and op
pen it. You sshould see the same output as you
saw wheen you ran the Data Tra ansfer on yo
our workstattion, as show e 28 on pag
wn in Figure ge 21.

iac236
83
3
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
Figurre 89: The qc
custcdt.csv fille is in the ou
utput directorry used by th
he Data Transsfer program.Run the Datta Transfer
progrram — Pass 2
Whyy: The first time
t you ran the Data Transfer
T proogram, you were prompted to acce ept the License
Agre
eement. You u also had to en you run tthe Data Transfer
o enter yourr IBM i userr ID and passsword. Whe
again, you will not
n need to do either off those task ks.

___
___ Delete th he /IACOUT/q sv file from the
qcustcdt.cs t IFS. You
u can use th
he System i Navigator tto delete
the file.

___
___ Verify that the VNC viewer application is sttill running o
on your worrkstation. Iff it is not run
nning, start
onnect to the
it and co e VNC serve
er running ono your IBM i. (See the section Wo ork with th he VNC
Viewer on page 72.)

___
___ On a 525
50 command line, enter the QSH (S
Start QSHEL L) command
d.

___
___ The QSH
H Command Entry panel is displaye
ed.

___
___ Enter the
e following command
c on the QSH Command
C E
Entry line.

Note: th
he command
d is case–se
ensitive, enter it as sh
hown.

java –jar /I
IAC/acsbu
undle.jar
r -Dos40
00.class.
.path.sec
curity.ch
heck=0

/PL
LUGIN=dow
wnload /file=/IA
/ ACXFER/xq
qcustcdt.
.dtfx
/userid=you
ur_user_p
profile_n
name

iac237

Figurre 90: The Da

ata Transfer program
p disp
plays the mes
ssages shown
n here when you run it the second time.

___
___ The Lice
ense Agree
ement pane
el is not disp
played in the
e VNC viewe
er.

___
___ Use the System i Na
avigator to verify
v that file
f /IACOUT/ sv has been
/qcustcdt.cs n created.

84
Run IBM i Access
s Client Solutions Datta Transferrs on the IB
BM i
Copyrightt © 2012, Craiig Pelkie, ALL R
RIGHTS RESER
RVED
END OF DOCUMENT

85
Run IBM i Access Client Solutions Data Transfers on the IBM i
Copyright © 2012, Craig Pelkie, ALL RIGHTS RESERVED
86
Run IBM i Access Client Solutions Data Transfers on the IBM i
Copyright © 2012, Craig Pelkie, ALL RIGHTS RESERVED