Wintouch Sytem Administrator FAQ's


I. Useful AS/400 Commands

II. Miscellaneous


I. Useful AS/400 Commands

Q: How does Daylight Savings Time impact Wintouch?

A: We do not have any known issues with Day Light Saving Time changes. The Wintouch server uses the iSeries system date/time to update the last update/time fields and the client uses the Windows date/time in places like Schedule an Activity window. As long as the system date/times are changed, all should be ok.

Q: How do I start the Wintouch server?

A: WINTOUCH/WTCPSTART 'PORT#' WT'MYWINTOUCH'
eg: WINTOUCH/WTCPSTART 01092 WTTOUCHTONE


Q: How do we enable Wintouch Work Flow?

A: In order to enable the Wintouch workflow, you need to first end the Wintouch server and then run the following AS/400 command: WINTOUCH/STRWTWFTRG LIBRARY(WTWINTOUCH)

The command to disable the workflow is; WINTOUCH/ENDWTWFTRG LIBRARY(WTWINTOUCH)

Note: In a real scenario, "WTWINTOUCH" would be replaced with your Wintouch library.

Q: How do we rename the User Location Settings file?

A: Click here for instructions.

Q: How do we know how many users are on Wintouch at a given time?

A: The command WRKWINTINF in the Wintouch library shows the number of users online with Wintouch and detached with Wintouch Lite. Keep in mind the Wintouch Lite users take up a license even when they are detached.

Q: The WTCLOG file in the Wintouch library in our iSeries M2 (SN 44774FA) is now almost 10GB in size and is growing at an average rate of 1 GB per month. Please give us a procedure on how to reduce and control the size.

A: Generally speaking, WTCLOG should only be used as a troubleshooting aid, such as to determine why a WTAPIMSR exit program is failing to censor sensitive data.

I. Description of WTCLOG

WTCLOG, in the WINTOUCH library, is the WinTouch Connection LOG file. It is used primarily to log request/response communications between Wintouch client and server jobs; it also logs the SQL queries generated by "group" and "other" searches (including reports), and workflow script execution.

Logging to WTCLOG is controlled by the value in the WTLOGF data area, which is found in the Wintouch Environment library: a value of 'Y' (it must be a capital Y) turns logging on, while any other value turns it off.

WTCLOG records are keyed on user, date, and time. For ordinary communication log entries, the rest of the record indicates whether it documents a request as received ("R") or the reply as sent ("S"), the command, the communications format number, the keys, the return code, and the first 32680 bytes of data. Records documenting SQL queries ("Q") list whether it was a "GROUP" or "OTHER" search, the parameters used to generate the query, and the query itself. Workflow ("W") records trace the execution of Workflow scripts.

II. How to reduce the size of WTCLOG

In order to stop the logging, run the AS/400 command: chgdtaara wt"mywintouchlibraryname"/wtlogf 'N'. Then run the following AS/400 command to clear the log file (this should free a lot of disk space): sbmjob cmd(clrpfm wintouch/wtclog) job(clrwtlog).

Q: How do I reset Wintouch Lite so the following error window doesn't show up?

A: The AS/400 command to reset Wintouch Lite is as follows
wintouch/wtresetlit(space)(five digit user id)
Please do not include the ( ) in the command.

Q: How do I change a user's System ID?

A: You can change a user's System ID's on the front end by going to Administration, then User Profile, then by double clicking on the user and by changing the System ID and then clicking the "Update Profile" button. You can change the user's system ID's on the back end in WTUSER by changing the field name UNETID.

Q: How do I display the model, serial number and LPAR?

A: WRKWINTINF - displays the model, serial #, and LPAR. Also allows one to determine who is connected, and who is detached in "Lite" mode, and to display and change the authorization code.


Q: How do I determine when my Wintouch server was last updated?

A: DSPPGM WT'MYWINTOUCH'/WTCPCHILD


II. Miscellaneous

Q: When we log into Wintouch, we get an invalid parameter message.

A: First, try logging in as another user. If you can log into Wintouch as another user, then the problem is in the User Profile. If you do not get a log in screen, then try clearing your Java Webstart cache. If clearing your Cache does not work, then delete the sun folder and reinstall java. If this fails, contact your Wintouch Administrator.

Q: How do I remove users that have left the company from the drop downs?

Answer:

  1. Transfer their scheduled activities to another user. To transfer all of their activities at one time see the "Transfer a Scheduled Activity" help.
  2. Select the Inactive User checkbox under User Profiles (Select Administration from the Main Menubar, then "User Profile" from the pull-down. Double click on the User and check the Inactive Checkbox.)
  3. Exit Wintouch.
  4. Log back into Wintouch.

Q: How do we allocate more default memory to Wintouch when using Java Webstart?

A: Click here for instructions.

Q: Why does an out of memory window pop up?

A: There is not enough memory available for the Java console. If this problem occurs frequently, then click here for instructions.

Note: The fix only applies to the Browser Wintouch launch and not Webstart.

Q: I log on Wintouch and the Screen is blank.

A: Answer involving open Internet Explorer Windows: If you are launching Wintouch from your browser, it will open three windows. If you have already been in a Wintouch environment, then make sure you close the three Internet Explorer windows and then try reloading Wintouch.


Q: I do not know what webserver my desktop is pointing to.

A: Go to the control Panel > Java > Settings (General Tab) > View Applications > Highlight Application > Click the Application pulldown > Show JNLP descriptor. You can see what server is being pointed to at the very bottom in the arguments.

Q: The Problem (Windows XP): When logged on using a VPN you are still being sent to your External DNS and therefore your firewall is not allowing you to access Wintouch.

A: Prerequisites: Log into Windows with an Administrator account and have the minimum number of programs running.

  1. In C:\WINDOWS\SYSTEM32\DRIVERS\ETC there should be a file called HOSTS.
  2. Right click and open the HOSTS file with Notepad. You should see the following screen

  3. Add the Internal IP to the HOSTS file.
  4. Save HOSTS without an extension. For example in File > Save As, type in "HOSTS" with the quotes included.

  5. Restart Windows (may not be necessary), log into your VPN, and try to access Wintouch through your Wintouch link.

Windows 2000: The potential solution is the same, except the path is C:\WINNT\system32\drivers\etc

Q: How does Workflow email function?

A: OS/400 has built-in SMTP capability, which is run in the background by a series of jobs with names starting "QTSMTP. . . ," and by one or more jobs named QMSF, which control the sending of mail. It provides an API called QtmmSendMail, which essentially allows a program to pass a message to the QMSF jobs, which then send it off through the QTSMTP . . ." jobs.

Wintouch, when it sends server-side email (either workflow or otherwise), does so by calling QtmmSendMail.

The system itself keeps track of where your mail router is; this, along with other SMTP parameters, is controlled from the CHGSMTPA command. Current settings can be viewed by prompting this command.

Q: If I cannot change an expired password from the Wintouch login, but can change the password from inside of Wintouch or from a command line, how do I resolve this?

A: Problem: When changing an expired password from Wintouch, you are connected to the WTCPVERIFY job, which runs under the same user as the WTCPSERVER job. You aren't running under your own user profile until you're passed on to a WTCPCHILD job. If the WTCPSERVER and WTCPVERIFY jobs aren't running under a user profile that's authorized to change other users' passwords (*SECADM authority), then Wintouch cannot change an expired password.

Solutions: Either

  1. Give *SECADM authority to the WINTOUCH account.
  2. Shut down WTCPSERVER, and launch it (WTCPSTART) from an account with *ALLOBJ and *SECADM authority.
  3. Change WTCPVERIFY to run under *OWNER authority, and change its owner to an account with *ALLOBJ and *SECADM authority.
  4. Use other means to change expired passwords.