CA IDMS/DC Mapping Facility › Online Mapping Facility › File Field Edit Screen

File Field Edit Screen

The File Field Edit screen, shown below, enables you to associate a selected external record field with an internal record field and to specify special editing and error handling characteristics. The File Field Edit screen is displayed once for every external field selected for editing on the File Field Selection screen.

Note: An error message that you specify for a map field is written to the log file at runtime if the field is in error and the input record is being written to a suspense file.

               CA IDMS/DC FILE MAPPING REL nn.n          *** FILE FIELD EDIT ***


 MAP: JMAOUT       VER:    1                                               STEP

 EXTERNAL FIELD
   FIELD   : LAST-NAME                        OCCURS:
   OF REC  : JMAOUT                           VER:    1
   FILE-PIC: X(15)

 INTERNAL FIELD
   DFLD    : LAST-NAME                        OCCURS:
   OF REC  : JMAOUT                           VER:    1

 EDIT TABLE:           VER:       _  (LINK Y/N) _  (VALID Y/N/D-DICT)
 CODE TABLE:           VER:       _  (LINK Y/N) Y  (EDIT Y/N)

 FOR INPUT   Y  (DATA Y/N)
             <EDIT MODULE:           _  (WITH EDIT B/A/N)>

 FOR OUTPUT  Y  (DATA Y/N/E)
             <EDIT MODULE:           _  (WITH EDIT B/A/N)>
 N  (ERROR MSG T-TEXT/I-ID/N-NULL)   PREFIX:       ID:                    TEXT:

Batch Considerations

Specific fields on the screen are described below:

• EXTERNAL FIELD identifies the external record field being edited and specifies its external picture, as described below:
  • FIELD specifies the field name. This field is protected.
  • OCCURS specifies the occurrence of the field if the field is multiply-occurring. This field is protected. Levels of occurrences are separated by commas.
  • OF REC specifies the external record to which the field belongs. This field is protected.
  • VER specifies the version number of the external record. This field is protected.
  • FILE-PIC specifies the external picture of the file field. You can modify the picture for use by automatic editing. If the external field is to map to itself, you cannot specify a picture that changes the field's length.

    Note: For more information about specifying external pictures, see the CA IDMS Mapping Facility Guide.

• INTERNAL FIELD identifies the internal record field with which the external record field is to be associated, as described below:
  • DFLD specifies the name of an internal record field.

    Note: If no internal field is specified, the external field maps to itself, from the record buffer into variable storage, as described under "Input and Output Files and File Maps" in CA ADS Batch Concepts.

    Alternatively, you can enter $RESPONSE (or $R) to specify that the associated external field is a response field. Several external fields can be designated as response fields. In this case, the response field is composed of the concatenation of all the fields designated as response fields. The maximum length of a concatenated response field is 32 bytes. For more information about response fields, see "Batch Dialog Structure" in CA ADS Batch Concepts.

  • OCCURS specifies the occurrence of the field, if any. Up to three levels can be specified. Levels must be separated by commas.

    For a response field composed of the concatenation of several external fields, OCCURS is used to specify the sequence of the external field in the concatenation. By default, external fields are concatenated in the order in which they were associated with $RESPONSE.

  • OF REC specifies the record to which the external field belongs. OF REC is required only if DFLD is not unique among the fields in the records associated with the map.
  • VER specifies the version number of the record. This field is required only if more than one version of the internal record is associated with the map.