|
•
|
The wrklib, wrkf, and wrkmbrpdm commands work only with HFS objects.
|
|
•
|
The cd, mkdir, dspcurdir, and wrklnk commands may be used with both IFS files and HFS files, but different syntax is required, depending on whether you are accessing HFS or IFS objects.
|
|
•
|
The cpytostmf and cpyfrmstmf commands are available for copying a text file from one type of file system to another. For example, the following command copies an IFS file called /QOpenSys/tuxedo/tmp/xyz to an HFS physical file called tmp in a member called xyz (in a library called apps).
|
The make,
lex, and
yacc utilities are not available on the IBM i 6.1. The native character set is EBCDIC, not ASCII.
Two Oracle Tuxedo commands, buildclient and
buildserver, have been renamed
buildclt and
buildsrvr, respectively, in order to conform to the 10-character maximum.
The buildclt and
buildsrvr commands accept input only for module files (
*MODULE), service program files (
*SRVPGM), binding directory (
*BNDDIR), and produce output program files (
*PGM). The ILE C modules must be produced by
crtcmod. Likewise, ILE COBOL modules must be produced by
crtcblmod.
Note that the special system interface option sysifcopt(*ifsio) is specified here. This option allows the C runtime library to access IFS files. Because the Oracle Tuxedo system is compiled with this option, we strongly recommend using it for compatibility.
The -f and -l options to the buildclt and
buildsrvr commands also mean something slightly different from the same options to the equivalent commands (
buildclient and
buildserver) on a UNIX system.
If the -k option of
buildsrvr is used, then the server main code is generated in member
BSpid of the
tuxsrc file in the
qtemp library, where the value of pid is the process ID of the
buildsrvr process. Because the
qtemp library is removed at the end of each job, you must make a copy of it in a permanent directory before signing off, if you want to keep it.
Both mkfldhdr and
viewc generate header files in IFS, usually in the current directory. You must copy these
.h files into an HFS h file so the C compiler will be able to find them.
The mkfldhdr/ mkfldhdr32 -H option creates a header file in HFS.
viewc also generates the binary output file with a
.VV (instead of a
.V) suffix.
For the epifreg command
-f option, the library name and service program name must be upper cased as shown in the following example:
There is a difference in IBM i 6.1 and UNIX. If the -C option is specified, one COBOL copy file is created for each VIEW defined in the viewfile. These copy files are created in root directory (/), not in current directory like UNIX, unless an alternate directory is specified through the -d option.
|
|
|
|
|
|
|
|
|
|
|
Calls putenv on every line of the specified file (file)
|
|
|
|
IBM i 6.1 provides a single command, wrkenvvar, that offers functionality similar to that available through
getenv,
putenv,
setenv, and
env. The
wrkenvvar command differs from the Oracle Tuxedo commands, however, in several aspects. First, unlike the distributed tools delivered with the Oracle Tuxedo system,
wrkenvvar cannot handle the expansion of variable names marked with a $ prefix (similar to shell variable expansion).
In addition, the hostname and
id utilities are distributed only with the Oracle Tuxedo system:
|
•
|
The hostname command prints the name of the network node for the IBM i 6.1. The machine name used in the UBBCONFIG configuration file must match the name returned by hostname.
|
Assume tuxdir is installed in
/QOpenSys/tuxedo,
tuxlib is installed as Tuxedo, and
APPDIR is set to
/home/apps/simpapp.
|
3.
|
Copy simpcl.c from /qopensys/tuxedo/samples/atmi/simpapp to tuxsrc simpcl member.
|
cpyfrmstmf fromstmf('/qopensys/tuxedo/samples/atmi/simpapp/simpserv.c') +
tombr('/qsys.lib/apps.lib/tuxsrc.file/simpserv.mbr') +
mbropt(*replace)
|
10.
|
Add tuxlib to the library list.
|
|
13.
|
Run wrklnk to verify that the file tuxconfig has been created in /home/apps/simpapp.
|
|
•
|
The tlisten command does not start itself in the background. To submit a batch job with tlisten, use the sbmjob command, for example:
|
|
•
|
The tpusr file is required for AUTHSVR.
|
Three files $TUXDIR/udataobj/webgui/webguitop.html,
$TUXDIR/udataobj/ tuxwsvr.ini,and
$TUXDIR/udataobj/webgui.ini need to be modified. For example:
|
•
|
Replace "TUXDIRVALUE" in file $TUXDIR/udataobj/webgui/webguitop.html with the value of TUXDIR.
|
|
•
|
Replace "http://HOST/cgi-bin/tuxadm" in file $TUXDIR/udataobj/webgui/webguitop.html with "/cgi-bin/tuxadm".
|
|
•
|
Replace "<TUXDIR>" in file $TUXDIR/udataobj/ tuxwsvr.ini with the value of TUXDIR.
|
|
•
|
Replace "<TUXDIR>" in file $TUXDIR/udataobj/webgui/webgui.ini with the value of TUXDIR.
|
|
•
|
Replace "<LOCAL_HOST>" in $TUXDIR/udataobj/webgui/webgui.ini with the host name.
|
Two programs, tuxwsvr and
wlisten, need to be run in the background. This can be accomplished by using
sbmjob like
tlisten. For example:
By default, the tidl command also produces server and client stub files in the current IFS directory. The stub files are named
x_cstub.c and
x_sstub.c. It is also possible to generate stub files in HFS by using the -out option to specify a library in the directory
/qsys.lib, as in the following example:
call tidl ('-cpp_cmd' 'crtcmod' '-keep' 'c_source' 'x.idl')
If the -keep option is not specified, then the C compiler will be invoked on the stub files to produce object modules
x_cs and
x_ss in library
qtemp. (
qtemp is the default output library which can be overridden by the
-out option, as described earlier.)
You can override the Oracle Tuxedo TMDISPATCH9() to
TMDISPATCH16() for COBOL routines only when set environment variable
TM_COB_STATIC to
YES before create COBOL program.
