JPH02194432A - Program maintenance data creation method - Google Patents

Abstract

(57) [Summary] This bulletin contains application data before electronic filing, so abstract data is not recorded.

Description

[Detailed Description of the Invention] (Summary) This invention relates to a method for creating program maintenance materials that automatically creates maintenance materials with explanations corresponding to each number that appears during execution of a program consisting of blocks to which reference numbers are assigned. The purpose of this is to provide a maintenance material creation method that allows the creation of reliable maintenance materials, and an information table in which a predetermined annotation part is extracted for each block of the source program and the relevant part is associated with each reference number. an information table creation unit that creates the table; an information table storage unit that stores the table; and an information table storage unit that stores the table; An information table search unit that searches and outputs information corresponding to a reference number from among the information, and when a reference number is specified and an instruction is given during the execution of the program,
This configuration includes a dynamic reference number generation section that generates a dynamic reference number indicating the order in which the reference numbers appear, and a display section that displays the dynamic reference number and the information in correspondence with the reference number.

[Industrial application field]

The present invention relates to a maintenance material creation method for creating maintenance materials for maintenance management of a program, and in particular, a program in which a predetermined explanation is associated with each number that appears during the execution of a program consisting of blocks to which reference numbers are assigned. This article relates to a program maintenance data creation method for creating maintenance data for maintenance management.

(Prior art) Conventionally, a created source program (original program;
When creating maintenance materials that explain the functions of the program by assigning a reference number to each functional block in the program (a program created in the source language) and creating maintenance materials that explain the functions of the program for each reference number, Only the reference numbers used were used and the explanations were made to correspond to the reference numbers, and the materials were prepared by the program creator and the like by looking at the program list.

(Problem to be Solved by the Invention) Conventionally, program maintenance materials are created manually by the program creator by looking at the source program list. When a program has complex operations (roofs, subroutines, etc.), it is easy to overlook reference numbers, and the reliability is not high enough.Also, it takes a lot of effort to update reference numbers and documents when modifying a program, which reduces work efficiency. It had the problem of poor performance.

SUMMARY OF THE INVENTION Therefore, the present invention has been made to automate the creation of maintenance materials to save time and effort, and to provide a reliable method for creating maintenance materials.

(Means for Solving the Problems) In order to solve the above technical problems, the present invention, as shown in FIG. In a program maintenance material creation method that creates maintenance materials for program maintenance management that correspond to predetermined explanations, a predetermined annotation part is extracted for each block of the source program for which maintenance materials are to be created, and An information table creation unit 1 that creates an information table in which the annotation portion corresponds to the annotation part.
and an information table storage unit 2 that stores the information table.
If a reference number is specified during execution of an executable program and instructions are given to create maintenance materials, the display information corresponding to the reference number is searched from the stored information table and output. and an information table search unit 3 that generates a dynamic reference number indicating the order in which the reference number appears during execution when a reference number is specified during execution of an executable program and there is an instruction to create maintenance materials. It has a dynamic reference number generation section 4 and a display section 5 that displays the dynamic reference number and the display information in correspondence with the reference number.

(Operation) In order to create a maintenance sample using the maintenance sample creation method according to the present invention, a predetermined annotation part is extracted for each block of the source program for which a maintenance sample is to be created, and the part is determined for the block. Create an information table that corresponds to the reference numbers listed.

Here, the "annotation part" refers to an explanation of the function of the block, symbols and text for identification, and refers to the "predetermined"
The annotation part refers to a part of the annotation part that is necessary for maintenance and management of the program, and is designated by a code such as a specific character predetermined by the program creator.

The created information table is stored in the information table storage section 2.

Here, a "program block" refers to a sequence of records that is created so that it can be treated as having one unified function, for example, for technical or logical reasons.

Furthermore, a "source program" refers to a computer program created in a source language.

A "source language" is a language for automatic programming,
By translating something written in the source language using a compiler, it becomes machine-readable. The source language for compilation is a compiler language such as FORTRAN or C0BOL.

Next, the part of the source program excluding the annotation part is translated into an executable program by a compiler, the program written in the source language is written in machine language, and actual processing is performed according to the program. It turns out.

The reference number is specified during the execution of the program;
And when there is an instruction to create maintenance materials, the information table search unit 3 retrieves display information including the annotation portion corresponding to the reference number from among the information tables stored in the information table storage unit 2. It will be searched and output.

This is because the annotation part of the source program is not translated because it is unnecessary in the executable program, and the annotation part cannot be directly obtained from the executable program. This is because it is necessary to read out and output the annotation portion corresponding to the reference number stored in .

Further, when the reference number is specified by the executable program, the dynamic reference number generation unit 4 generates a dynamic reference number indicating the order in which the reference number appears during execution. .

The generated dynamic reference number is sent to the display unit 5 together with information including the reference number and the annotation part, and is displayed as maintenance material.

The reason why a dynamic reference number is generated and displayed together with the reference number is that if there is a loop process or subroutine process that repeats the same procedure in the program, it is not possible to use the reference number alone to display multiple This is because it is not possible to distinguish between the same blocks that appear multiple times, making it impossible to maintain and manage programs adequately.

(Example) Next, examples of the present invention will be described.

As shown in FIGS. 2 and 3, this embodiment includes a source program file 18 that stores a source program (original program) and an executable program obtained by translating the source program. an executable program file 19 that extracts a predetermined annotation part from the source program and creates an information table that corresponds to the reference number; and an information table that stores the information table. a file 12; an information table search unit 13 that searches and outputs an annotation portion corresponding to a corresponding reference number from the information table file 12 when a reference number is specified by the executable program; When a reference number is specified by the operation section 16a such as a keyboard and the flag holding section 16b, which instructs the dynamic reference number generation section 13 and the dynamic reference number generation section 14, which will be described later, to create maintenance materials, a dynamic reference number generation unit 14 that generates a dynamic reference number representing the number of times the reference number appears during execution of the program; an execution processing unit 20 that performs processing according to the executable program; and the information table search unit 13. a display control unit 15a that performs various controls such as associating the annotation portion searched and outputted with the reference number and the dynamic reference number generated by the dynamic reference number generation unit 14, and editing for display; and the display control section 1
5a, a CRT 15c displays the data on the screen in the manner stored in the display memory 15b, and prints in the manner stored in the display memory 15b. It has a printer device 15d for outputting.

Here, the information table creation section 11, information table search section 13, dynamic reference number generation section 14, display control section 15a
The execution processing section 20 is composed of the CPU 10 and its programs.

Further, the display control section 15a, display memory 15b, CR
T15e and printer device 15d constitute display section 15.

When creating maintenance materials using this method, the information table creation section 11 first reads the source program created in the original M-Wb for which maintenance materials are to be created from the source program file 18, A predetermined annotation portion corresponding to each reference number is extracted.

FIG. 4 shows an example of a source program predicted by the C word J.

In the program shown in this example, the "predetermined annotation part" is the format 11//*l" indicating the annotation part shown in the same figure.
and ``*/'' are the parts necessary for maintenance management, such as bi and 11].
It is specified by the part between ##.

Also, 'R' is used as a code to indicate the reference number of each functional block.
EF” is used.

Thus, from the source program /*'” and 11
* Of the part sandwiched by / I) ′ [″ and °°]
``'' is extracted and stored as display information in the information table file in correspondence with the information number that is the reference number.

FIG. 5 shows an example of the information table. As shown in the figure, the information table stores a predetermined annotation portion corresponding to each information number (reference number). In addition, in the figure ゛＼
n" indicates a new line.

On the other hand, the source program is translated into an executable program by a compiler, and the executable program is translated into an executable program by a compiler.
The program is stored in the file 19, and the execution processing section 20 executes the execution process according to the program.

At that time, the operator must
The flag holding section 16b provided in the memory in the CPU 10 is caused to hold a flag 1'°, which is information indicating an instruction to create maintenance materials, from the Gibaut 6a.

When the executable program is executed and the reference number is specified, the information table search unit 13 searches the information table storage unit 12 in which the information table is stored.
The information number corresponding to the reference number is retrieved from , the predetermined annotation portion corresponding to the display information created by the information table creation unit 11 stored corresponding to the information number is read out, and the display information is read out. It is sent to the control unit 15a.

Reference number 17 is displayed when the execution of the executable program starts.
When 011 is specified, the information table search section 13 reads out the display information of the corresponding information number "0" from the information table storage section 13 and sends it to the display control section 15.
It will be sent to a.

Here, summary information indicating the summary of the program is stored in advance in the portion corresponding to the information number "0"'.

On the other hand, when the flag holding section 16b holds a flag to the effect that maintenance materials should be created, the dynamic reference number generating section 14 initializes the dynamic reference number to 0, and also generates an executable program. Each time a reference number is specified during execution, the dynamic reference number is incremented by j+ITI and sent to the display control unit 15a.

Dynamic reference numbers are generated and added to each reference number in this way, for example, when there is a loop process or subroutine process that repeats the same procedure as shown in the program shown in Figure 4, only the same reference number can be added. This is because it is not possible to distinguish in which process the error occurred.

At step 1, when the program is executed to the end,
The predetermined annotation portion and dynamic reference number corresponding to each obtained reference number are collected as a maintenance fee in the display control unit 15a so that the operator can easily see them, and are stored in the display memory 15b as a displayed image. held and said CRT15
e, or recorded and outputted by the printer device 15d.

An example of such maintenance materials is shown in FIG.

In FIG. 5, "REFERENCE" corresponds to the dynamic reference number, and "MESSAGE NO." corresponds to the reference number.

In this way, it is possible to easily create maintenance materials when creating a program or update maintenance materials when modifying a program without overlooking reference numbers. [Effects of the Invention] As explained above, the present invention enables Extracting a predetermined annotation portion, creating and retaining an information table, and extracting the corresponding predetermined annotation portion from the information table corresponding to each reference number specified during execution of the executable program; , dynamic reference numbers are added to automatically create maintenance documents.

Therefore, you can work efficiently without the hassle of manpower.
In addition, reliable maintenance materials can be created without overlooking reference numbers.

[Brief explanation of the drawing]

FIG. 1 is a block diagram of the principle of the present invention, FIG. 2 is a block diagram of an embodiment, FIG. 3 is a block diagram of the equipment configuration of the embodiment, and FIG. 4 is an example of a source program of the embodiment. 5 is a diagram showing an example of an information table according to the embodiment, and FIG. 6 is a diagram showing an example of maintenance materials according to the embodiment. 1.11...Information table creation unit (CPUIO)2.
12... Information table storage unit (cptrio) 3.1
3... Information table search unit (CPUIO) 4.14.
・・Dynamic reference number generation part 5.15...Display part malr+f) /* [+FLAG-0"]Ning/for fimo+ I<3: l+1/Umbrella OOP 3TiMIi+S City/Including V example 1 tl -su, 9107'sum 0-prefecture 4i ω
Figure 3: READ \n゛WORK AREA FLAG-0\n+ INITrALIZE'xn 2゜”SET EVICE DATA'X,,n- 3゜EXEC CONTROL COMMAND\n- 7゜”TERMINA TE\n0 TM I9/11; A book length f1 nit 1-)'r しの-
Ida I Lo De T Record No.

Claims (1)

[Claims] In a program maintenance material creation method for creating maintenance materials for program maintenance management in which a predetermined explanation is associated with each number that appears during execution of a program consisting of blocks to which reference numbers are assigned, an information table creation unit (1) that extracts a predetermined annotation part for each block of the source program for which maintenance data is to be created, and creates an information table in which the annotation part is associated with each reference number; An information table storage unit (2) that stores tables, and when a reference number is specified during execution of an executable program and instructions are given to create maintenance materials, the reference number is stored from among the stored information tables. An information table search unit (3) that searches and outputs display information corresponding to a number; and an information table search unit (3) that searches and outputs display information corresponding to a number; a dynamic reference number generation unit (4) that generates a dynamic reference number indicating the order of appearance in the content, and a display unit (5) that displays the reference number in association with the dynamic reference number and the display information. A program maintenance document creation method characterized by: