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:
|
| Type | Selection | The type of the file descriptor. This value defines how the described file should be interpreted.
Permitted values:
The following values can only be used at run time if EDc, EDz or IDz is installed:
|
| 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
| 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
| 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 . |