Using New Java API NTSADDRPTJ added in V1.56 of Domino Report Server to Import Reports

From Support

There is a new Java checkin API included with Domino Report Server V1.56.

If the Java API is enabled, the Domino Report Server can save documents to a Domino Server on the iSeries, Windows or any platform directly. There is no longer a limit to the Domino Server living on the same iSeries as the reports being generated.

If you want to use the new Java API included with the Domino Report Server, do the following:

1.) Upgrade to RJSDOM V1.56 or above.

2.) Install Java classes via the NTSJAVAEN command.

3.) Start the DIIOP service on your iSeries or Windows Domino Server console via the LOAD DIIOP Domino server command. DIIOP is needed by the Java interfaces to talk to the Domino server.

4.) Run VFYJDK command to make sure that Java SDK is 1.4.

5.) Set the following data areas as needed for the Domino remote connectivity via the DIIOP service. These data areas are only used by the NTSMON command.

Use Domino Java API CHGDTAARA DTAARA(RJSDOM/NTSUSEJAVA) VALUE('*YES')

Domino User ID - (Seems to work when no user or password specified) CHGDTAARA DTAARA(RJSDOM/NTSUSERID) VALUE(' ')

Ex: CHGDTAARA DTAARA(RJSDOM/NTSUSERID) VALUE('James Johnson')

Domino Password - (Seems to work when no user or password specified) CHGDTAARA DTAARA(RJSDOM/NTSUSERPW) VALUE(' ')

Ex: CHGDTAARA DTAARA(RJSDOM/NTSUSERPW) VALUE(MYPASSWORD')

Note: These data areas are used only by NTSMON. The User ID and Password may or may not be needed. When testing on the RJS1 test server we did not need to pass the user and password.

6.) Manually test the NTSADDRPTJ command or run the Domino Report Server output queue monitor NTSMON to import reports. We recommend testing the NTSADDRPTJ command by itself first to add a file manually to a Domino database.

Example to manually test NTSADDRPTJ

NTSADDRPTJ SVRNAME(RJS1) DBFILXNAME(AS400RPT2.NSF) DOCUMENT('/REPORT.TXT')DOMUSER('James Johnson')
DOMPASS(MYPASSWORD) FORMNAME('Archived Document') DOCTITLE('Test Report') DSPSTDOUT (*YES) DLTSTDOUT(*YES)

This example shows the usage for running the NTSADDRPTJ command to add a file named /REPORT.TXT to the AS400RPT2.NSF database running on a Domino server named RJS1. The RJS1 host name on the iSeries is configured in the iSeries host table and matches up to an IP address on a Windows Domino Server. The Domino Server name is also RJS1 and must match the actual Domino Server name. The AS400RPT2.NSF database resides in the main Domino data directory which is usually C:\Lotus\Domino\Data on a Windows platform. A user ID and password for the Domino server was also passed, however you can also test with a blank user ID and password if you get a user or password related error. The FORMNAME should always be 'Archived Document' as listed in the command.

• If reports import as expected, then the API is working.

• If problems occur, the DSPSTDOUT(*YES) value will display any Java errors so you can troubleshoot. Errors usually occur because of server or user name mismatches.

• If your iSeries host name for the Domino server does not match the Domino server name you may get a Java error that says: "Database has not been opened yet." If you get this error, make sure the SVRNAME parameter matches the actual Domino server name.