|
|
|
|
CommuniquéIf you downloaded Communiqué from the Internet, or received the product via e-mail, you will have received a zip file called CMNQUEV1r1.zip. This zip file contains everything you need to get started with Communiqué.
This section describes two possible procedures for installing Communiqué on your iSeries, one using FTP and one using the IFS and a network drive.
Steps to be carried out on the PC are shown in green, steps to be carried out on the iSeries in blue.
This method uses FTP (File Transfer Protocol) to transfer the Communiqué product files from your PC to your iSeries. It is assumed that you have stored the CMNQUEV1R1.zip file which your downloaded from the Internet or received via e-mail on your PC and that you have enabled an FTP link between your PC and your iSeries.
Step 1
On your PC, create an install directory for Communiqué, either within Windows Explorer, or from the DOS prompt, e.g.:
md c:\CMNQUE
Save or copy the zip file that you downloaded or received into this directory.
Step 2
On your PC, unzip the contents of the zip file into the directory you just created using pkunzip, WinZip, Norton UnZip etc.
Step 3
On your iSeries, decide which library you wish to use for the install procedure and create a save file in that library, e.g.
crtsavf lib_name/CMNQUE
where lib_name is the name of the library you chose to use.
Step 4
On your PC, start an FTP session to your iSeries. You may use FTP packages such as CuteFTP or simply go to the DOS prompt and type:
ftp AS400_name
where AS400_name is the name of your iSeries.
You will be prompted to enter your user id and password. Please ensure that you sign on with a user id that has adequate authority. We recommend that you sign on as the Security Officer QSECOFR.
Issue the following FTP commands within the FTP session:
binary
This command instructs FTP not to carry out any conversion on the data to be sent to the iSeries.
quote site na 0
This makes sure the iSeries is using naming format 0 (library naming). This is important if your FTP attributes (CHGFTPA command NAMEFMT parameter) have the initial naming format set to *PATH (IFS path naming) rather than *LIB (library/file.member naming).
cd lib_name
where lib_name is the name of the library in which your created the save file in Step 3. This command makes lib_name your current library on the iSeries.
lcd dir_name
where dir_name is the name of the directory on your PC in which you unzipped the install files earlier. This command makes dir_name your current directory on the PC.
put CMNQUEV1R1.sav CMNQUE
This command transmits the contents of the file CMNQUEV1R1.sav, which was earlier unzipped from CMNQUEV1R1.zip, and stores them in the save file called CMNQUE which you created earlier on your iSeries.
Step 5
On your iSeries, ensure that the previous step worked by displaying the contents of save file CMNQUE:
dspsavf lib_name/CMNQUE
If you see the message (No records in save file) then something has gone wrong during the preceding steps. Try following them again. If you still cannot get this procedure to work, contact us at support@ariadnesoftware.co.uk.
Step 6
On your iSeries, issue the following command to restore the Communiqué licensed program to your system:
rstlicpgm licpgm(1CMNQUE)
dev(*savf)
option(*base)
rstobj(*all)
lng(*primary)
output(*none)
rls(*first)
replacerls(*only)
savf(lib_name/CMNQUE)
where lib_name is the name of the library in which your created the save file in Step 3.
Step 7
If you are installing on OS/400 V5R3M0 or above, run the following command to change the *RSTDRNMUNL attribute of the /tmp directory where Communiqué builds its temporary MIME file:
CHGATR OBJ('/tmp') ATR(*RSTDRNMUNL) VALUE(*NO)
This avoids the potential issue described in this IBM APAR
Step 8
If you have downloaded Communiqué from the Internet, you can use the
product without a license key for up to 30 days. At the end of that period Communiqué will notify you that it can no longer be used without a license key.To obtain a license key contact ariadne at sales@ariadnesoftware.co.uk.
If you have been issued with a license key, proceed as follows.
On your iSeries, issue the following command to add a license key to enable you to use the Communiqué licensed program:
addlickey lickeyinp(*prompt)
prdid(1CMNQUE)
licterm(V1R1)
feature(5001)
serial(*local)
prcgrp(Ppp)
lickey(XXXXXX YYYYYY ZZZZZZ)
usglmt(*nomax)
expdate(exp_date)
vnddta(*none)
where:
XXXXXX YYYYYY ZZZZZZ is the license key you received by e-mail from us
exp_date is the expiry date mentioned in the e-mail
Ppp is the processor group mentioned in the e-mail
Communiqué is now ready for you to use!
If you have any trouble at any point in this procedure, please contact us by e-mail at support@ariadnesoftware.co.uk.
This method uses a Client Access network drive assigned to the IFS of your iSeries to transfer the Communiqué product files from your PC to your iSeries. It is assumed that you have stored the CMNQUEV1R1.zip file (which your downloaded from the Internet or received via e-mail) on your PC.
Step 1
On your PC, create an install directory for Communiqué, either within Windows Explorer, or from the DOS prompt, e.g.:
md c:\PC_dir
where PC_dir is the name of the directory you wish to use for this installation.
Save or move the zip file that you downloaded or received into this directory.
Step 2
On your PC, unzip the contents of the zip file into the directory you just created using pkunzip, WinZip, Norton UnZip etc.
Step 3
On your PC, ensure that you have a network drive assigned to a directory in the root file system of your iSeries’s IFS. This can be done in Windows Explorer by selecting Tools, Map Network Drive.
Create a directory in the IFS to receive the Communiqué files. This can be done in Windows Explorer by selecting File, New, Folder, or at the DOS prompt as follows:
md i:\IFS_dir
where I: is the network drive assigned to your iSeries and IFS_dir is the name of the directory you wish to use for this installation.
Step 4
Copy the contents of your PC’s install directory created in Step 1 above to the IFS directory created in Step 3 above using Windows Explorer, or from the DOS prompt as follows:
copy c:\PC_dir\*.* I:\IFS_dir
where PC_dir is the name of the directory on your PC, I: is the network drive assigned to your iSeries and IFS_dir is the name of the directory you wish to use for this installation.
Step 5
On your iSeries, decide which library you wish to use for the install procedure and create a save file in that library, e.g.
crtsavf lib_name/CMNQUE
where lib_name is the name of the library you chose to use.
Step 6
On your iSeries, copy the contents of the CMNQUEV1R1.sav file from the IFS directory to the save file just created, by issuing the following command:
cpyfrmstmf fromstmf(‘/IFS_dir/CMNQUEV1R1.sav’)
tombr(‘/qsys.lib/lib_name.lib/CMNQUE.file’)
mbropt(*replace)
cvtdta(*none)
endlinfmt(*fixed)
tabexpn(*no)
where IFS_dir is the name of the IFS directory into which you copied the install files in Step 4 above, and lib_name is the name of the library in which you created the save file in Step 5 above.
Step 7
On your iSeries, ensure that the previous step worked by displaying the contents of save file CMNQUE:
dspsavf lib_name/CMNQUE
where lib_name is the name of the library in which your created the save file in Step 5.
If you see the message (No records in save file) then something has gone wrong during the preceding steps. Try following them again. If you still cannot get this procedure to work, contact us at support@ariadnesoftware.co.uk.
Step 8
On your iSeries, issue the following command to restore the Communiqué licensed program to your system:
rstlicpgm licpgm(1CMNQUE)
dev(*savf)
option(*base)
rstobj(*all)
lng(*primary)
output(*none)
rls(*first)
replacerls(*only)
savf(lib_name/CMNQUE)
where lib_name is the name of the library in which your created the save file in Step 5.
Step 9
If you are installing on OS/400 V5R3M0 or above, run the following command to change the *RSTDRNMUNL attribute of the /tmp directory where Communiqué builds its temporary MIME file:
CHGATR OBJ('/tmp') ATR(*RSTDRNMUNL) VALUE(*NO)
This avoids the potential issue described in this IBM APAR
Step 10
If you have downloaded Communiqué from the Internet, you can use the
product without a license key for up to 30 days. At the end of that period Communiqué will notify you that it can no longer be used without a license key.To obtain a license key contact ariadne at sales@ariadnesoftware.co.uk.
If you have been issued with a license key, proceed as follows.
On your iSeries, issue the following command to add a license key to enable you to use the Communiqué licensed program:
addlickey lickeyinp(*prompt)
prdid(1CMNQUE)
licterm(V1R1)
feature(5001)
serial(*local)
prcgrp(Ppp)
lickey(XXXXXX YYYYYY ZZZZZZ)
usglmt(*nomax)
expdate(exp_date)
vnddta(*none)
where:
XXXXXX YYYYYY ZZZZZZ is the license key you received by e-mail from us
exp_date is the expiry date mentioned in the e-mail
Ppp is the processor group mentioned in the e-mail
Communiqué is now ready for you to use!
If you have any trouble at any point in this procedure, please contact us by e-mail at support@ariadnesoftware.co.uk.
This method uses FTP (File Transfer
Protocol) to transfer the PTF file from your PC to your iSeries. It is assumed
that you have stored the zip file which your downloaded from the Internet on
your PC and that you have enabled an FTP link between your PC and your iSeries.
Step
1
On
your PC, create a directory for the PTF
installation, either within Windows Explorer, or from the DOS prompt, or re-use
the directory you used to install originally, e.g.:
md c:\CMNQUE
Save or copy the zip file that you
downloaded or received into this directory.
Step
2
On
your PC, unzip the contents of the zip file into
the directory you just created using pkunzip, WinZip, Norton UnZip etc.
Step
3
On
your iSeries, first sign off then sign back on
again to ensure that you do to have any Communiqué objects in your QTEMP
library. Then decide which library
you wish to use for the PTF install procedure and create a save file in that
library. The name of this save file should be Q1CMnnnn, where nnnn is the PTF
id, e.g.
crtsavf lib_name/Q1CM0001
where lib_name is the name of the library you chose to use.
Step
4
On
your PC, start an FTP session to your iSeries. You
may use FTP packages such as CuteFTP or simply go to the DOS prompt and type:
ftp AS400_name
where AS400_name is the name of your
iSeries.
You will be prompted to enter your
user id and password. Please ensure that you sign on with a user id that has
adequate authority. We recommend that you sign on as the Security Officer
QSECOFR.
Issue the following FTP commands
within the FTP session:
binary
This command instructs FTP not to
carry out any conversion on the data to be sent to the iSeries.
quote site na 0
This makes sure the iSeries is using naming format 0 (library naming). This is important if your FTP attributes (CHGFTPA command NAMEFMT parameter) have the initial naming format set to *PATH (IFS path naming) rather than *LIB (library/file.member naming).
cd lib_name
where lib_name is the name of the
library in which your created the save file in Step 3. This command makes
lib_name your current library on the iSeries.
lcd dir_name
where dir_name is the name of the
directory on your PC in which you unzipped the install files earlier. This
command makes dir_name your current directory on the PC.
put Q1CMnnnn.sav Q1CMnnnn
This command transmits the contents
of the file Q1CM0001.sav, which was earlier unzipped from Q1CM0001.zip, and
stores them in the save file called Q1CMnnnn which you created earlier on your
iSeries.
Step
5
On
your iSeries, ensure that the previous step worked
by displaying the contents of save file Q1CMnnnn:
dspsavf lib_name/Q1CMnnnn
If you see the message (No
records in save file) then something has gone wrong during the preceding
steps. Try following them again. If you still cannot get this procedure to work,
contact us at support@ariadnesoftware.co.uk.
Step
6
On
your iSeries, issue the following command to load
the PTF on to your system:
lodptf
licpgm(1CMNQUE)
dev(*savf)
select(1CMnnnn)
savf(lib_name/Q1CMnnnn)
where lib_name is the name of the
library in which your created the save file in Step 3 and nnnn is the PTF id.
Step
7
On
your iSeries, issue the following command to apply
the PTF to your system:
apyptf
licpgm(1CMNQUE)
select(1CMnnnn)
apy(*temp)
where:
nnnn is the PTF
If you have any trouble at any point
in this procedure, please contact us by e-mail at support@ariadnesoftware.co.uk.
This method uses a Client Access
network drive assigned to the IFS of your iSeries to transfer the PTF from your
PC to your iSeries. It is assumed that you have stored the PTF zip file (which
your downloaded from the Internet or received via e-mail) on your PC.
Step
1
On
your PC, create an install directory for the PTF,
either within Windows Explorer, or from the DOS prompt, or use the directory you
created for the original installation, e.g.:
md c:\PC_dir
where PC_dir is the name of the
directory you wish to use for this installation.
Save or move the zip file that you
downloaded or received into this directory.
Step
2
On
your PC, unzip the contents of the zip file into
the directory you just created using pkunzip, WinZip, Norton UnZip etc.
Step
3
On
your PC, ensure that you have a network drive
assigned to a directory in the root file system of your iSeries’s IFS. This can
be done in Windows Explorer by selecting Tools, Map Network Drive.
Create a directory in the IFS to
receive the PTF. This can be done in Windows Explorer by selecting File, New,
Folder, or at the DOS prompt as follows:
md i:\IFS_dir
where I: is the network drive assigned to your iSeries and IFS_dir is the
name of the directory you wish to use for this installation.
Step
4
Copy the contents of your PC’s PTF
directory created in Step 1 above to the IFS directory created in Step 3 above
using Windows Explorer, or from the DOS prompt as follows:
copy c:\PC_dir\*.* I:\IFS_dir
where PC_dir is the name of the directory on your PC, I:
is the network drive assigned to your iSeries and IFS_dir
is the name of the directory you wish to use for this installation.
Step
5
On
your iSeries, first sign off then sign back on
again to ensure that you do to have any Communiqué objects in your QTEMP
library. Then decide which library
you wish to use for the install procedure and create a save file in that
library. The save file should be called
Q1CMnnnn,
where nnnn is the PTF id, e.g.
crtsavf lib_name/Q1CMnnnn
where lib_name is the name of the library you chose to use
and
nnnn is the PTF id.
Step
6
On
your iSeries, copy the contents of the
Q1CMnnnn.sav
file (where nnnn is the PTF id) from
the IFS directory to the save file just created, by issuing the following
command:
cpyfrmstmf fromstmf(‘/IFS_dir/Q1CMnnnn.sav’)
tombr(‘/qsys.lib/lib_name.lib/Q1CMnnnn.file’)
mbropt(*replace)
cvtdta(*none)
endlinfmt(*fixed)
tabexpn(*no)
where IFS_dir is the name of the IFS directory into which you copied the
PTF files in Step 4 above, and lib_name
is the name of the library in which you created the save file in Step 5 above.
Step
7
On
your iSeries, ensure that the previous step worked
by displaying the contents of save file
Q1CMnnnn:
dspsavf lib_name/Q1CMnnnn
If you see the message (No
records in save file) then something has gone wrong during the preceding
steps. Try following them again. If you still cannot get this procedure to work,
contact us at support@ariadnesoftware.co.uk.
Step
8
On
your iSeries, issue the following command to load
the PTF on to your system:
lodptf
licpgm(1CMNQUE)
dev(*savf)
select(1CMnnnn)
savf(lib_name/Q1CMnnnn)
where lib_name is the name of the
library in which your created the save file in Step 3 and nnnn is the PTF id.
Step
9
On
your iSeries, issue the following command to apply
the PTF to your system:
apyptf
licpgm(1CMNQUE)
select(1CMnnnn)
apy(*temp
where:
nnnn is the PTF