pub:ifdcinstructions
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
pub:ifdcinstructions [2018/02/13 08:52] – ken | pub:ifdcinstructions [2018/03/20 08:16] – [Non-UI mode] ken | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | < | + | < |
- | ===== ESNDDTAQ | + | ===== IFD Client |
+ | ==== iSeries Command ==== | ||
+ | The ESNDDTAQ API command is used to send PDF file path to data queue which is being listened to by client programs. The command has the parameters as below: | ||
+ | {{: | ||
+ | |||
+ | |||
+ | The ESNDDTAQ command parameters: | ||
+ | * **Key**: A unique key defined by user. Each Window client should have a unique key for it to differentiate with other clients. This value can be user ID of that machine or PC ID | ||
+ | * **Data**: This field contains the IFS qualified path of PDF file that server wants to open on client machine | ||
+ | * **Data Queue**: The data queue is used to communicate between server and client. This data queue is monitored by client programs. | ||
+ | |||
+ | For example, open PDF file / | ||
< | < | ||
- | Send data to keyed data queue (ESNDDTAQ) | + | ESNDDTAQ KEY(USER01) DATA(‘/ |
- | + | </ | |
- | Type choices, press Enter. | + | ==== Windows Program ==== |
- | + | ||
- | Key value . . . . . . . . . . . | + | The client program is a .JAR file developed in Java language to connect to iSeries and monitor a data queue by a unique key for PDF file. Once the data in data queue is found, client program will download the PDF file to temporary folder in Windows and invoke the PDF reader (configured in parameter) to show PDF file on the Window machine. |
- | + | ||
- | Data value . . . . . . . . . . . | + | |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | Data Queue . . . . . . . . . . . IFDCLIENT | + | |
- | | + | |
- | + | ||
- | | + | |
- | </ | + | |
+ | The compressed file contains 2 files: | ||
+ | * **IFDCLIENT.JAR**: | ||
+ | * **IFDCLIENT.BAT**: | ||
- | The ESNDDTAQ command has 3 parameters: | + | The program can be started in __2 modes__: with and without user interface (UI). |
- | * **KEY**: this is a key for client, each client machine should | + | |
- | * **DATA**: The IFS PDF file user wants to send to client | + | * **In UI mode**: a logon dialog will be prompting to input the IBM i credential and other configuration. |
- | * **DATAQ**: data queue is used to communicate with clients | + | * **In non-UI mode**: |
+ | |||
+ | ==== UI mode ==== | ||
+ | |||
+ | User can execute | ||
+ | {{: | ||
+ | |||
+ | |||
+ | As seen on the black screen behind the logon screen | ||
+ | |||
+ | {{: | ||
+ | |||
+ | |||
+ | When user clicks OK, a folder named **IFDClient** is created | ||
+ | |||
+ | * **ifdclient.cfg**: save the program’s configuration | ||
+ | * **log.txt**: | ||
+ | |||
+ | ==== Non-UI mode ==== | ||
+ | |||
+ | IFDCLIENT.JAR is started with the following parameters: | ||
+ | * **print**: Optional. Print the parameters | ||
+ | * **help**: Optional. Print the parameters | ||
+ | * **server**: __Mandatory__. IP address of host name of iSeries | ||
+ | * **logonuser**: | ||
+ | * **logonpassword**: __Mandatory__. iSeries password of user ID in parameter logonuser | ||
+ | * **dataqueue**: | ||
+ | * **user**: Optional. The key that JAR program | ||
+ | * **multifiles**: | ||
+ | * **pdfreaderdir**: | ||
+ | * **pdfreadername**: | ||
+ | |||
+ | Pass them as parameters into the **java** command, for example: | ||
+ | < | ||
+ | C:\>java -jar ifdclient.jar -server 172.16.1.54 -logonuser my_user -logonpassword my_password -user USER01 | ||
+ | </ | ||
- | The client executable, | + | **Notes:**\\ |
- | | + | Please remember that if the .JAR program is setup as a Window service |
- | * **ifdclient.logonuser**: | + | |
- | * **ifdclient.logonpassword**: | + | |
- | * **ifdclient.user**: | + | |
- | * **ifdclient.pdfreaderdir**: | + | |
- | * **ifdclient.pdfreadername**: | + | |
- | * **ifdclient.multifiles**: | + |
pub/ifdcinstructions.txt · Last modified: 2022/06/25 17:02 by 127.0.0.1