En esta sección: |
Puede añadir el atributo DATASET al archivo máster para especificar la ubicación física del origen de datos que se va a asignar. Además, DATASET permite evitar el uso del mecanismo de búsqueda de la ubicación por defecto del origen de datos. DATASET elimina la necesidad de asignar orígenes de datos utilizando los comandos JCL, FILEDEF, DYNAM, y USE.
Para UNIX, Windows y OpenVMS, el comando de asignación de usuarios es FILEDEF.
Para z/OS, el comando de asignación de usuarios es DYNAM ALLOC o TSO ALLOC.
Nota: No se pueden usar los atributos ACCESSFILE y DATASET en el mismo archivo máster. Para más información sobre el atributo ACCESSFILE, consulte Cómo describir un origen de datos de FOCUS.
Cómo: |
Puede usar el atributo DATASET en el nivel de archivos, de un archivo máster de FOCUS (incluido XFOCUS), secuencial de formato fijo o VSAM. Puede usar el atributo DATASET en el nivel de segmentos de un archivo máster de FOCUS Para obtener información sobre cómo especificar el atributo DATASET, en el nivel de segmentos de un archivo máster de FOCUS, consulte Cómo describir un origen de datos de FOCUS.
Si el nombre del archivo máster está presente en la lista USE, o el usuario se encuentra asignado explícitamente al archivo de datos, se ignora el atributo DATASET.
Si utiliza DATASET en un archivo máster cuyo origen de datos está administrado por el Servidor de bases de datos de FOCUS, se ignora el atributo DATASET del lado del servidor, ya que éste no puede leer los archivos máster de servicio de solicitudes de tablas.
El atributo DATASET del archivo máster tiene la prioridad más baja:
Una alternativa al uso del atributo DATASET para asignar los orígenes de datos de FOCUS, es el archivo de acceso. Para más detalles, consulte Cómo describir un origen de datos de FOCUS.
Nota: Si hay una asignación DATASET en vigor, debe emitirse un comando CHECK FILE para sobrescribirla con un comando explícito de asignación. El comando CHECK FILE anula la asignación creada por DATASET.
{DATASET|DATA}='filename [ON sinkname]'
En z/OS, la sintaxis es:
{DATASET|DATA}='qualifier.qualifier ...'o
{DATASET|DATA}='ddname ON sinkname'
En UNIX, la sintaxis es:
{DATASET|DATA}='/filesystem/filename.foc [ON sinkname]'
En Windows, la sintaxis es:
{DATASET|DATA}='drive:\directory\filename.foc [ON sinkname]'
En OpenVMS, la sintaxis es:
{DATASET|DATA}='[device:[directory]]filename[.foc] [ON sinkname]'donde:
Es el nombre físico dependiente de la plataforma del origen de datos.
Indica que el origen de datos está situado en el Servidor de bases de datos de FOCUS. Este atributo sólo es válido para los orígenes de datos de FOCUS o XFOCUS.
El siguiente ejemplo explica cómo asignar un origen de datos de FOCUS, mediante el atributo DATASET.
Para z/OS,
FILENAME=CAR,SUFFIX=FOC,
DATASET='USER1.CAR.FOCUS'
SEGNAME=ORIGIN,SEGTYPE=S1
FIELDNAME=COUNTRY,COUNTRY,A10,FIELDTYPE=I,$
SEGNAME=COMP,SEGTYPE=S1,PARENT=ORIGIN
FIELDNAME=CAR,CARS,A16,$
SEGNAME=CARREC,SEGTYPE=S1,PARENT=COMP
.
.
.Para UNIX,
FILENAME=CAR,SUFFIX=FOC,
DATASET='/filesystem/filename.foc'
SEGNAME=ORIGIN,SEGTYPE=S1
FIELDNAME=COUNTRY,COUNTRY,A10,FIELDTYPE=I,$
SEGNAME=COMP,SEGTYPE=S1,PARENT=ORIGIN
FIELDNAME=CAR,CARS,A16,$
SEGNAME=CARREC,SEGTYPE=S1,PARENT=COMP
.
.
.Para Windows,
FILENAME=CAR,SUFFIX=FOC,
DATASET='drive:\directory\filename.foc'
SEGNAME=ORIGIN,SEGTYPE=S1
FIELDNAME=COUNTRY,COUNTRY,A10,FIELDTYPE=I,$
SEGNAME=COMP,SEGTYPE=S1,PARENT=ORIGIN
FIELDNAME=CAR,CARS,A16,$
SEGNAME=CARREC,SEGTYPE=S1,PARENT=COMP
.
.
.Para OpenVMS,
FILENAME=CAR,SUFFIX=FOC,
DATASET='device:[directory]filename.foc' SEGNAME=ORIGIN,SEGTYPE=S1
FIELDNAME=COUNTRY,COUNTRY,A10,FIELDTYPE=I,$
SEGNAME=COMP,SEGTYPE=S1,PARENT=ORIGIN
FIELDNAME=CAR,CARS,A16,$
SEGNAME=CARREC,SEGTYPE=S1,PARENT=COMP
.
.
.
El siguiente ejemplo explica cómo asignar un origen de datos de FOCUS con el atributo DATASET, utilizando ON sink.
Para z/OS,
FILENAME=CAR,SUFFIX=FOC,
DATASET='CAR ON SINK1'
SEGNAME=ORIGIN,SEGTYPE=S1
FIELDNAME=COUNTRY,COUNTRY,A10,FIELDTYPE=I,$
SEGNAME=COMP,SEGTYPE=S1,PARENT=ORIGIN
FIELDNAME=CAR,CARS,A16,$
SEGNAME=CARREC,SEGTYPE=S1,PARENT=COMP
.
.
.Nota: El ddname CAR queda asignado por el JCL del Servidor de bases de datos de FOCUS.
Para UNIX,
FILENAME=CAR,SUFFIX=FOC, DATASET='filename ON sink'
SEGNAME=ORIGIN,SEGTYPE=S1
FIELDNAME=COUNTRY,COUNTRY,A10,FIELDTYPE=I,$
SEGNAME=COMP,SEGTYPE=S1,PARENT=ORIGIN
FIELDNAME=CAR,CARS,A16,$
SEGNAME=CARREC,SEGTYPE=S1,PARENT=COMP
.
.
.Para Windows,
FILENAME=CAR,SUFFIX=FOC,
DATASET='filename ON sink'
SEGNAME=ORIGIN,SEGTYPE=S1
FIELDNAME=COUNTRY,COUNTRY,A10,FIELDTYPE=I,$
SEGNAME=COMP,SEGTYPE=S1,PARENT=ORIGIN
FIELDNAME=CAR,CARS,A16,$
SEGNAME=CARREC,SEGTYPE=S1,PARENT=COMP
.
.
.Para OpenVMS,
FILENAME=CAR,SUFFIX=FOC,
DATASET='filename ON sink' SEGNAME=ORIGIN,SEGTYPE=S1
FIELDNAME=COUNTRY,COUNTRY,A10,FIELDTYPE=I,$
SEGNAME=COMP,SEGTYPE=S1,PARENT=ORIGIN
FIELDNAME=CAR,CARS,A16,$
SEGNAME=CARREC,SEGTYPE=S1,PARENT=COMP
.
.
.
Cómo: |
El atributo DATASET para un archivo secuencial, de formato fijo, sólo puede usarse en el nivel de declaración de archivos, del archivo máster, y no puede contener ON sink. Si el atributo DATASET contiene ON sink, se emite un mensaje y la operación termina.
Al detectarse el atributo DATASET, se comprueba la presencia de una asignación de datos explícita para este archivo máster. Si existe dicha asignación, se ignora el atributo DATASET. Si no se ha asignado este archivo máster, se emite un comando interno que lleve a cabo la asignación. La asignación queda almacenada temporalmente, y se libera cuando se emplee un archivo máster nuevo o termine la sesión.
Existe un segundo parámetro para DATASET, obligatorio en las plataformas UNIX, Windows y OpenVMS, que al utilizarse con orígenes de datos SUFFIX = FIX, indica si contiene datos binarios o de texto. Este parámetro ofrece información sobre la presencia de caracteres de salto de línea, en el origen de datos. Esto diferencia los orígenes de datos de texto de los binarios. El origen de datos por defecto es el binario.
{DATASET|DATA}='filename {BINARY|TEXT}'donde:
Es el nombre físico dependiente de la plataforma del origen de datos.
Indica que es un origen de datos binario. BINARY es el valor predeterminado.
Indica que es un origen de datos de texto.
El atributo DATASET del archivo máster tiene la prioridad más baja. La asignación explícita de un usuario anula los atributos DATASET.
Nota: Si hay una asignación de DATASET en vigor, debe emitirse un comando CHECK FILE para anularla con un comando de asignación, explícito. El comando CHECK FILE retira la asignación creada por DATASET.
El siguiente ejemplo explica cómo asignar un origen de datos de formato fijo, mediante el atributo DATASET.
Para z/OS:
FILE=XX, SUFFIX=FIX, DATASET='USER1.SEQFILE1' . . .
Para Windows:
FILE=XX, SUFFIX=FIX, DATASET='C:\DATA\FILENAME.FTM TEXT'
.
.
.Para UNIX:
FILE=XX, SUFFIX=FIX, DATASET='/u22/class/data/filename.ftm'
.
.
.Para un origen de datos binario:
FILE=XX, SUFFIX=FIX, DATASET='/u22/class/data/filename.ftm BINARY'
.
.
.
Cómo: |
El atributo DATASET de un origen de datos VSAM puede usarse en el nivel de declaración de archivos, del archivo máster, y no puede contener ON sink. Si el atributo DATASET contiene ON sink, se emite un mensaje y la operación termina.
Al detectarse el atributo DATASET, se comprueba la presencia de una asignación de datos explícita para este archivo máster. Si existe dicha asignación, se ignora el atributo DATASET. Si no se ha asignado este archivo máster, se emite un comando interno que lleve a cabo la asignación. La asignación queda almacenada temporalmente, y se libera cuando se emplee un archivo máster nuevo o termine la sesión.
El atributo DATASET también puede aparecer en el nivel de declaración de campos, del archivo máster, para especificar donde localizar un índice alternativo. Debido a las convenciones de nomenclatura (nombres limitados a 8 caracteres), se usa el nombre de alias del campo como ddname. Si se encuentra una asignación de usuario en el archivo máster o en el ddname de índice alternativo, se ignora el atributo DATASET.
Nota: Puede usar un número de índices ilimitado. Además, se permite que algunos de los índices alternativos tengan un atributo DATASET y otros no. Sin embargo, si falta un atributo DATASET en el nivel de archivos, se ignora el DATASET del nivel de campos.
{DATASET|DATA}='filename'donde:
Es el nombre físico, dependiente de la plataforma, del origen de datos o del índice alternativo.
El atributo DATASET del archivo máster tiene la prioridad más baja. La asignación explícita de un usuario anula los atributos DATASET.
Nota: Si hay una asignación DATASET en vigor, debe emitirse un comando CHECK FILE para sobrescribirla con un comando explícito de asignación. El comando CHECK FILE retira la asignación creada por DATASET.
El siguiente ejemplo explica cómo asignar un origen de datos VSAM, en el nivel de declaración de archivos y para un índice alternativo:
FILE=EXERVSM1, SUFFIX=VSAM, DATASET='VSAM1.CLUSTER1',$
SEGNAME=ROOT , SEGTYPE=S0,$
GROUP=KEY1 , ALIAS=KEY , FORMAT=A4, ACTUAL=A4 ,$
FIELD=FLD1 , ALIAS=F1 , FORMAT=A4, ACTUAL=A4 ,$
FIELD=FLD2 , ALIAS=F2 , FORMAT=A4, ACTUAL=A4 ,$
FIELD=FLD3 , ALIAS=DD1 , FORMAT=A4, ACTUAL=A4 , FIELDTYPE = I ,
DATASET='VSAM1.INDEX1' ,$
FIELD=FLD4 , ALIAS=F4 , FORMAT=A4, ACTUAL=A4 ,$
FIELD=FLD5 , ALIAS=F5 , FORMAT=A4, ACTUAL=A4 ,$
FIELD=FLD6 , ALIAS=F6 , FORMAT=A4, ACTUAL=A4 ,$
FIELD=FLD7 , ALIAS=F7 , FORMAT=A4, ACTUAL=A4 ,$
| WebFOCUS |