Parâmetros de Identificação do Arquivo

NAME

Ao codificar um valor para o parâmetro NAME no nível do CLUSTER, este valor se aplica somente ao cluster. Se não for aplicado o parâmetro NAME ao nível do DATA ou INDEX, o VSAM criará um nome longo e encriptado. Sempre criar os nomes a nível de DATA e de INDEX pois os nomes criados pelo VSAM são muito difíceis de usar.

OWNER

Usado apenas para documentação e não afeta a execução do VSAM. Usar o userid (PW0001, etc).

CATALOG

O parâmetro CATALOG, quando utilizado é sempre o último a ser codificado no comando DEFINE CLUSTER. Se omitido, o MVS utiliza o qualificador de mais alto nível do parâmetro NAME. No exemplo, GR.PW0001.... o qualificador de mais alto nível é GR.

Parâmetros de Descrição de Características do Arquivo

TIPO DE ARQUIVO

Codificar INDEXED para crir um arquivo KSDS, NONINDEXED para criar um arquivo ESDS ou NUMBERED para criar um arquivo RRDS. Se omitido, o VSAM assume INDEXED como default.

RECORDSIZE

Especifica o tamanho dos registros lógicos do arquivo através de dois valores; tamanho médio e tamanho máximo. Independente de codificar ou não o mesmo valor para os dois sub-parâmetros, o registro poderá ter o tamanho máximo especificado no sub-parâmetro. Para arquivos do tipo RRDS, o tamanho médio e o máximo deverão ser iguais.

SPANNED

Se o arquivo deverá conter registros cujo tamanho é maior que o control interval, especificar SPANNED. Normalmente o tamanho utilizado para o control interval é de 4096 bytes. Utilize SPANNED apenas se os registros tiverem tamanho maior.

KEYS

Identifica a chave primária de um arquivo KSDS (indexado sequencial). Especificar o tamanho e o offset da chave. Por exemplo, para definir uma chave primária que ocupa do byte 13 ao byte 21, codificar KEYS(9 12). O offset sempre se inicia em 0 (zero). Assim o byte 13 é codificado como offset 12.

Parâmetros de Especificação de Alocação de Espaço

VOLUMES

Especifica o nome do disco onde o arquivo irá residir. Podem ser especificados mais de um volume de disco. A expressão vol-ser é a abreviação de "volume serial number".

UNIQUE/SUBALLOCATION

Especifica se o arquivo será criado em espaço pré estabelecido para uso do VSAM ou se será utilizado espaço não VSAM para a criação do arquivo. No MVS este parâmetro pode ser omitido pois o catalogo master irá alocar o arquivo automaticamente em espaços pré alocados para arquivos VSAM.

ALOCAÇÃO DE ESPAÇO

Especifica quanto espaço em disco deverá ser alocado para o arquivo. No exemplo CYLINDERS(50 5) serão alocados inicialmente 50 cilindros para o arquivo. Se o arquivo ocupar os 50 cilindros, serão alocadas extensões secundárias de 5 cilindros cada, à medida do crescimento do arquivo. O VSAM pode criar 122 extensões secundárias antes de ter que ser reorganizado. Para arquivos pequenos é recomendado utilizar RECORDS no nível do CLUSTER e o componente DATA.

Parâmetros de Otimização de Perfomance

IMBED

Utilizado em arquivos do tipo KSDS, especifica que os índices serão copiados do componente INDEX para o componente DATA. Como resultado, o VSAM pode acessar os indices do arquivo em um único movimento do mecanismo de acesso do disco, denominado seek. Adicionalmente, o VSAM duplica os indices tantas vezes quanto possível na trilha inicial do componente DATA. Isto reduz o chamado rotational delay, que é o tempo que o cabeçote de leitura demora para atingir um deterninado registro na trilha. Como o tempo de acesso é medido em milisegundos, qualquer redução é oportuna e recomenda-se utilizar este parâmetro até em arquivos KSDS de teste.

FREESPACE

Para uso em arquivos do tipo KSDS, especifica quanto de espaço livre deve ser reservado no arquivo, para futuras inserções de registros. O primeiro valor determina a porcentagem de espaço livre reservado dentro do control interval e o segundo especifica a porcentagem de control intervals dentro da control area que deverão ficar livres para uso futuro. No exemplo FREESPACE(20 10), o VSAM reserva 20% do espaço da control interval e 10% das control intervals da control area como espaço livre. Se este parâmetro não for especificado ainda poderão ser inseridos registros no arquivo mas ocorrerá o processo de split dos control intervals e control areas. No processo de split o VSAM cria automaticamente novas áreas para receber os novos registro o que degrada sobremaneira a performance e por isso o uso do parâmetro FREESPACE é fortemente recomendado.

CONTROLINTERVALSIZE (CISZ)

Especifica o tamanho do control interval. Caso não seja especificado, o VSAM assume um valor que ele considera ótimo e infelizmente este valor é muito ruim. Para a maioria dos arquivos, o tamanho de 4096 bytes é o ideal, e mesmo que não seja, este valor é melhor que o valor que o VSAM calculará.

Parâmetros de Compartilhamento e Modelagem

SHAREOPTIONS

Especifica que dois ou mais jobs utilizarão o arquivo simultâneamente. A opção 1 permite que um número ilimitado de jobs abra o arquivo exclusivamente em modo INPUT. A opção 2 permite que vários jobs abram o arquivo em modo INPUT e apenas um job abra o arquivo em modo OUTPUT. A opção 3 permite que vários jobs abram o arquivo em modo INPUT e OUTPUT. ATENÇÂO: na opção 3 o VSAM não assegura a integridade do arquivo! Esta opção é utilizada no ambiente CICS, que por sua vez assume a responsabilidade pela integridade do arquivo. Este parâmetro opera em conjunto com a declaração DISP do cartão DD do JCL e ambos devem estar sincronizados, isto é, se DISP=OLD o acesso ao arquivo será exclusivo independente do parâmetro SHAREOPTIONS declarar o contrário.

MODEL

Especifica que um arquivo VSAM já existente na instalação deverá servir como modelo para a criação deste arquivo. O VSAM utilizará os parâmetros do modelo na omissão destes no arquivo que está sendo criado e utilizará os parâmetros que forem declarados em vez dos parâmetros do modelo.