Skip to content
Thoroughbred Software InternationalThoroughbred Software InternationalThoroughbred DocumentationDocs

RETRY

FUNCTION

This string variable specifies the default action the CHANGE, DELETE, and READ commands will take if these commands encounter a busy record.

SYNTAX

RETRY = retry-code-string


      retry-code-string


         C Continues with the next command. This value is the same
            as specifying "N", but no END process is performed.
         I Ignores the error zero. Clear the data area and set the
            key area. Perform the processing procedure, then continue
            with the next command. This option is valid for the READ
            command and invalid for CHANGE and DELETE
            commands.
         N Treats a busy condition as an end of file condition.
            Performs END PROCESS, then continues with the next
            command.
         S Skips the busy record.
         Y Uses standard busy processing. This is the default.
retry-code-string
specifies the action to take if the command needs to be retried.

NOTES

  • Use the LET command to assign a value to the RETRY system variable.
  • The retry-code-string must be enclosed by double quotes.
  • Each CHANGE, DELETE, or READ command sets the value of this variable to “Y”. If the command encounters a busy record, and the RETRY IS retry-code-string clause was not specified, the BUSY PROCESS IS procedure is performed before the RETRY variable is evaluated. At this point, you can use the BUSY procedure to change the value of the RETRY variable.

EXAMPLES

   CHANGE MYFILE USING KEY RANGE ALL
         PROCESSING IS MY-PROCESS
         BUSY PROCESS IS MY-BUSY-PROCESS


MY-BUSY-PROCESS
* Record *1 is busy, skip (Y/N)
      INPUT MESSAGE "Y,99,,,," + CVT(KEY-NAME, 128)
            INTO RESPONSE USING "MYMSGS"
      IF RESPONSE = "N" THEN
         LET RETRY = "N"
      ELSE
         IF RESPONSE = "Y" THEN
            LET RETRY = "S"
         ENDIF
      ENDIF

The BUSY PROCESS is always performed before the RETRY variable is evaluated.

SEE ALSO

CHANGE, DELETE, LET, READ

From the Script-IV Language Reference, version 8.9.1. Open this page in the PDF