Table of Contents Previous Next PDF


System Commands and Transactions
System Commands and Transactions
System Commands
Table 1 System Commands
Name
Description
cpy2view32(1)
Generates VIEW32 definition from COPYBOOK
tcxcsdcvt (1)
CICS CSD Converter
tcxmapgen(1)
CICS Runtime MAPSET Generator
 
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:
-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.
The following example converts exceptional copybook file abc.cbl to view file abc.v:
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 10-1 through Listing 10-4 provide Copybook and view file output examples:
Listing 10‑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 10‑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 10‑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 10‑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.
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 — CICS Runtime MAPSET Generator.
Synopsis
tcxmapgen [-options] <file>
Description
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.
Example(s)
To compile the BMS source file file.map, usethe following command:
$ tcxmapgen -o file file.map
The resulting binary mapset file is file.mpdef.
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 password. If the following MAPSET definition is added to the MAPSET configuration file, CESN allows a maximum 32-characters 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 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
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"
 

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