1. Application Runtime for CICS User's Guide
  2. Oracle Tuxedo Application Runtime for CICS CSD Converter

6 Oracle Tuxedo Application Runtime for CICS CSD Converter

This chapter contains the following topics:

6.1 Overview

The administration of CICS Runtime is based on Oracle Tuxedo native tools with the addition of a limited number of configuration tables for features that are specific to CICS. In CICS configurations, resources are currently defined in the CICS system definition file (CSD).

The tcxcsdcvt tool (located in the $KIXDIR/tools directory), maps the CSD file to resource descriptive files (including transaction, transaction class, program, files, TS Queue, ENQ, TD Queue extra partition, TD Queue intra partition, mapset, and typeterm).

This tool is used to set the target CSD file in argument, and the translated resource configuration files resides in current directory by default. You can also specify other target directories to store the configuration files.

Parent topic: Oracle Tuxedo Application Runtime for CICS CSD Converter

6.2 Resource Definition Online (RDO) Mapping

Resource Definition Online (RDO) Mapping consists of two parts:

  1. Files conversion from RDO/CSD on z/OS to resource configuration files of all types on universal platform, such as transactions, programs, mapsets and etc.
  2. For each types, tool tcxcsdcvt reads the value of all fields, and then generates a record in the corresponding resource configuration file. For more information, see Oracle Tuxedo Application Runtime for CICS Reference Guide

Figure 6-1 Data Stream Model


Data Stream Model

Tables 1~10 describe detailed correspondence between RDO/CSD and target resource configuration files, which have ".desc" as suffix mentioned above. These mappings include:

  • TRANCLASS Mapping
  • PROGRAM Mapping
  • FILE Mapping
  • Journaling Attributes in FILE Mapping
  • TSQUEUE MODEL Mapping
  • ENQMODEL Mapping
  • TDQUEUE Extra Partition Mapping
  • TDQUEUE Intra Partition Mapping
  • MAPSET Mapping
  • TYPETERM Mapping

Note:

Since some field names are new options added in CICS Runtime Configuration Files, they are not defined or supported by RDO/CSD. To mark these attributes "----" is used.

Table 6-1 TRANCLASS Mapping

Field Name in ART FOR CICS Resource Attribute in RDO/CSD Description
TRANCLASS TRANCLASS Name of the transaction class.
GROUP GROUP The group notion of CICS allowing a group of related resources to be declared and instantiated or not by a CICS system when starting.
DESCRIPTION DESCRIPTION A small textual comment zone for description of the resource.
MAXACTIVE MAXACTIVE Defines the degree of parallelism of execution.

Table 6-2 PROGRAM Mapping

Field Name in ART FOR CICS Resource Attribute in RDO/CSD Description
PROGRAM PROGRAM Name of the program.
GROUP GROUP The group notion of CICS allowing a group of related resources to be declared and instantiated or not by a CICS system when starting.
DESCRIPTION DESCRIPTION A small textual comment zone for description of the resource.
LANGUAGE LANGUAGE The language of the program, required to know how to communicate with it.
EXECKEY EXECKEY Reserved for future use. Concerns memory protection of CICS shared structures.
STATUS STATUS Specifies the program status.
REMOTESYSTEM REMOTESYSTEM Specifies that the program is not offered locally but in a DPL server.
REMOTENAME REMOTENAME Specifies for a DPL program the name of the program on the distant site.

Table 6-3 FILE Mapping

Field Name in ART FOR CICS Resource Attribute in RDO/CSD Description
FILE FILE Name of the file; logical name of the file used in EXEC CICS related to this file.
GROUP GROUP The group notion of CICS allowing a group of related resources to be declared and instantiated or not by a CICS system when starting.
DESCRIPTION DESCRIPTION A small textual comment zone for description of the resource.
DISPOSITION DISPOSITION Specifies the disposition of this file.
DSNAME DSNAME Specifies the data set name to be used for this file.
JOURNAL JOURNAL Specifies whether you want automatic journaling for this file.
KEYLENGTH KEYLENGTH Specifies the length in bytes of the logical key of records in remote files, and in coupling facility data tables that are specified with LOAD (NO).
OPENTIME OPENTIME Specifies when the file is opened.
READINTEG READINTEG Specifies the level of read integrity required for files defined with RLSACCESS (YES).
RECORDSIZE RECORDSIZE Specifies the maximum length in bytes of records in a remote file or a coupling facility data table.
REMOTENAME REMOTENAME Specifies the name of the file on the remote system.
REMOTESYSTEM REMOTESYSTEM On source, specifies the name of the connection that links the local system to the remote system where the file resides. On the target platform, will be used only in case of file shipping to another system, either another TUXEDO system or native CICS system.
STATUS STATUS Specifies the initial status of the file following a CICS initialization.

Table 6-4 Journaling Attributes in FILE Mapping

Field Name in ART FOR CICS Resource Attribute in RDO/CSD Description
JNLADD JNLADD Specifies if you want the add operations recorded on the journal nominated by the JOURNAL attribute.
JNLREAD JNLREAD Specifies the read operations you want recorded on the journal nominated by the JOURNAL attribute.
JNLSYNCREAD JNLSYNCREAD Specifies whether you want the automatic journaling records, written for READ operations to the journal, to be synchronous.
JNLSYNCWRITE JNLSYNCWRITE Specifies whether you want the automatic journaling records, written for WRITE operations to the journal, to be synchronous.
JNLUPDATE JNLUPDATE Specifies whether you want REWRITE and DELETE operations recorded on the journal.

Table 6-5 TSQUEUE MODEL Mapping

Field Name in ART FOR CICS Resource Attribute in RDO/CSD Description
TSMODEL TSMODEL Name of the TS Queue model.
GROUP GROUP The group notion of CICS allowing a group of related resources to be declared and instantiated or not by a CICS system when starting.
DESCRIPTION DESCRIPTION A small textual zone for description of the resource.
LOCATION LOCATION Specifies the kind of storage to use: file or memory.
PREFIX

XPREFIX

PREFIX

XPREFIX

Specifies the character string that is to be used as the prefix for this model.
RECOVERY RECOVERY Specifies whether or not queues matching this model are to be recoverable.
POOLNAME POOLNAME Specifies the 8-character name of the shared TS pool definition that you want to use with this TSMODEL definition.
REMOTE_SYSTEM REMOTESYSTEM On source platform, specifies the name of the connection that links the local system to the remote system where the temporary storage queue resides. On the target platform, used only in case of TS shipping to another system, either another TUXEDO system or native CICS system.
REMOTEPREFIX XREMOTEPREFIX REMOTEPREFIX

XREMOTEPREFIX

Specifies the character string that is to be used as the prefix on the remote system. The prefix may be up to 16 characters in length
SECURITY SECURITY Specifies whether security checking is to be performed for queues matching this model.

Table 6-6 ENQMODEL Mapping

Field Name in ART FOR CICS Resource Attribute in RDO/CSD Description
ENQMODEL ENQMODEL Name of the ENQ model.
GROUP GROUP The group notion of CICS allowing a group of related resources to be declared and instantiated or not by a CICS system when starting.
DESCRIPTION DESCRIPTION A small textual zone for description of the resource.
ENQNAME ENQNAME Specifies the 1 to 255-character resource name.
ENQSCOPE ENQSCOPE If omitted or specified as blanks, matching enqueue models will have a local scope, else they will have a global scope
STATUS STATUS E = Enabled; D = Disabled.

Table 6-7 TDQUEUE Extra Partition Mapping

Field Name in ART FOR CICS Resource Attribute in RDO/CSD Description
TDQUEUE TDQUEUE Specifies the 1- to 4-character name of a transient data queue.
GROUP GROUP The group notion of CICS allowing a group of related resources to be declared and instantiated or not by a CICS system when starting.
DESCRIPTION DESCRIPTION A small textual zone for description of the resource.
DDNAME DDNAME Specifies a 1-to 8-character value that may refer to a data set defined in the startup JCL.
DISPOSITION DISPOSITION Specifies the disposition of the data set (MOD; OLD; SHR).
ERRORPTION ERRORPTION (UNSUPPORTED) Specifies the action to be taken if an I/O error occurs.
OPENTIME OPENTIME (UNSUPPORTED) Specifies the initial status of the data set.
RECORDFORMAT RECORDFORMAT Specifies the record format of the data set.
PRINTCONTROL PRINTCONTROL (UNSUPPORTED) Specifies the control characters to be used.
RECORDSIZE RECORDSIZE Specifies the record length in bytes.
TYPEFILE TYPEFILE Specifies the type of data set the queue is to be associated with an input or output dataset.
DSNAME DSNAME Specifies the name of the file that is to be used to store records written to this extra partition queue.
SYSOUTCLASS SYSOUTCLASS (UNSUPPORTED) Specify the class of the SYSOUT data set.
TRT ---- Allow integrators and customers to make their own specific implementation of extra-partition queues.

Table 6-8 TDQUEUE Intra Partition Mapping

Field Name in ART FOR CICS Resource Attribute in RDO/CSD Description
TDQUEUE TDQUEUE Specifies the 1- to 4-character name of a transient data queue.
GROUP GROUP The group notion of CICS allowing a group of related resources to be declared and instantiated or not by a CICS system when starting.
DESCRIPTION DESCRIPTION A small textual zone for description of the resource.
RECOVSTATUS RECOVSTATUS Specifies if the queue is logically recoverable or not.
TRANSID TRANSID Specifies the name of the transaction that is to be automatically initiated when the trigger level is reached.
TRIGGERLEVEL TRIGGERLEVEL Specifies the number of records to be accumulated before a task is automatically initiated to process them.
USERID USERID Specifies the userid you want CICS to use for security checking when verifying the trigger-level transaction specified in the TRANSID field.
WAIT WAIT (INACTIVE field) Accepted only in the resource loading.
WAITACTION WAITACTION (INACTIVE field) Accepted only in the resource loading.
QSPACENAME ---- Specify the name of the tuxedo /Q QSPACE into which this queue is physically stored.
TRT ---- Allow integrators and customers to make their own specific implementation of intra-partition queues.

Table 6-9 MAPSET Mapping

Field Name in ART FOR CICS Resource Attribute in RDO/CSD Description
NAME MAPSET Name of the MAPSET.
GROUP GROUP Installation group name.
DESCRIPTION DESCRIPTION A general description of the MAPSET resource.
RESIDENT RESIDENT YES=preload. NO=load on first use.
swastatus STATUS Sets the status of the resource, to specify if it is available.
Usage USAGE Specifies the caching scheme to be used once the MAPSET is loaded.
FILENAME ---- Specifies the physical (binary) file name of the mapset, which is generated by the tcxmapgen utility (refer to section).

Table 6-10 TYPETERM Mapping

Field Name in ART FOR CICS Resource Attribute in RDO/CSD Description
NAME TYPETERM Name of the typeterm.
GROUP GROUP The group notion of CICS allowing a group of related resources to be declared and instantiated or not by a CICS system when starting.
DESCRIPTION DESCRIPTION A small textual zone for description of the resource.
color COLOR Designates extended color attributes.
defscreencolumn DEFSCREEN (rows, columns) Number of columns of the default screen size.
defscreenrow DEFSCREEN (rows, columns Number of rows of the default screen size.
hilight HILIGHT Indicates whether a terminal supports the highlight feature.
logonmsg LOGONMSG Indicates whether the "Good Morning" (CSGM) transaction is automatically started on the terminal.
outline OUTLINE Indicates whether the terminal supports field outlining.
swastatus STATUS Specifies the resource status (whether available).
uctran UCTRAN Specify whether translate lowercase alphabetic characters to uppercase, or only translate the transaction ID from lowercase to uppercase, or not translate any characters.
userarealen USERAREALEN The terminal control table user area (TCTUA) area size for the terminal.
INTERCODE ---- Specifies which encoding type of inbound data is used.
EXTERCODE ---- Specifies which encoding type of outbound data is used.
SOSI SOSI Specifies whether mixed EBCDIC and double-byte character set (DBCS) is supported.
PROGSYMBOLS PROGSYMBOLS Specifies whether the programmed symbol (PS) facility is supported.

Parent topic: Oracle Tuxedo Application Runtime for CICS CSD Converter