Previous Topic Next topic Print topic


File Descriptor

A file descriptor describes a file and, optionally, the structure of the file. The file can be located both in the Eclipse workspace or in the system to be attached.

The physical name (attribute Name_Physical) of the file does not have to be given in order to describe a file. This can be set by a tool output parameter at run time. If the physical name of the file already exists, a static value can be entered under this attribute. If only the structure of the file path has been defined, a dynamic path can be entered using dynamic references, see Variable References for more information.

A further feature of a file descriptor is the type. The “Workspace_File” type indicates files that should be saved in the workspace or that are to be read from the workspace.

Attribute Type Description
ID * ID * The ID of the file descriptor.
Name_Physical [O] String The physical name of the file under which the target system can find the file (file path + file name).

Dynamic references are allowed.

PropDelimiter String The delimiter to be used for the interpretation of structured file content.

Standard value: " " (Blank)

Structure Selection Describes the structure of the file.  

Permitted values:

  • Unstructured (standard value)
  • Table
Type Selection The type of the file descriptor. This value defines how the described file should be interpreted.  

Permitted values:

  • InputStream
  • Local file
  • Workspace_File (standard value)

The following values can only be used at run time if EDc, EDz or IDz is installed:

  • MVS_PO
  • MVS_PO_Member
  • MVS_SEQ
  • USS_File
Relationship Cardinality Description
Has_Property 0..* Relationship to a Property. Property Values can be assigned to a file content, which enables the further editing of the content.

This relationship can only be used for the description of structured files (table structure).

Has_Action 0..* Relationship to an action descriptor. Used only if the file descriptor is of structure table and the table is part of a modeled dialog or an ISPF dialog. In this case the actions appear in the context menu of the table items.

Examples

File Descriptor SCLM_FILE_ElelistMember


File Descriptor SCLM_File_ElelistMember

File Descriptor SCLM_FILE_ElelistMember Properties
Attribute Value Description
Essential:
ID SCLM_FILE_ElelistMember Unique identifier of the file descriptor in this model.
Prop Delimiter "," Comma is used as delimiter in the returned file to separate the values for the properties.
Structure Table A table structured file descriptor consists of a sequence of properties. The file has to provide in each line the values for every property defined as a File Descriptor_Has_Property relationship.
Type MVS_SEQ The format of the file is a MVS sequential file.
Optional:
Name Physical --- The physical name is not needed as the file descriptor is modelled as file output parameter of an ISPF command tool. The REXX procedure associated with the ISPF command tool returns the file name.

Example content of a SCLM_FILE_ElelistMember file descriptor:

MFI01V,MFIJKH,SCLMTEST,SOURCE,BBANKJKP,MFIJKH,2016/02/05 11:01:22,0,,EDITABLE

MFI01V,MFIJKH,SCLMDEV,SOURCE,BBANKJKP,MFIJKH,2016/03/11 03:57:01,0,,EDITABLE

MFI01V,MFIJKH,SCLMPROD,SOURCE,BBANKZZP,MFIJSS,2014/10/13 12:17:06,0,,EDITABLE

File Descriptor SCLM_FILE_SclmMember


File Descriptor SCLM_FILE_SclmMember
Attribute Value Description
Essential:
ID SCLM_FILE_SclmMember Unique identifier of the file descriptor in this model.
Prop Delimiter " " Not applicable as it is an unstructured file descriptor.
Structure unstructured The file has no internal structure.
Type MVS_PO_Member The format of the file is a member of a MVS PO (Partitioned Organised) data set.
Optional:

Name Physical

&SCLM_PROP_ELE_MemberDatasetName.(&SCLM_PROP_ELE_MemName.) The physical name of the PO member is defined by the current values of the two properties SCLM_PROP_ELE_MemberDatasetName and SCLM_PROP_ELE_MemName .
Previous Topic Next topic Print topic