Table of Contents Previous Next PDF


System Commands and Transactions

System Commands and Transactions
This chapter contains the following topics:
System Commands
cpy2view32(1)
Name
cpy2view32—Generates Oracle Tuxedo VIEW32 definition file from COBOL copybook file.
Synopsis
cpy2view32 [OPTION...] FILE
Description
This utility parses the COBOL copybook file and generates the corresponding Oracle Tuxedo VIEW32 definition files.
It supports the following options:
-i
With -i option, cname in VIEW32 definition files is not converted to lowcase; without -i option, cname is converted to lowercase.
-n
Specifies the source copybook is in "normal" format (i.e., copybook contains sequence number area (columns 1 through 6 is the sequence number area, followed by the indicator area)).
-e
Specifies the source copybook is in "exceptional" format (i.e.,copybook does not contain a sequence number area (the first column is the indicator area)).
-o
Specifies the output file name, followed parameter is the output file name. If this parameter is not specified, the output file name changes the suffix of the input file name to .v. For example, abc.cbl is converted to abc.v.
This utility supports the following annotation in the source copybook:
* @binary: by default, copybook data types without the following qualifiers are converted to string: BINARY, COMP, COMP-1, COMP-2, COMP-3, COMP-4, COMP-5, PACKED-DECIMAL. With the * @binary=true annotation, the copybook data types without those qualifiers are converted to CARRAY. * @binary=false changes the conversion rule back to the default. When this annotation is defined on a group, all subordinates in the group are affected.
Environment Variables
PATH
The cpy2view32 utility is written in Java. You must install JDK 1.6 or above and add the Java command "java" to the PATH environment variable.
Example(s)
1.
The following example converts normal copybook file abc_orig.cbl to view file abc_orig.v:
cpy2view32 /home/abc_orig.cbl
2.
cpy2view32 -e /home/abc.cbl
3.
The following example converts normal copybook file abc_orig.cbland outputs to view file xyz.v:
cpy2view32 -o xyz.v /home/abc_orig.cbl
4.
Listing 13‑1 through Listing 13‑4 provide Copybook and view file output Example(s):
Listing 13‑1 Copybook Example 1
#########################
01 BOOK-INFO.
05 BOOK-ID PIC 9(9) COMP-5.
05 BOOK-NAME PIC X(100).
05 PUBLISHER PIC X(100).
05 PRICE USAGE COMP-1.
#########################
 
Listing 13‑2 VIEW32 Output Example 1
#########################
#type cname fbname count flag size null
 
VIEW book_info
unsignedint book_id - 1 - - -
string book_name - 1 - 100 -
string publisher - 1 - 100 -
float price - 1 - - -
END
#########################
 
Listing 13‑3 Copybook Example 2
#########################
01 COMPUTER.
05 COMPUTER-ID PIC 9(9) COMP-5.
05 COMPUTER-NAME PIC X(20).
05 PRODUCER PIC X(40).
05 FILLER PIC X(4).
 
05 SELL-PRICE USAGE COMP-2.
05 RENTAL-PRICE PIC S9999V999 PACKED-DECIMAL.
05 KEYBOARD-PRICE PIC S9(4) SIGN IS LEADING SEPARATE.
05 MOUSE-PRICE PIC S9(4) SIGN IS LEADING.
 
05 FILLER PIC X(4).
* define other computer components below
05 CPU.
10 MODEL PIC X(20).
10 PRODUCER PIC X(40).
10 PRICE USAGE COMP-1.
05 COMPUTER-MEMORY OCCURS 4 TIMES.
10 MODEL PIC X(20).
10 PRODUCER PIC X(40).
10 PRICE USAGE COMP-1.
05 MAINBOARD.
10 MODEL PIC X(20).
10 PRODUCER PIC X(40).
10 PRICE USAGE COMP-1.
05 MONITOR.
10 MODEL PIC X(20).
10 PRODUCER PIC X(40).
10 PRICE USAGE COMP-1.
05 HARDDISK.
10 MODEL PIC X(20).
10 PRODUCER PIC X(40).
10 PRICE USAGE COMP-1.
#########################
 
Listing 13‑4 VIEW32 Output Example 2
#########################
#type cname fbname count flag size null
 
VIEW cpu
string model - 1 - 20 -
string producer - 1 - 40 -
float price - 1 - - -
END
 
VIEW computer_memory
string model - 1 - 20 -
string producer - 1 - 40 -
float price - 1 - - -
END
 
VIEW mainboard
string model - 1 - 20 -
string producer - 1 - 40 -
float price - 1 - - -
END
 
VIEW monitor
string model - 1 - 20 -
string producer - 1 - 40 -
float price - 1 - - -
END
 
VIEW harddisk
string model - 1 - 20 -
string producer - 1 - 40 -
float price - 1 - - -
END
 
VIEW computer
unsignedint computer_id - 1 - - -
string computer_name - 1 - 20 -
string producer - 1 - 40 -
string filler1 - 1 - 4 -
double sell_price - 1 - - -
carray rental_price - 1 - 4 -
string keyboard_price - 1 - 5 -
string mouse_price - 1 - 4 -
string filler2 - 1 - 4 -
struct cpu cpu 1 - - -
struct computer_memory computer_memory 4 - - -
struct mainboard mainboard 1 - - -
struct monitor monitor 1 - - -
struct harddisk harddisk 1 - - -
END
#########################
 
Limitations
The following are general cpy2view32 limitations:
1.
This tool does not parse REDEFINES clause, REDEFINES clause and their subordinate items are skipped.
2.
POINTER phrase, FUNCTION-POINTER phrase and PROCEDURE-POINTER phrase are skipped in the conversion.
3.
VALUE clause is skipped in the conversion.
4.
SYNCHRONIZED clause is skipped in the conversion.
5.
JUSTIFIED clause is skipped in the conversion.
6.
BINARY, COMP, and COMP-4 are synonyms, they are converted to CARRAY in view file.
Mif2View32(1)
Name
Mif2View32—Generates VIEW32 definition file according to the metadata input file and updates the given FML32 definition file.
Synopsis
Mif2View32 -i miffile -o viewfile -f fml32file -w webservice.desc [-v]
Description
Mif2View32 generates VIEW32 definition file according to the metadata input file and updates the given FML32 definition file. The generated nest VIEW32 definition file keeps the same structure with MIF; therefore, we can map the C structure to an FML32 structure.
Options
Mif2View32 supports the following options.
-i miffile
Specifies the metadata input file name.
-o viewfile
Specifies the output View32 definition file name.
-f fml32file
Specifies the updated FML32 definition file.
-w webservice.desc
Specifies webservice.desc configuration file.
-v
Indicates whether to output details or not.
Example(s)
1.
Listing 13‑5 provides an MIF example.
Listing 13‑5 MIF Example
############
# SERVICE: * DFH0XCMNOperation
############
service=DFH0XCMNOperation
servicetype=service
export=Y
inbuf=FML32
outbuf=FML32
tuxservice=DFH0XCMNOperation
errbuf=FML32
servicemode=webservice
param=DFH0XCMNOperation
count=1
requiredcount=0
fldnum=10025
type=fml32
access=in
paramschema=XSD_E:DFH0XCMNOperation@http://www.DFH0XCMN.DFH0XCP3.Request.com
(
param=ca_request_id
count=1
requiredcount=0
fldnum=10019
type=string
access=in
paramschema=XSD_E:ca_request_id@http://www.DFH0XCMN.DFH0XCP3.Request.com
primetype=string
param=ca_response_message
count=1
requiredcount=0
fldnum=10021
type=string
access=in
paramschema=XSD_E:ca_response_message@http://www.DFH0XCMN.DFH0XCP3.Request.com
primetype=string
param=ca_inquire_request
count=1
requiredcount=0
fldnum=10009
type=fml32
access=in
paramschema=XSD_E:ca_inquire_request@http://www.DFH0XCMN.DFH0XCP3.Request.com
(
param=ca_list_start_ref
count=1
requiredcount=0
fldnum=10017
type=short
access=in
paramschema=XSD_E:ca_list_start_ref@http://www.DFH0XCMN.DFH0XCP3.Request.com
primetype=unsignedShort
param=ca_cat_item
count=15
requiredcount=0
fldnum=10001
type=fml32
access=in
paramschema=XSD_E:ca_cat_item@http://www.DFH0XCMN.DFH0XCP3.Request.com
(
param=ca_item_ref
count=1
requiredcount=0
fldnum=10013
type=short
access=in
paramschema=XSD_E:ca_item_ref@http://www.DFH0XCMN.DFH0XCP3.Request.com
primetype=unsignedShort
param=on_order
count=1
requiredcount=0
fldnum=10029
type=short
access=in
paramschema=XSD_E:on_order@http://www.DFH0XCMN.DFH0XCP3.Request.com
primetype=unsignedShort
)
)
)
 
2.
Listing 13‑6 provides a VIEW32 output file example.
Listing 13‑6 VIEW32 Output Example
VIEW ca_cat_item_v
#TYPE CNAME FBNAME COUNT FLAG SIZE NULL
short ca_item_ref_v_times ca_item_ref_times 1 - - 0
short ca_item_ref_v ca_item_ref 1 - - 0
short on_order_v_times on_order_times 1 - - 0
short on_order_v on_order 1 - - 0
END
 
VIEW ca_inquire_request_v
#TYPE CNAME FBNAME COUNT FLAG SIZE NULL
short ca_list_start_ref_v_times ca_list_start_ref_times 1 - - 0
short ca_list_start_ref_v ca_list_start_ref 1 - - 0
short ca_cat_item_v_times ca_cat_item_times 1 - - 0
struct ca_cat_item_v ca_cat_item 15 - - 0
END
 
VIEW DFH0XCMNOperation_v
#TYPE CNAME FBNAME COUNT FLAG SIZE NULL
short ca_request_id_v_times ca_request_id_times 1 - - 0
string ca_request_id_v ca_request_id 1 - 255 '\0'
short ca_response_message_v_times ca_response_message_times 1 - - 0
string ca_response_message_v ca_response_message 1 - 255 '\0'
short ca_inquire_request_v_times ca_inquire_request_times 1 - - 0
struct ca_inquire_request_v ca_inquire_request 1 - - 0
END
 
tcxcsdcvt(1)
Name
tcxcsdcvt -- translates RDO file to all z/OS resource configuration files.
Synopsis
tcxcsdcvt [-option] [Filename]
Description
tcxcsdcvt translates RDO files to all z/OS resource configuration files.The generated resource configuration files by default are found in the current directory where this tool is run.
tcxcsdcvt supports the following options:
-h
Display help information for this tool.
-d <director>
Specifies the target directory for generated configuration files.
-D
Generate log file in case there is error information during conversion.
Example(s)
To convert the RDO file "lirgao.cicsb.dfhcsd", enter following command:
tcxcsdcvt lirgao.cicsb.dfhcsd
tcxmapgen(1)
Name
tcxmapgen — <Default ? Font>CICS Runtime MAPSET Generator.
Synopsis
tcxmapgen [-options] <file>
Description
<Default ? Font>CICS Runtime provides a mapset generator to compile BMS macro source files, to produce a physical (binary) file and a symbolic (copybook) file. There is also an option to produce a listing file. During execution, the mapset generator validates the syntax and level of support for each BMS macro statement.
The generated physical (binary) file should be used in the MAPSET configuration file. See “Mapset Configuration File” in CICS Runtime Configuration Files.
The generated symbolic (copybook) file should be included when you compile the CICS/COBOL program which uses the MAP in this MAPSET
Options
The command options are:
[-c]
Specifies that only COBOL copybook (.cpy) output file is generated.
[-l]
Specifies a listing output file (.lst) is produced.
[-m]
Specifies that only binary mapset file (.mpdef) is produced.
[-o file]
Specifies the name used for the generated output files. The compiler uses the file name with an appended extension when creating the output file names.
[-u]
Specifies that the output fields are not sorted but kept in the defined order. Without specifying this option, all fields in a map are sorted according to their positions by default.
[-A]
Generates aligned map. In aligned map, the length field associated with a BMS data field in the BMS DSECT is always aligned on a halfword boundary.
Note:
With -A, users can generate aligned map; without -A, users can generate unaligned map (default behavior).
Example(s)
To compile the BMS source file file.map,use the following command:
$ tcxmapgen -o file file.map
The resulting binary mapset file is file.mpdef.
artadmin(1)
Name
artadmin — ART CICS Runtime administration.
Synopsis
artadmin [-p <profile>] [-v]
Parameter
Profile
The name of the profile file used for authentification. This parameter is useful for secure Oracle Tuxedoconfiguration. The profile file must be created with genappprofile. If no file name is provided, it defaults to ~/.ADMINappProfile.
-v
Displays ART CICS Runtime version number and patch level. After printing out the information, artadmin exits.
Description
In some cases it is necessary to modify the configuration while the system is running. Normally, configuration changes which are relative to performances are managed by Oracle Tuxedo or the RDBMS level using commands (for example, tmadmin) or Oracle TSAM for Oracle Tuxedo dynamic configuration.
However, if the requirement is more functional (for example, needing to put some transactions online, installing a hot fix for some programs and screens, or changing some resource configurations), you must use artadmin.
artadmin is useful when making hot configuration changes in the CICS resources of a running ART CICS system. It allows the administrator to:
artadmin is launched interactively (similar to tmadmin). When the artdmin is launched and connects to Oracle Tuxedo successfully, it returns a prompt requiring you to enter the commands.
artadmin commands
Commands can be entered either by full name or abbreviation (as given in the parenthese), followed by any appropriate arguments. Arguments appearing in the square brackets [] are optional, and those in curly braces {} indicate a selection from mutually exclusive options.
To let a set of commands be executed together, the administration comannds entered are kept in the buffer and performed only when the administrator enters a perform commmand.
The commands with their abbreviation and options are described below.
clear (cl)
Resets the commands buffer.
config_update (cu) [on|off] (default is on)
Propagates the configuration changes and requests the application servers to take in the changes in the configuration.
help (h) [command]
Without extra argument: prints a list of all the commands.
With a command argument: prints the synopsis of the command.
list (l)
Displays the commands buffer.
If the buffer is empty, the message " WARNING: No command in buffer." is displayed.
newcopy (n) {p|s} object_name 1 object_name2 ...
Enters a newcopy command for screen or program object types.
perform (p)
Performs the commands submitted to the server and clears the commands buffer.
If the buffer is not empty, the buffer container is displayed and a confirmation is required.
If the submission fails, the message " Perform cancelled." is displayed, and the error is logged into the USERLOG.
quit (q)
Quits this session.
If the buffer is not empty, the buffer container is displayed and a confirmation is required.
shmstat (sh)
Displays the statistics for GETMAIN SHARED allocated by ARTSHM.
sysid (s) {*:SSSS}
By default, the administration commands are transmitted to all servers in the ART CICS system. The configuration is global. For the newcopy, you may want to limit it to some specific servers. The sysid command is used to limit the command effect to the servers with a specific SYSID.
tspstat (ts) TSMODEL
Shows TS queue statistics information under TSMODEL in shared pool. A sample output for the command is listed as follows:
> tspstat TSM00000
QueName NumItem TRNID TotLen MinLen MaxLen ReadCnt WritCnt ReWrCnt LifeTm ElapTm
------- ------- ----- ------ ------ ------ ------- ------- ------- ------ ------
LOGQHELO 3 HELO 118 56 56 0 3 0 5m 13s
LOGQSTCA 6 STCA 180 16 52 0 6 0 8m 25s
tspdel (td) TSMODEL qname
Deletes TS queue qname in TSMODEL in the shared pool.
tspdsp (tp) TSMODEL qname itemno
Displays item itemno message of TS queue qname in TSMODEL in the shared pool. This command does not change read cursor of the queue. If the message is too large, only part of the message is displayed.
tspclr (tc) poolname
Clears all queues in TS pool poolname.
Limitations
The transactions.desc TRANCLASS parameter cannot be changed dynamically.
When using NEWCOPY command to reload programs, you must delete the compiled executable file before copying new compiled executable file to runtime environment.
kixrpt(1)
Name
kixrpt.shARTKIX transaction/command report utility.
Synopsis
kixrpt.sh [-d "YYYY/MM/DD[hh:mm:ss]"] [-D "YYYY/MM/DD[hh:mm:ss]"] [-c] trace
Description
kixrpt reports transaction/command timing statistics information, including total number of transactions/commands running in specified time slot, total time cost, the average running time, etc. For each transaction/command, such tool reports the details of running information: total number, total time cost, average time cost, failure count, etc.
kixrpt analyzes the standard output of ARTKIX servers to provide a summary of transaction / command processing time within the servers. The report shows the number of times dispatched and average elapsed time in milliseconds of each transaction / command in the covered period. kixrpt takes its input from the ARTKIX trace file or a directory (like KIX_TRACE_PATH) including trace files. The traces are valid by being set as below:
KIX_TRACE_LEVEL=1 (or higher level)
Options
kixrpt supports the following options:
-d "YYYY/MM/DD[ hh:mm:ss]"
Limits the start time. The default is no limitation.
-D "YYYY/MM/DD[ hh:mm:ss]"
Limits the end time. The default is no limitation.
-c
Generates the clear trace output instead of statistics report.
Example
1.
KIX_TRACE_LEVEL=1
TP_USER_TRACE=SID
TRACE_PATH=${APPHOME}/LOGS/traces
2.
After running some time, the statistic tool, kixrpt.sh, can be used to generate the report with given time slot.
$ kixrpt.sh -d 2012/06/21 -D 2012/06/22 $TRACE_PATH
3.
Listing 13‑7 provides the output example:
Listing 13‑7 kixrpt Output Example
Transactions:
------------------------------------------------------------
CPMI(10000)totalTime(2254147)avgTime(225)errNum(0)
------------------------------------------------------------
totals(10000)totalTime(2254147)avgTime(225)
 
Commands:
------------------------------------------------------------
KIX__LINK(10000)totalTime(1047970)avgTime(104)errNum(0)
KIX__DELETEQ_TS(20000)totalTime(9377)avgTime(0)errNum(0)
KIX__RETURN(20000)totalTime(1016)avgTime(0)errNum(0)
KIX__WRITEQ_TS(380000)totalTime(153888)avgTime(0)errNum(0)
KIX__ASSIGN(300000)totalTime(19702)avgTime(0)errNum(0)
------------------------------------------------------------
totals(730000)totalTime(1231953)avgTime(1)
 
Programs:
------------------------------------------------------------
TUX2CXD(10000)totalTime(1047970)avgTime(104)
------------------------------------------------------------
totals(10000)totalTime(1047970)avgTime(104)
 
checkcicsbinver(1)
Name
checkcicsbinver—checks Rolling Patch number where your COBOL program is compiled.
Synopsis
checkcicsbinver <PROGRAM-ID>
Description
checkcicsbinver checks Rolling Patch number where your COBOL program is compiled.
checkcicsbinver supports the following options:
PROGRAM-ID
Name of the COBOL program without any suffix.
Environment Variables
Declare these environment variables, as prerequisites, to run checkcicsbinver.
For Micro Focus COBOL, you should do the followings.
COBDIR
Specify the COBOL installation directory for COBDIR.
LD_LIBRARY_PATH (Linux and Solaris platforms) / LIBPATH (AIX platforms)
Add $COBDIR/lib to LD_LIBRARY_PATH (Linux and Solaris platforms) / LIBPATH (AIX platforms).
COBPATH
Specify the path where the COBOL program locates for COBPATH.
PATH
Add the location of checkcicsbinver into PATH.
For COBOL-IT COBOL, you should do the followings.
COBOLITDIR
Specify the COBOL installation directory for COBOLITDIR.
LD_LIBRARY_PATH (Linux and Solaris platforms) / LIBPATH (AIX platforms)
Add $COBDIR/lib to LD_LIBRARY_PATH (Linux and Solaris platforms) / LIBPATH (AIX platforms).
COB_LIBRARY_PATH
Specify the path where COBOL program locates for COB_LIBRARY_PATH.
PATH
Add the location of checkcicsbinver into PATH.
Example(s)
For COBOL programs built on 12.1.3.0.0 GA through 12.1.3.0.0 Rolling Patch 018, the output will be:
Program <xxxx> version No.12.1.3.0.0 RP000
For COBOL programs built on 12.1.3.0.0 Rolling Patch 019 or higher, the output will be:
Program <xxxx> version No.12.1.3.0.0 RP019 or higher
artcicsutil(1)
Name
artcicsutil—ART for CICS Control Utility.
Synopsis
artcicsutil [-t command_mode] [-p <profile>] [-d]
Description
artcicsutil is the premier control utility to track and dominate the CICS related resources from ART for Batch.
It's always triggered by ART for Batch jobs. With the single command, ART for Batch jobs can open/close files, enable/disable CICS transactions, initiate CICS transactions, and etc.
Currently, artcicsutil offers two kinds of subcommands set, IPCP and CAFC. Besides that, artcicsutil provides NATIVE mode, which can work as a native Oracle Tuxedo client without involving ART for Batch.
artcicsutil supports the following options:
-t command_mode
The mode of command set. Possible values are IPCPBTCH, CAFC, and NATIVE (default value).
IPCPBTCH means artcicsutil accepts IPCP command set (artcicsutil acts as IPCP utility). The supported IPCP command set is listed as follows.
CICS CC ONLY=cics1[,cics2,...] (Choose the target ART for CICS region to process this request)
CLOS|CLOSE [DB] ddname1[,ddname2,ddname3,....] (Similar to SET FILE OPEN/CLOSE)
DISA KC trna[,trnb,trnc,trnd,...] (Similar to SET TRANSACTION DISABLED)
ENAB KC trna[,trnb,trnc,trnd,...] (Similar to SET TRANSACTION ENABLED)
INIT KC trna[,data] (similar to START TRANSID)
CAFC means artcicsutil accepts CAFC command set (artcicsutil acts as CAFC utility). The supported CAFC command set is listed as follows.
NATIVE (default value) means artcicsutil accepts interactive commend set (artcicsutil acts as a native client, launched interactively by end users). The supported interactive command set is listed as follows. Those subcommands are full name or abbreviation, followed by appropriate arguments. Arguments in square brackets [] are optional. For enable/disable transid subcommands, you can set 18 transid items at most. For open/close VSAM file subcommands, you can set 18 file items at most.
applid (ap) [SSSSSSSS]: get/set applid
enable (ena) trna [trnb trnc ...]: enable transaction(s)
disable (dis) trna [trnb trnc ...]: disable transaction(s)
start (str) trna ['data']: start one transaction
open (op) FILE: open VSAM file
close (cs) FILE: close VSAM file
inquire (inq) FILE: inquire VSAM file
quit (q): quit the tool
-p profile
The name of the profile file used for authentication. This parameter is useful for secure Oracle Tuxedo configuration. The profile file must be created with genappprofile. If no file name is provided, it defaults to ~/.ADMINappProfile.
-d
This option enables diagnostic message output in IPCP or CAFC commend set.
System Transactions
Authentication Transactions
CESN
The CESN transaction uses MAPSET CSIGNON. The following MAPSET definition must be added to the MAPSET configuration file ${KIXCONFIG}/mapsets.desc if CESN transaction is required:
[mapset]
name=CSIGNON
filename="<${KIXDIR}>/sysmap/csignon.mpdef"
Using this default MAPSET definition, CESN supports a maximum eight-character username and a maximum eight-character password. If the following MAPSET definition is added to the MAPSET configuration file, CESN allows a maximum 20-character username and a maximum 32-character password.
[mapset]
name=LSIGNON
filename="<${KIXDIR}>/sysmap/lsignon.mpdef"
If two MAPSET definitions are both added to the MAPSET configuration file, the default MAPSET definition CSIGNON is used. CESN, in this case, allows a maximum eight-character username and a maximum eight-character password.
The CESN transaction ignores the UCTRAN setting in the TYPETERM configuration file. The username and password entered from terminal are always case-sensitive, no matter which UCTRAN value is set.
CESF
No special configuration is required for CESF transaction.
CSGM
<Default ? Font>Oracle Tuxedo Application Runtime for CICS provides a default "Good Morning" transaction CSGM, which can be added to the Transaction configuration file ${KIXCONFIG}/transactions.desc.
The default CSGM transaction uses MAPSET ABANNER. So the following MAPSET definition must be added to the MAPSET configuration file if the default CSGM transaction is configured:
[mapset]
name=ABANNER
filename="<${KIXDIR}>/sysmap/abanner.mpdef"
ALST (Application List Transaction)
ALST (Application List Transaction) is used to do multiple session management. It is integrated with user plug-in to enable you to get and show application list.
To use this transaction, you should define it in transactions.desc configuration file and specify DFHALST as its PROGRAM as follows. DFHALST is written in C language; ART for CICS provides it to implement ALST.
ALST;SIMPAPP;Application list transaction;DFHALST
For more information, see "Implementing Using Multiple Session Management" in Oracle Tuxedo Application Runtime for CICS User Guide.

Copyright © 1994, 2017, Oracle and/or its affiliates. All rights reserved.