Frequently asked questions

z/VSE Connectors questions

 

Question Answer
ZIP file is not extractable after download. Most likely, the ZIP file is corrupted. If you downloaded the file from the Internet, retry the download, or use a download manager to ensure that complete file is being downloaded. If you downloaded the the file from z/VSE, make sure you download it in BINARY mode. If you are using FTP, make sure Unix mode is OFF.
Installation does not work In order to install and use the z/VSE Connectors and samples, you need a Java runtime environment (JRE) or a Java developers kit (JDK) 1.5 or higher. You can download JDKs/JREs for various platforms from IBM developerWorks or Oracle. To verify if Java is installed on your workstation enter the following command in a command prompt or shell:

java -version

In case Java is installed, you should see something like this:

java version "1.6.0_07"
Java(TM) SE Runtime Environment, ...
Java HotSpot(TM) Client VM


If Java is not installed on your computer, you would see a message like

'java' is not recognized as an internal or
external command, operable program or batch file.


Note: On Windows Vista or Windows 7, the Java Runtime installation process does no longer copy the Java executable (java.exe) into the C:\Windows\System32\ folder. That means you have to manually update the PATH environment variable and add the Java installation directory (e.g. "C:\Program Files\Java\jre6\bin" or "C:\Program Files (x86)\Java\jre6\bin") to the PATH. This can be done via Control Panel -> System -> Advanced System Settings -> Advanced Tab -> Environment Variables. Locate the PATH variable either in the user or system variables, and add the Java's bin directory (e.g. "C:\Program Files\Java\jre6\bin" or "C:\Program Files (x86)\Java\jre6\bin") to the end of the PATH variable, separated by a semi colon (;).

If you get an exception like java.lang.ClassFormatError: <class> (Bad magic number)this indicates that your PC does not have the right version of Java. Please make sure you have at least version 1.5 or higher.
Class install not found Make sure, the current directory is contained in your local CLASSPATH environment variable. For example, enter:

set classpath=.;%classpath%
java install


The dot indicates the current directory.
VSE Connector Server does not start Possible reasons are:
Cannot connect to z/VSE Connector Server Possible reasons are:
 
Problems with applets The following list shows some known problems when working with applets:
Performance is not satisfying, why? Accessing resource remotely is always slower than accessing resources locally. Performance is dependent on the following items:
Please make sure you have installed the most recent PTFs for the connector component. Some performance related problems may have been already fixed in the meantime.
Which Java versions are supported? In order to install and use the z/VSE Connectors and samples, you need a Java runtime environment (JRE) or a Java developers kit (JDK) 1.5 or higher. You can download JDKs/JREs for various platforms from IBM developerWorks or Oracle. To verify if Java is installed on your workstation enter the following command in a command prompt or shell:

java -version

In case Java is installed, you should see something like this:

java version "1.6.0_07"
Java(TM) SE Runtime Environment, ...
Java HotSpot(TM) Client VM


If Java is not installed on your computer, you would see a message like

'java' is not recognized as an internal or
external command, operable program or batch file.


Note: On Windows Vista or Windows 7, the Java Runtime installation process does no longer copy the Java executable (java.exe) into the C:\Windows\System32\ folder. That means you have to manually update the PATH environment variable and add the Java installation directory (e.g. "C:\Program Files\Java\jre6\bin" or "C:\Program Files (x86)\Java\jre6\bin") to the PATH. This can be done via Control Panel -> System -> Advanced System Settings -> Advanced Tab -> Environment Variables. Locate the PATH variable either in the user or system variables, and add the Java's bin directory (e.g. "C:\Program Files\Java\jre6\bin" or "C:\Program Files (x86)\Java\jre6\bin") to the end of the PATH variable, separated by a semi colon (;).

If you get an exception like java.lang.ClassFormatError: <class> (Bad magic number)this indicates that your PC does not have the right version of Java. Please make sure you have at least version 1.5 or higher.
Cannot logon to the z/VSE Connector Server Make sure you specify a valid z/VSE user id and password. The z/VSE user id must be defined for the z/VSE system. It is recommended to use a SYSA type user in order to have access to all resources.

The z/VSE Connector Server does a RACROUT VERIFY call to check the user id and password and to get the users ACEE. This implies that the Security Server (FB per default) must be up and running. Some people think that they do not need the Security Server because they have SEC=NO, but that is not true! There must be at least the Basic Security Manager active, but it could be also a External Security Manager (e.g. CA TopSecret).

There is a configuration member IESUSERS.Z (Skeleton SKVCSUSR in ICCF Lib 59) which allows to restrict the access to the z/VSE Connector Server by IP address and/or user id.

Since APAR PQ60612 (VSEESA 2.6 only, APAR is already integrated in z/VSE/ESA 2.7) a new keyword SECURITY in main config member has been introduced to set the level of security:
Default is SECURITY= FULL.

If you are using CA TopSecret, please make sure that the user id you want to use for logon is defined as follows:

TSS LIST(SIE1) DATA(ALL)

ACCESSORID = ....     NAME = ...
TYPE       = CENTRAL  SIZE = ... BYTES
FACILITY   = *ALL*
CREATED    = 07/25/01 LAST MOD = ...
PROFILES   = PROFGEN  PRFIRMSY
LAST USED  = 10/05/01 11:23
             CPU(VSEA) FAC(BATCH)
-----------  SEGMENT CICS
OPCLASS    = 01
OPIDENT    = SYA
-----------  SEGMENT IESIS
IESFL1     = BAT,COD,VSAM
IESFL2     = BQA,ESC,COU,CMD,OLPD,XRM
IESINIT    = IESEADM
IESTYPE    = USERTYPE1,NEW,SELECT
-----------  ADMINISTRATION AUTHORITIES
RESOURCE   = *ALL*
   ACCESS  = ALL
ACID       = *ALL*
FACILITIES = *ALL*
LIST DATA  = *ALL*,PROFILES,PASSWORD,
             PWVIEW
MISC1      = *ALL*
MISC2      = *ALL*
MISC3      = SDT
MISC8      = LISTSTC,LISTRDT,REMASUSP,
             MCS,LISTSDT
MISC9      =
             
*ALL*       TSS0300I

LIST  FUNCTION SUCCESSFUL

In case this does not help, or you are using a different External Security Manager (e.g. BIM Alert) you may disable connector security (SECURITY=LOGON or SECURITY=NO in main config member).
Cannot access the z/VSE console If you are using the z/VSE Connector Classes or the z/VSE Navigator to access the z/VSE console and you are getting a message stating the console is already in use, check if you are using the console function of the Interactive Interface from this or another terminal using the same user ID, or if the same user ID is used by another z/VSE Connector user who also accesses the console at the same time. Console access is only possible with a SYSA type user (Type-1).
How can I find out which APAR level is installed? To find out which APARs and PTFs are installed on he z/VSE system, please use MSHP to retrace the z/VSE history file.

To find out which APAR level of the z/VSE Connectors is installed on your PC, the following hints may help:
What is the CLASSPATH and how can I se it? The CLASSPATH defines which directories and JAR files are to be searched when loading a Java class file. The CLASSPATH is very similar to the LIBDEF on z/VSE. A class file is a peace of executable Java code. The CLASSPATH is usually given in an environment variable. You can set the CLASPATH environment variable with the following command (Windows only) in a command prompt, or in a batch file:

set CLASSPATH=;%CLASSPATH%

A semicolon (;) separates different directories or JAR files. It is recommended to have a dot (current directory ) as first element in the classpath.

Or you can set the classpath system wide in the System applet in the Windows control panel. On the "Advanced"-tap press the Button "Environment Variables...".
I get exception java.lang.NoClass DefFoundError: xxx, what does that mean? The Java exception "java.lang.NoClassDefFoundError: xxx" is thrown whenever the Java runtime tries to load the class named "xxx", but could not find it in the CLASSPATH.

Check if the class name is typed correctly or if he CLASSPATH is set correctly. This exception could indicate that some JAR files are missing in the CLASSPATH.

Applications that are using the z/VSE Connector Client classes must have the following 3 JAR files in the classpath:
I get message IESC1017E SYNTAX ERROR IN CONFIG FILE Message IESC1017E SYNTAX ERROR IN CONFIG FILE: member-name (and also IESC1016E SYNTAX ERROR IN PLUGIN CONFIG FILE: member-name) normally occurs if a syntax error was detected in a config file.

In case CA-FLEE is active, a problem in FLEE can cause this error (they mix up the contents of the member). To solve this, FLEE must be started AFTER the Connector Server Partition.
Deactivating FLEE in the Server Partition does not help.
Cannot access VSAM file
Where can I find more information about z/VSE Connectors? More Information can be found here:
Which programming languages can I use with SOAP on z/VSE? SOAP on z/VSE can be used with any programming language (Assembler, COBOL, PL/I, C). The SOAP programming interface uses only simple CICS calls, like EXEC CICS LINK together with a commarea.
What is the different between a JDK and JRE? A JDK (Java Developer Kit) contains Java tools (like Java compiler) that you need when you develop Java programs. a JRE (Java Runtime Environment) does not include these development tools. A JDK always includes a JRE to be able to run Java programs.
Which programming languages can I use with XML parser on z/VSE? XML parser on z/VSE can be used with any programming language (Assembler, COBOL, PL/I, C). The DOM-type programming interface uses only simple CICS calls, like EXEC CICS LINK together with a commarea. The SAX-type interface can only be uses with LE compliant programming languages.
Is IBM WebSphere required to use z/VSE Connectors? No, an application server like IBM WebSphere is not required to use z/VSE Connectors. z/VSE Connectors can be integrated with WebSphere or other application servers, but they can also be used 'stand alone'. Some samples that are part of the z/VSE Connector Client show how to use the connectors in servlets. To run these kind of samples, you need an application server like WebSphere.