Previous Topic: Modify the application JCL— z/VSENext Topic: Step 2: Modify and Recompile the Application Program


CA IDMS VSAM Transparency parameters

The table below presents a detailed list of the CA IDMS VSAM Transparency parameters, which you can use in the application program JCL.

Considerations

The following considerations apply:

Parameter

Description

CWADISP=nnnn

Specifies a value equal to the CWADISP specified in the assembly of IDMSINTC. The CWADISP parameter is mandatory for CICS processing and is invalid for batch processing. It can be up to 4 digits long and is typically around 16.

DBNAME=database-name

Specifies the default database to be used with the CA IDMS VSAM Transparency application program (BATCH mode) or the default database to be used with all CICS CA IDMS VSAM Transparency transactions (CICS mode). This parameter is used in a multiple-database environment. You can override this parameter for each CICS CA IDMS VSAM Transparency transaction by using the transaction name table. The DBNAME parameter can be from 1 to 8 characters long.

FMT=fmt-name

Identifies the file management table that defines the file to be escaped. The FMT parameter is mandatory for all CA IDMS VSAM Transparency files. It can be from 1 to 8 characters long and must be included in all file statements.

MSG=LOG/CONS/OFF

Displays the CA IDMS VSAM Transparency key feedback (runtime) messages during program execution. The options are:

  • LOG (the default) writes the key feedback messages to the log file.
  • CONS writes the key feedback messages to the operator console.
  • OFF turns off the display of key feedback messages.

CA IDMS VSAM Transparency writes key feedback messages for any open call, close call, or call that is in error. The format is as follows:

FDBK=nnnnnnnn

Nnnnnnnn is an 8-byte field that contains the key feedback message code.

MODE= BATCH/CICS

Indicates whether the CA IDMS VSAM Transparency application program is to run in BATCH or CICS mode. The default is BATCH.

NODENAME=nodename

Specifies the nodename to be used with the CA IDMS VSAM Transparency application program (BATCH mode) or the default nodename to be used with all CICS CA IDMS VSAM Transparency transactions (CICS mode). This parameter is used in a multiple-database environment. You can override this parameter for each CICS CA IDMS VSAM Transparency transaction by using the transaction name table.

The NODENAME parameter can be from 1 to 8 characters long.

OCMSGS=ALL/ERROR

Specifies which messages you want displayed on the console. The options are:

  • ALL indicates both informational and error messages are displayed on the console.
  • ERROR indicates that only error messages are displayed on the console.

RBUFSZ=nnnnn

Indicates the size of the buffer that CA IDMS VSAM Transparency will use for communication between the front end and the back end. The default is 512 bytes.

The RBUFSZ parameter can be from 1 to 5 digits long and is valid for the central version only.

The value must accommodate the sum of the longest record length plus its key length. CA IDMS VSAM Transparency adds the length of its overhead to the RBUFSZ you specify.

STATS= ON/FILE

Requests that database statistics be collected for all CA IDMS VSAM Transparency files accessed either by the CA IDMS VSAM Transparency application program (BATCH mode) or by all CA IDMS VSAM Transparency CICS transactions (CICS mode). The options are:

  • ON places the statistics for all CA IDMS VSAM Transparency files together on the system log.
  • FILE places the statistics for each CA IDMS VSAM Transparency file separately on the system log.

The STATS parameter is not available in local mode.

SUBSCHEMA=subschema-name

Identifies the subschema to be used with the CA IDMS VSAM Transparency application program (BATCH mode) or the default subschema to be used with all CA IDMS VSAM Transparency CICS transactions (CICS mode). This parameter is mandatory for both BATCH mode and CICS mode. You can override the SUBSCHEMA parameter for each CICS CA IDMS VSAM Transparency transaction by using the transaction name table.

The SUBSCHEMA parameter can be from 1 to 8 characters long.

TNT=tnt-name

Identifies the transaction name table that CA IDMS VSAM Transparency will use for processing CICS transactions. This parameter is optional if all transactions are to use the same subschema. It is required if more than one subschema is to be used. The TNT parameter is invalid in the batch environment.

The TNT parameter can be from 1 to 8 characters long.

TRACE=nnnn,WRAP/LOG

Requests that a trace of calls made by the CA IDMS VSAM Transparency application program be displayed on the system log. Nnnn is the number of fullwords allowed in the trace table and can be from 1 to 4 digits long. The TRACE options are as follows:

  • WRAP (the default) enables the trace table to wrap around if the fullword limit is reached. This means that subsequent program calls will be recorded over the existing trace table.
  • LOG writes the trace table to CDMSLOG and then clears the trace table, if the limit for the trace table is reached. This means that subsequent program calls will be recorded on the cleared trace table. The LOG option is not available in local mode.