z/VSE CICS SYSESVS Parameters › SYSESVS Parameter File

SYSESVS Parameter File

Purpose

At z/VSE CICS VSAM/T startup, CA IDMS reads a SYSESVS parameter file. The purpose of this file is to accommodate all the VSAM/T parameters required to run VSAM/T transactions in a z/VSE CICS environment.

What the File Contains

The SYSESVS parameter file consists of 80-character records which can contain any number of keyword operands and keyword values. The file contains the following types of parameters:

• Global parameters—Describe VSAM/T characteristics that will be in affect for all VSAM/T activity
• File-specific parameters—Specify the file name and file management table for each VSAM/T file defined to the CICS system.

The table below provides the layout of the SYSESVS record:

What to Consider

If a '--' character string is encountered in any position in a SYSESVS line, the rest of the line is treated as comments. Any number of blanks, commas, or semicolons can separate the keyword operands.

Global Parameters

The SYSESVS keyword operands and their values are:

CWADISP=nnnn

Specifies the 1- to 4-digit value equal to the CWADISP specified in the assembly of IDMSINTC. The CWADISP parameter is required and its value is typically around 16.

DBNAME=xxxxxxxx

Specifies the 1- to 8-character name of the default database to be used with all CICS VSAM/T transactions. This parameter is used in a multiple-database environment. You can override this parameter for each CICS VSAM/T transaction by using the transaction name table (TNT).

NODENAME=xxxxxxxx

Specifies the 1- to 8-character default DDS node to be used with all CICS VSAM/T transactions. This parameter is used in a multiple-database environment. You can override this parameter for each CICS VSAM/T transaction by using the transaction name table (TNT).

DICTNAME=xxxxxxxx

Specifies the 1- to 8-character name of the data dictionary containing the VSAM/T SUBSCHEMA. This parameter is used in a multiple-dictionary environment. You can override this parameter for each CICS VSAM/T transaction by using the transaction name table (TNT).

DICTNODE=xxxxxxxx

Specifies the 1- to 8-character location of the data dictionary containing the VSAM/T SUBSCHEMA. This parameter is used in a multiple-dictionary environment. You can override this parameter for each CICS VSAM/T transaction by using the transaction name table (TNT).

SUBSCHEMA=xxxxxxxx

Specifies the 1- to 8-character default subschema name to be used with all CICS VSAM/T transactions. This parameter is required. You can override this parameter for each CICS VSAM/T transaction by using the transaction name table (TNT).

TNT=xxxxxxxx

Specifies the 1- to 8-character transaction name table that will be used when processing CICS VSAM/T transactions. If all transactions will use the same subschema, this parameter is optional. If you use more than one subschema, this parameter is required.

RBUFSZ=nnnnn

Specifies the 1- to 5-digit size of the buffer that VSAM/T uses for communication between the front end and the back end. The default buffer size is 1024 bytes.

MSG=LOG/CONS/ALL/OFF

Displays the VSAM/T key feedback (run-time) messages during program execution. Values are:

• LOG Writes the key feedback messages to the log file (default)
• CONS Writes the key feedback messages to the operator console
• ALL Writes all RPL messages to the log file
• OFF Turns off the display of key feedback messages and RPL messages
• VSAM/T writes key feedback messages for any open call, close call, or call that is in error, in the following format:
• FDBK=nnnnnnnn
• Nnnnnnnn is an 8-byte field that contains the key feedback message code.

STATS=ON/FILE

Requests that database statistics be collected for all CICS VSAM/T transactions. Values are:

• ON Places statistics for all VSAM/T files together on the system log
• FILE Places the statistics for each VSAM/T file separately on the system log

OCMSGS=ALL/ERROR

Specifies which messages you want to appear on the console. Values are:

• ERROR Indicates that only error messages will appear on the console (default)
• ALL Indicates that both informational and error messages will appear on the console

TRACE=nnnn

Requests that a trace of calls made by the VSAM/T application program be displayed on the system log, where nnnn is the 1- to 4-digit number of fullwords allowed in the trace table.

TRACETYPE=WRAP/LOG

Specifies the trace options to be in affect when the TRACE parameter has been specified. Values are:

• WRAP Enables the trace table to wrap around if the fullword limit is reached (default). 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 fullword limit for the trace table is reached. This means that subsequent program calls will be recorded on the cleared trace table.

File-Specific Parameters

You must specify the following parameters for each VSAM/T file that is to be processed during the CICS session:

FILENAME=xxxxxxxx

Specifies a 1- to 7-character FILENAME of a VSAM/T file that is to be processed during this CICS session.

FMT=xxxxxxxx

Specifies the 1 to 8-character file management table that defines the VSAM/T file characteristics for the file name specified in the FILENAME parameter, where xxxxxxxx is the table name. This parameter is required and must follow the associated FILENAME parameter immediately.