BUFND

Determines how many data buffers are allocated for this file. Specify a value from 3 to 9999.

Default Value: 5

BUFNI

Determines how many index buffers are allocated for this file. Specify a value from 3 to 9999.

Default Value: 5

ddname

Represents the DD name of the file you want CA‑L‑Serv to manage.

DISP

Determines whether the file server requires exclusive use of the file. Specify one of the following values:

SHR
Specify SHR to allow shared access to the file. The file may be allocated to other users, but VSAM sharing options apply. The SHROPTIONS must be set as follows or integrity exposures will exist: SHROPTION=(1,3) or SHROPTION(2,3).

OLD
Specify OLD to require exclusive use of the file. VSAM sharing options are ignored and treated as SHROPTION=(1,3).

Default Value: SHR

dsname

Represents the dsname of the file you want CA‑L‑Serv to manage. If you allocate the file through a DD statement in the CA-L‑Serv start‑up procedure, you can omit this parameter.

Note: With CA‑L‑Serv 3.5, the allocation of files using DD statements with a DISP of OLD to ensure that the CA‑L‑Serv region has exclusive control is no longer necessary. CA recommends that the DISP parm of the ADDFILE command be used instead.

GROUP

Associates the file with a file group. If the file group does not already exist, CA‑L‑Serv the file group under the group ID you provide. The group ID can be up to 8 characters long.

JCLMEMBER

Identifies the partitioned data set member that contains JCL for archiving file groups automatically. The name of the data set must be included in the concatenation the //JCLLIB DD statement in the CA-L‑Serv start‑up procedure. Specify JCLMEMBER only when you also specify the GROUP and OPTION(SUBMIT) parameters.

LOGID

Associates the file with a change log. Updates to the file are automatically recorded in this log.

OPTION

Sets processing options for a file. Specify one or more of the following values:

APPEND
For a file group, selects the last file that was written to and appends data to the end of the file. This parameter affects only initial file selection. Specify OPTION(APPEND) only when the GROUP parameter is also specified.

DEFER
Defers write operations for a record until another operation needs the VSAM buffer or until MAXDORM (a parameter on the OPTIONS command) seconds have elapsed. Use DEFER only with LSR buffer pools.

INPUT
Restricts access to input functions only. Update, insert, and erase functions are not allowed.

MINLEN
Pads the record being read with blanks until it is nn bytes long. Do not specify MINLEN unless directed to do so by the client documentation.

SUBMIT
For a file group, automatically archives a file when it becomes full. Use the JCLMEMBER parameter to indicate where the JCL is for this batch job.

TRIM
Trims trailing blanks from the data portion of variable‑length records.

DEFER, MINLEN, and TRIM have a critical impact on performance. For details, see the chapter "CA‑L‑Serv" in the Administration Guide.

PASSWORD

Identifies the 1‑ to 8‑character password that must be used to open the file.

POOL

Indicates the type of VSAM buffer pool CA‑L‑Serv should use for this file. Specify one of these values:

To use a private buffer pool, specify 0.

To use an LSR buffer pool, specify a value from 1 to 15.

When you use an LSR buffer pool, CA‑L‑Serv ignores the BUFND, BUFNI, and STRNO parameters.

Default Value: POOL(0)

STRNO

Determines how many VSAM placeholders are allocated for a file assigned to a private buffer pool. This parameter limits the number of current requests that clients can make for the file. Specify a value from 3 to 255.

Default Value: 16