The START function starts the VM with the command START-PROGRAM and passes the parameters which have been set. If the structure variable SYSPOSIX does not already exist, the INITIALIZE procedure is first invoked using the default values. If the structure variable SYSPOSIX does already exist, INITIALIZE will not be called. The internal environment variables necessary for calling the tool will however be set.
Parameters
CMD
Must be assigned one of the following values:
’appletviewer’
’idlj’
’jar’
’jarsigner’
’java’
’javac’
’javadoc’
’javah’
’javap’
’jconsole’
’jdb’
’jdeps’
'jimage'
’jjs’
'jlink'
'jmod'
’keytool’
’native2ascii’
’orbd’
’pack200’
’policytool’
’rmic’
’rmid’
’rmiregistry’
’schemagen’
’serialver’
’servertool’
’tnameserv’
’unpack200’
’wsgen’
’wsimport’
’xjc’
The values correspond to the shell commands.
Other values:
’?’ | |
’help’ | outputs a help text in English. |
’hilfe’ | outputs a help text in German. |
ARGS
The arguments for the command above are to be enclosed in single quotes.
The wildcard substitution function, which is usually available under the shell, is not supported.
REDIRECT
This parameter must be used if input/output is to be redirected. This is done in the same way as for the corresponding option under the shell. For example: REDIRECT=’2>MyFile’ redirects the output of stderr to MyFile.
See the section "Redirection of default streams".
SYSHSI
This parameter must be assigned to one of the following values:
’*STD’
’X86’
’S390’
This parameter specifies, whether the s390 variant of the Java VM or the X86 variant is used.
Default value: ’*STD’
The variant corresponding to the system is used.
INSTALLATION-ID
User ID of the JENV installation. This parameter must only be specified if the object to be started under VM is not stored under the same user ID as the procedure library in which the START procedure is located.
Redirection of default streams
If PROGRAM_ENVIRONMENT=’shell’ is set, the file names into which the default streams are redirected refer to files in the POSIX file system.
It is possible to redirect the streams to BS2000 files using the usual prefix /BS2/. To redirect to SYSDTA, SYSOUT or SYSLST you must also use this prefix, i.e. /BS2/(SYSDTA), /BS2/(SYSOUT) or /BS2/(SYSLST). If the prefix is not used, redirecting to (SYSOUT) will result in a POSIX file being written with the name (SYSOUT).
The same applies to redirections which indicate special treatment under the shell. Outside the shell everything to the right of < or > is interpreted as a file name. So, for example, a redirection of 2>&1 creates a file called &1.
The redirection of stdout and stderr to the same BS2000 file is not possible, and if these streams are redirected to the same POSIX file, output data may be lost.
Example
If an applet is to be started via the file /MyDir/MyTest/Test1.html and the terminal has the symbolic address ABCD1234, this could be achieved as follows:
/CALL-PROCEDURE *LIB($TSOS.SYSPRC.JENV.090,INITIALIZE),
(PWD='/MyDir/MyTest ',DISPLAY='ABCD1234:0.0')
/CALL-PROCEDURE *LIB($TSOS.SYSPRC.JENV.090,START),
(CMD='appletviewer',ARGS='Test1.html')