Oracle Tuxedo Application Runtime for CICS CSD Converter

This chapter contains the following topics:

•

Overview

•	Resource Definition Online (RDO) Mapping

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.

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"CICS Runtime Configuration Files" in Oracle Tuxedo Application Runtime for CICS Reference Guide.

Figure 7‑1depicts the file data stream model.

Figure 7‑1 File 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 7‑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 7‑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 7‑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 7‑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 7‑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 7‑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 7‑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 7‑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 7‑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 7‑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.