Refreshing the contents of a record

In a highly active environment, records may be updated frequently. On occasions, you may need to reread the contents of a record from the file that you are working on. For example, you may have encountered an integrity check (as previously described), or be waiting for a particular change to occur to a record before continuing on with some other action. In such situations, you can refresh specific records by using either the RF line command or the RF primary command.

For example, assume you are editing a file in SNGL display format as shown in Figure 1.
Figure 1.  
  Process   Options   Help
────────────────────────────────────────────────────────────────────────────────
 Edit             FI:HFMKSB1 DS:HFM.RFM0201.KSDS    Rec 1
 Command ===>                                                       Scroll CSR 
                                                      Type KSDS     Format SNGL
                                                      Top Line is 1    of 5
 Current 01: REC-TYPE1
 Field           Data
 FIRSTPART             0
 LASTTWO           1
 TEXTFIELDMAIN   AAAAAAxxzzzzzzzzzzzzxxxxxxxxxxxxxxxxxAAAAA
 TEXTMINOR1      AAAAAAAAAAAAAAA
 TEXTMINOR2      AAAAAAAAAAAAAAA
 ***  End of record  ***








 F1=Help     F2=Zoom     F3=Exit     F4=CRetriev F5=RFind    F6=RChange
 F7=Up       F8=Down     F10=Previous F11=Next     F12=Cancel
When you enter the RF line command or the RF primary command and press Enter, Z Data Tools displays the refreshed record (assuming, for this example, that another user has updated the record) as shown in Figure 2.
Figure 2.  
  Process   Options   Help
────────────────────────────────────────────────────────────────────────────────
 Edit             FI:HFMKSB1 DS:HFM.RFM0201.KSDS    Re                  RF done
 Command ===>                                                       Scroll CSR 
                                                      Type KSDS     Format SNGL
                                                      Top Line is 1    of 5
 Current 01: REC-TYPE1
 Field           Data
 FIRSTPART             0
 LASTTWO           1
 TEXTFIELDMAIN   A   updated record
 TEXTMINOR1      AAAAAAAAAAAAAAA
 TEXTMINOR2      AAAAAAAAAAAAAAA
 ***  End of record  ***






 F1=Help     F2=Zoom     F3=Exit     F4=CRetriev F5=RFind    F6=RChange
 F7=Up       F8=Down     F10=Previous F11=Next     F12=Cancel
When you are using multi-line display formats (CHAR, HEX, LHEX, TABL), you can refresh the contents of a record with either the RF or RFF primary command, or the RF prefix command.
Note: If you do have any pending changes for a record, when you refresh the record those changes are discarded without further warning. This can be useful however if, for example, you want to undo your changes to a specific record, or refresh its contents when an integrity check has occurred when attempting to save your change.

Related topics