cyclecnt.client
Class CycleCnt

java.lang.Object
  cyclecnt.client.CycleCnt

public final class CycleCnt

extends Object

REQUIREMENTS:

• HP-UX 10.20 based HP 3070 clients:
  • Compiling CycleCnt requires the Java Development Kit, the most current being JDK 1.1.8.07 for HP-UX 10.20. Compiling CycleCnt is necessary because it's configuration is embedded into the source code.
  • Running the compiled CycleCnt .class files on an ICT client system requires JRE 1.1 or above. For HP 3070's running Board Test Software B.03.80 and up, the JRE 1.1 already installed is sufficient. Or the most current JRE is at JRE 1.1.8.07 for HP-UX 10.20.
  • Running CycleCnt also requires a PostgreSQL JDBC driver. Driver version 7.1 is recommended, as it works best, even with PostgreSQL RDBMS version 7.3.
  • Running CycleCnt requires Mike Muuss's ping implementation, ping-99.10. Note that HP-UX requires that ping-99.10 have its set-user-ID bit enabled so that non-root logins such as operator:hp3070 can execute it. This is because it opens an ICMP socket to perform the ping, and ICMP sockets require root permission. Perform the following shell prompt commands while logged in as root:
    • chown root:bin /opt/ping/bin/ping
    • chmod a+s /opt/ping/bin/ping
  • Running CycleCnt requires adding code to each testplan. Here's a recommended testmain template. Search through it for keywords "CycleCnt" and "VacuumOn".
  • Finally, running CycleCnt requires the client.sh HP-UX shell script.

• Microsoft Windows based HP, GenRad and Teradyne ICT clients:
  • Compiling CycleCnt requires the Java Development Kit, available at Java & Technologies. Compiling CycleCnt is necessary because it's configuration is embedded into the source code.
  • Running the compiled CycleCnt .class files on an ICT client system requires JRE 1.1 or above. Sun provides their current JRE at JRE's for Microsoft Windows
  • Running CycleCnt also requires a PostgreSQL JDBC driver.
  • Running CycleCnt requires Wouter Dhondt's ping implementation, fping.
  • Running CycleCnt requires adding code to each ICT test program:
    • HP 3070: Here's a recommended testmain template. Search through it for keywords "CycleCnt" and "VacuumOn".
    • GenRad 228X: Here's a recommended .tpg insert.
    • Teradyne Z1800: Here's a recommended Header step.
  • Finally, running CycleCnt requires the client.bat Windows batch file for JRE 1.4.

• Server:
  • CycleCnt requires an enterprise Relational Database Management System (RDBMS), and currently supports the free, open-source RDBMS PostgreSQL versions 7.1 and above.
    • Here's a PostgreSQL 7.3 script to create the CycleCnt database schema.
    • PostgreSQL is supported among most operating systems, excepting Microsoft Windows, though a port is in the works at the time of this writing.
  • An alpha version of CycleCnt worked successfully with SAP DB version 7.3, and a database creation script may eventually be forthcoming.
    • SAP DB is now known as MaxDB, and is maintained by mySQL.
    • MaxDB is supported among most operating systems, including Microsoft Windows, so CycleCnt can hopefully eventually be deployed on the major server environments in use today.
  • The cyclecnt.server package is optional, but includes classes to perform routine RDBMS administration, and to E-Mail alerts automatically to the CycleCnt Administrator. These classes can be invoked from a crontab entry with the server.sh shell script.

• Administrators and users:
  • To administer a PostgreSQL RDBMS, pgAdmin III is recommended.
  • To use PostgreSQL RDBMS data from Microsoft Access, psqlODBC is recommended.

Since:

1.1

Version:

1.1, 3/13/04

Author:

Phillip Smelt

Method Summary

static void

main(String[] args) This method is intended to be invoked from an HP-UX shell script or Windows batch file, which is in turn invoked from an ICT program.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

main

public static void main(String[] args)

This method is intended to be invoked from an HP-UX shell script or Windows batch file, which is in turn invoked from an ICT program.

Sample HP-UX shell command for PostgreSQL 7.3:

• Using JRE 1.1.8.00:
  • java -classpath /opt/java/jre/lib/rt.jar:/opt/cyclecnt/:/opt/cyclecnt/cyclecnt/jdbc7.1-1.1.jar cyclecnt.client.CycleCnt $1
• Using JRE 1.1.8.04 and above:
  • jre -classpath /opt/java/jre/lib/rt.jar:/opt/cyclecnt/:/opt/cyclecnt/cyclecnt/jdbc7.1-1.1.jar cyclecnt.client.CycleCnt $1

Sample Windows batch commands for PostgreSQL 7.3 and JRE 1.4.2:

• @echo off
• C:\CycleCnt;C:\CycleCnt\cyclecnt\pg73jdbc3.jar;C:\Progra~1\Java\j2re1.4.2\lib\rt.jar cyclecnt.client.CycleCnt %1

By default, JavaDoc is generated for only public classes and methods. However, if JavaDoc is generated for package or private classes, some additional documentation will become available, beginning with the hyperlinks to CycleCnt's non-public classes in the "See Also:" section below.

Parameters:

args - Unique ID of the ICT fixture. This is a 5 digit number, leading 0's required. Some examples are 00001, 01234 and 12345. If args is null, "NO-ID" will be supplied instead, which will log an error on the CycleCnt RDBMS.

See Also:

DriverManager, Connection, Statement, Class.forName(String className), BufferedReader, FileReader, File, CachedCountsFile, ErrorLogFile, Error, RDBMSInfo, ServerInfo