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
artadmin (1)
ART CICS Runtime administration
 
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.
[-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.
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>]
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.
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:
•
request all or partial servers to take in changes to the CICS resources configuration files.
•
transmit a New Copy request to do a hot fix of some modified programs or maps.
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.
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.
Limitations
•
The resources which are taken in account on a dynamic reloading operation are limited to transactions, programs, and mapsets.
•
The transactions.des TRANCLASS parameter cannot be changed dynamically.
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.