Previous Topic: About This AppendixNext Topic: z/VSE CICS SYSESVS Parameters

TSO File Allocation with CA IDMS VSAM Transparency › TSO File Allocation Syntax

TSO File Allocation Syntax

Purpose

Under TSO, each CA IDMS VSAM Transparency file must be directed to the subsystem. The ESVSALLO command allocates an CA IDMS VSAM Transparency file under TSO. It establishes a connection to the CA IDMS VSAM Transparency subsystem and defines the attributes of the CA IDMS VSAM Transparency file.

Syntax

►►─── ESVSALLO ────┬─ FILE(filename) ────┬────────────────────────────────────►
                   └─ DDNAME (filename) ─┘

 ►─── FMT (fmtname) ──────────────────────────────────────────────────────────►

 ►──┬────────────────────────┬────────────────────────────────────────────────►
    └─ SSc (subschema-name) ─┘

 ►──┬──────────────────────────────────────┬──────────────────────────────────►
    └─ SUbsys ( ─┬── ESVS ◄ ─────────┬─ ) ─┘
                 └── subsystem-name ─┘

 ►──┬──────────────────────────────┬──────────────────────────────────────────►
    └─ Rbufsz ( ─┬─ 512 ◄ -─┬─ ) -─┘
                 └─ nnnnn -─┘

 ►──┬───────────────────────────┬─────────────────────────────────────────────►
    └─ DBname (database-name) -─┘

 ►──┬───────────────────────┬─────────────────────────────────────────────────►
    └─ Nodename (nodename) ─┘

 ►──┬──────────────────────────────┬──────────────────────────────────────────►
    └─ DICTNAme (dictionary-name) ─┘

 ►──┬───────────────────────┬─────────────────────────────────────────────────►
    └─ DICTNOde (nodename) ─┘

 ►──┬─────────────────────────┬───────────────────────────────────────────────►
    └─ MSg ( ─┬─ LOG ◄ ─┬─ ) ─┘
              ├─ CONS -─┤
              └─ OFF ───┘

 ►──┬────────────────────────────┬────────────────────────────────────────────►
    └─ STats ( ─┬─ FILE ─┬─ ) ───┘
                └─ ON ───┘

 ►──┬─────────────────────────────────────┬───────────────────────────────────►◄
    └─ Trace ( ── nnnn -─┬─ WRAP ─┬─ ) ───┘
                         └─ LOG -─┘

Parameters

FILE(filename)/DDNAME(filename)

Specifies the CA IDMS VSAM Transparency file. Filename is a 1- to 8-character name that must be included in each invocation of the command.

FMT(fmtname)

Specifies the name of the file management table that defines the file to be escaped. Fmtname is a 1- to 8-character name that must be included in each invocation of the command.

SSc(subschema-name)

Specifies the name of the subschema to be used with the CA IDMS VSAM Transparency program. You must specify the subschema for the first file allocated; it is optional for subsequent files. The subschema specified for the first file allocated is used for all subsequent file allocations (whether or not a different subschema is specified) unless all CA IDMS VSAM Transparency file allocations are freed within TSO. Then, the last subschema defined on an allocation will be the one used.

SUBsys(subsystem-name)

Specifies the name of the CA IDMS VSAM Transparency subsystem. The default is ESVS.

Rbufsz(nnnnn)

Specifies the size of the buffer that CA IDMS VSAM Transparency uses for communication between the front end and the back end. The default is 512. Nnnnn is a 1- to 5-digit number that is valid for central version only. RBUFSZ must be specified before the first file is opened (readied). It may be re-specified on subsequent file allocation statements as long as all previously allocated files have been closed.

DBname(database-name)

Specifies the name of the CA IDMS/DB database. DBNAME must be specified before the first file is opened (readied). It may be re-specified on subsequent file allocation statements as long as all previously allocated files have been closed.

Nodename(nodename)

Specifies the nodename of a DC/UCF system. NODENAME must be specified before the first file is opened (readied). It may be re-specified on subsequent file allocation statements as long as all previously allocated files have been closed.

DICTNAme(dictionary-name)

Specifies the name of the data dictionary containing the subschema. DICTNAME must be specified before the first file is opened (readied). It may be re-specified on subsequent file allocation statements as long as all previously allocated files have been closed.

DICTNOde(nodename)

Specifies the location of the dictionary. DICTNODE must be specified before the first file is opened (readied). It may be re-specified on subsequent file allocation statements as long as all previously allocated files have been closed.

MSg(LOG/CONS/OFF)

Specifies the destination of the CA IDMS VSAM Transparency key feedback messages. LOG is the default. CONS writes the feedback messages to the console and the log. OFF turns off the display of feedback messages.

MSG must be specified before the first file is opened (readied). It may be re-specified on subsequent file allocation statements as long as all previously allocated files have been closed.

STats(FILE/ON)

Requests that database statistics be collected for all CA IDMS VSAM Transparency files accessed. ON places statistics for all files together on the log file. FILE places statistics for each file separately on the log file. STATS must be specified before the first file is opened (readied). It may be re-specified on subsequent file allocation statements as long as all previously allocated files have been closed.

Trace(nnnn,WRAP/LOG)

Requests that a trace of calls made by the CA IDMS VSAM Transparency program be displayed on the system log.

Nnnn is the number of fullwords allowed in the trace table and can be a 1- to 4-digit number.

WRAP allows the trace table to wrap around when the limit is reached.

LOG writes the trace table to the log and clears the trace table when the limit is reached. TRACE must be specified before the first file is opened (readied). It may be re-specified on subsequent file allocation statements as long as all previously allocated files have been closed.

More information:

For more information on these parameters see Runtime Operations.

Example

The following example allocates two files and their file management tables. Both files use the same subschema.

ESVSALLO FILE(TESTFILE) FMT(TESTFMT) SSC(TESTSSC)
ESVSALLO DDNAME(TESTFIL2) FMT(TESTFMT2) MSG(CONS)

Support

TSO file allocation support consists of two modules: