Help

TIRFHOUR

TIRFHOUR is a called module supplied with CA Gen. TIRFHOUR is called every time an CA Gen action diagram uses the HOUR function.

HOUR extracts the hour part of a valid time. The numeric value returned will be a number between 0 and 24 inclusive.

HOUR generates the following COBOL statements:

Statement

Quantity

Call

1

Compute

2

Move

2

Initialize

1

IF

1

Heavy use of HOUR can drastically increase CPU costs.

Hints

If an action diagram uses HOUR more than once for the same time:

  • use HOUR once for the desired time

  • save the hour returned in a local view

  • use the local view instead of HOUR for the remaining instances

  • pass the local view to the import view of any called action diagrams that need it.

If HOUR is used in an action diagram that uses several CA Gen functions, or the action diagram has high CPU usage due to HOUR, consider converting the action diagram to an external action block.

Example (COBOL External Action Block)

In this example, only two COBOL statements are needed to extract the hour part of a time into a numeric value.

WORKING-STORAGE SECTION.

01 WS-FIELDS.

03 WS-TIME PIC 9(06).

03 WS-TIME-X REDEFINES WS-TIME.

05 WS-TIME-HOUR PIC 9(02).

05 WS-TIME-MINUTE PIC 9(02).

05 WS-TIME-SECOND PIC 9(02).

LINKAGE SECTION.

01 IMPORT-0001EV.

03 WORK-VIEW-0001ET.

05 TIME-FLD1-0001AS PIC X(0001).

05 TIME-FLD1-0001 PIC S9(0006).

05 TIME-FLD1-0001XX REDEFINES TIME-FLD1-0001

PIC X(0006).

01 EXPORT-0002EV.

03 WORK-VIEW-0002ET.

05 INTEGER-FLD1-0002AS PIC X(0001).

05 INTEGER-FLD1-0002 PIC S9(0002).

05 INTEGER-FLD1-0002XX REDEFINES INTEGER-FLD1-0002

PIC X(0002).

PROCEDURE DIVISION.

MOVE TIME-FLD1-0001 TO WS-TIME.

MOVE WS-TIME-HOUR TO INTEGER-FLD1-0002.