INSTALLING A TASK SEGMENT - 3 Program File Management

3 Program File Management

3.2 INSTALLING A TASK SEGMENT

A task may install a task segment in a program file by executing an Install Task Segment SVC (op-code >25). The SVC processor writes the module to the program file and writes the appropriate entry in the program file directory. The following options are available:

•

3-2

The task segment may be installed in the system program file.

The task segment 10 (installed 10) may be automatically assigned.

The task segment may be installed as a hardware privileged task.

The task segment may be installed as a software privileged task.

The task segment may be installed as a system task.

The task segment may be installed as memory resident. (The task does not actually become memory resident until the next IPL. It may be executed from the disk until the next IPL.)

The task segment may be installed as delete protected.

The task segment may be installed as replicatable.

2270507-9701

Program File Management 3.2

• The task segment may be installed as execute protected in the Model 990/12 Computer.

• The task segment may be installed as one that takes end action on an arithmetic overflow in the Model 990/12 Computer.

• The task segment may be installed as one that uses the writable control store in the Model 990/12 Computer.

The supervisor call block for the Install Task Segment SVC is as follows:

SVC > 25 -- INSTALL TASK SEGMENT ALIGN ON WORD BOUNDARY

PRIVILEGED TASKS ONLY DEC HEX

0 0 >25 <RETURN CODE>

2 2 PROGRAM FILE LUNO INSTALLED 10

4 4

"'!J ^,..~

r!J T ASK SEGMENT NAME _rrJ

10 A

12 C FLAGS PRIORITY

14 E PROCEDURE 1 10 PROCEDURE 2 10

16 10 OBJECT FILE LUNO FLAGS

1 8 12 RESERVED OR LOAD ADDRESS

20 14 RESERVED OR TOTAL LENGTH

22 16 RESERVED OR TASK LENGTH

2279444

The call block contains the following:

Byte

o

2270507·9701

Contents Opcode, >25.

Return code. ONOS returns zero when the operation completes satisfac-torily. When the operation completes in error, ONOS returns an error code.

Program file LUNO, or zero. The LUNO assigned to the program file.

When this field contains zero, ONOS installs the task segment on .S$SHAREO. When this field contains >FF, the system installs the task on the program file on which the calling task resides. If the special install flag is set to one, the LUNO must be open for exclusive write. Otherwise, the LUNO must be closed.

3-3

3.2 Program File Management

3-4

Byte Contents

3 Installed task segment 10, or zero. When this field contains zero, ONOS assigns an available 10 and returns the 10 in this field. The user may specify the installed ID in this byte. Do not assign a reserved system task 10 to a task installed on the system program file.

4-11 Name of task segment, or zero. When this field contains zero, ONOS uses the IDT in the object module as the task segment name. The task segment name consists of not more than eight alphanumeric characters, the first of which must be alphabetic. The name is left justified in the

1 - Task may execute privileged assembly language instructions.

0 - Task may not execute privileged assembly language instructions.

Bit 1 - System task flag. Set as follows: program file. Installation consists only of writing the file directory entry; the task segment is not replaced.

Priority. The installed priority of the task, 0 through 4, or real-time pri-ority, 0 through 127. Bit 0 of the field is set to one for a real-time priority.

Procedure segment 1 10. The 10 of the procedure segment or program segment to be attached as procedure segment 1, or zero when there is no attached procedure segment.

2270507·9701

Program File Management 3.2

Byte Contents

15 Procedure segment 2 ID. The ID of the procedure segment or program segment to be attached as procedure segment 2, or zero when no pro-cedure is to be attached as propro-cedure segment 2. A propro-cedure segment 2 is valid only if procedure segment 1 is specified.

16 Object file LUNa. The LUNa assigned to the object file. This LUNa must not be open.

17 Flags. (Byte 12 also contains flags.) Bit 0 - Overflow flag. Set as follows:

1 - Task transfers control to end action routine when an arithmetic overflow occurs (Model 990/12 Computer only).

o -

Task does not transfer control to end action when an arith-metic overflow occurs.

Bit 1 - Writable control store flag. Set as follows:

1 - Task uses writable control store (Model 990112 Computer only).

o -

Task does not use writable control store.

Bit 2 - Execute protect flag. Set as follows:

1 - Set hardware execute protection (Model 990/12 Computer only). Execute protection prohibits instruction accesses to the memory in which the task segment is loaded.

o -

Do not set hardware execute protection.

Bit 3 - Software privileged.

1 - Task will be allowed to issue privileged SVCs.

o -

Task will not be allowed to issue privileged SVCs.

Bit 4 - Updateable.

1 - Task segment will be rewritten to the program file by the seg-ment manager if modified.

o -

Task segment will not be rewritten to the program file by the segment manager.

Bit 5 - Reusable.

1 - Task segment may be reused consecutively without reloading.

o -

Task segment must be reloaded for each use.

Bit 6 - Copyable.

1 - Task segment may be replicated by copying an in-memory copy.

o -

Task segment may be replicated only by copying the disk-resident copy.

Bit 7 - Reserved.

18-19 Reserved. When special install flag is set to one, the load address of the task segment.

20-21

22-23

2270507·9701

Reserved. When special install flag is set to one, the length of the task segment.

Reserved. When special install flag is set to one, the length of the portion of the task segment that is not overlaid.

3-5

3.3 Program File Management

The following is an example of coding for a supervisor call block for an Install Task Segment SVC:

ITASK ITERR

EVEN BYTE >25 BYTE 0 BYTE >2C BYTE >83 TEXT'MYTASK

BYTE >88 BYTE 2 DATA 0 BYTE >4A BYTE 0 DATA 0 DATA 0 DATA 0

INSTALL TASK SEGMENT ON PROGRAM FILE ASSIGNED TO LUNO >2C (LUNG IS NOT OPEN). TASK ID IS >83, TASK NAME IS MYTASK. TASK IS PRIVILEGED AND REPLICATABLE, HAS NO PROCEDURES.

INSTALL AT PRIORITY 2.

OBJECT FILE LUNO IS >4A.

3.3 INSTALLING A PROCEDURE SEGMENT OR PROGRAM SEGMENT

A task may install a procedure segment or program segment in a program file by executing an In·

stall Procedure/Program Segment SVC (opcode >26). The SVC writes the segment to the program file and writes the appropriate entry in the program file directory. The following options are available:

3-6

• The procedure segment or program segment may be installed as memory resident. (The procedure segment or program segment does not actually become memory resident until the next IPL. It may be executed from the disk until the next IPL.)

• The procedure segment or program segment may be installed as delete protected.

• The procedure segment or program segment may be installed as execute protected in the Model 990/12 Computer.

• The procedure segment or program segment may be installed to use the writable control store in the Model 990/12 Computer.

• The procedure segment or program segment may be installed as write protected in the Model 990/12 Computer.

2270507·9701

Program File Management 3.3

The supervisor call block for the SVC is as follows:

SVC > 26 - - INSTALL PROCEDURE/PROGRAM SEGMENT

ALIGN ON WORD BOUNDARY PRIVILEGED TASKS ONLY

DEC HEX

0 0 >26 < RElURN CODE>

2 2 PROGRAM FILE LUNa SEGMENT 10

4 4

,..i.I , . J

PROCEDURE SEGMENT NAME

'r-' ^{r J}

10 A

12 C FLAGS

I

OBJECT FILE LUNa

14 E RESERVED OR LOAD ADDRESS

16 10 RESERVED OR SEGMENT LENGTH

1 8 12 FLAGS

I

^RESERVED

2279445

The call block contains the following:

Byte

o

2270507·9701

Contents

Opcode, >26.

Return code. ONOS returns zero when the operation completes satisfac-torily. When the operation completes in error, ONOS returns an error code.

Program file LUNO, or zero. The LUNO assigned to the program file.

When this field contains zero, install procedure segment or program seg-ment on program file .S$SHAREO. When this field contains >FF, install the segment on the program file on which the calling task resides. If the special install flag is set to one, the LUNO must be open for exclusive write. Otherwise, the LUNO must be closed.

Procedure or program segment 10, or zero. When this field contains zero, ONOS assigns an available 10 and returns the 10 in this field. The user may specify the procedure or program segment 10 in this byte.

3-7

3.3 Program File Management name consists of not more than eight alphanumeric characters, the first of which must be alphabetic. The name is left justified in the field, filled

1 - Procedure segment or program segment is installed as memory resident.

o -

Procedure segment or program segment is installed as disk resident.

Bit 3 - Delete protected flag. Set as follows:

1 - Procedure segment or program segment may not be deleted until this 'flag is set to zero (refer to the Modify Procedure Seg-ment Entry (MPE) command in the ONOS SCI Reference Manual).

o -

Procedure segment or program segment may be deleted.

Bit 4 - For a procedure segment, writable control store flag. Set as follows:

1 - Task uses writable control store (Model 990/12 Computer only).

o -

Task does not use writable control store. only). Execute protection prohibits instruction accesses to the memory in which the task is loaded.

2270507 -9701

Program File Management 3.3

Byte Contents

Bit 7 - For a procedure or program segment, the special install flag. Set to zero. The flag is set to one only by the system to install a procedure segment when the image is already on the pro-gram file. Installation consists only of writing the file directory entry.

13 Object file LUNO. The LUNO assigned to the object file. This LUNO must not be open.

Bit 0 - Segment flag. Set as follows:

1 - Install a program segment.

0 - Install a procedure segment.

14-15 Reserved. When the special install flag (bit 7 of byte 12) is set to one, the load address of the procedure segment.

Bit 0 - Segment flag. Set as follows:

1 - Install a program segment.

0 - Install a procedure segment.

16-17 Reserved. When the special install flag (bit 7 of byte 12) is set to one, the length of the procedure segment.

18 Flags. For a procedure segment, set to zero. For a program segment, set as follows:

Bit 0 - Reserved. Set to zero.

Bit 1 - Writable control store.

1 - Program segment accesses writable control store (Model 990/12 Computer only).

o -

Program segment does not access writable control store.

Bit 2 - Execute protect.

1 - Set hardware execute protection for program segment (Model 990/12 Computer only).

o -

Do not set hardware execute protection.

Bit 3 - Write protect.

1 - Set hardware write protection for program segment (Model 990/12 Computer only).

o -

Do not set hardware write protection.

Bit 4 - Updateable.

1 - Program segment will be rewritten to the program file by the segment manager if modified.

o -

Program segment will not be rewritten to the program file by the segment manager.

Bit 5 - Reusable.

1 - Program segment may be used consecutively without reloading.

o -

Program segment must be reloaded for each access.

3-9

3.4 Program File Management

Bit 6 - Copyable.

1 - Program segment may be replicated by copying an in-memory copy.

o -

Program segment may be replicated only by copying the disk-resident copy.

Bit 7 - Reserved.

Reserved.

The following is an example of coding for a supervisor call block for an Install Procedure/Segment SVC:

IPROC IPERR PROCID

EVEN BYTE >26 BYTE 0 BYTE >AA BYTE 0

TEXT'MYPROC BYTE 0

BYTE >BB DATA 0 DATA 0 BYTE 0 BYTE 0

INSTALL PROCEDURE ON PROGRAM FILE ASSIGNED TO LUNO >AA (LUNO IS NOT OPEN). PROCEDURE 10 IS ASSIGNED BY THE SYSTEM. OBJECT FILE LUNO IS >BB. PROCEDURE NAME IS

MYPROC

3.4 INSTALLING AN OVERLAY

A task may install an overlay in a program file by executing an Install Overlay SVC (opcode >27).

The SVC writes the overlay module to the program file and writes the appropriate entry in the pro-gram file directory. The following options are available:

•

The overlay may be installed as relocatable

•

The overlay may be installed as delete protected

3-10 2270507·9701

Program File Management 3.4

The supervisor call block for the SVC is as follows:

SVC > 27 - - INSTALL OVERLAY ALIGN ON WORD BOUNDARY PRIVILEGED TASKS ONLY

OEC HEX

0 0 >27 < RETURN CODE>

2 2 PROGRAM FILE LUNO OVERLAY 10

4 4

,-v r>.JI

"1'" OVERLAY N A ME r

10 A

12 C FLAGS Assoc IATED SEGMENT 10

14 E OBJECT FILE LUNO RESERVED

16 10 RESERVED OR LOAD ADDRESS

18 12 RESERVED OR OVERLAY LENGTH

20 14 RESERVED

2279446

The call block contains the following:

Byte

o

2270507-9701

Contents Opcode, >27.

Return code. ONOS returns zero when the operation completes satisfac-torily. When the operation completes in error, ONOS returns an error code.

Program file LUNO, or zero. The LUNO assigned to the program file.

When this field contains zero, install overlay on .S$SHAREO. When tHis field contains >FF, install overlay on the program file on which the call-ing task resides. If special install flag is set to one, LUNO must be open for exclusive write. Otherwise, LUNO must be closed.

Overlay ID, or zero. When this field contains zero, ONOS assigns an available 10, and returns the 10 in this field. The user may specify the overlay 10 in this byte.

3-11

3.4 Program File Management

3-12

Byte Contents

4-11 Name of overlay, or zero. When this field contains zero, ONOS uses the lOT in the object module as the overlay name. The name consists of not more than eight alphanumeric characters, the first of which must be alphabetic. The name is left justified in the field, filled to the right with spaces.

15 16-17 18-19

20-21

Flags.

Bit 0 - Relocation flag. Set as follows:

1 - Relocation of addresses in the overlay is performed when the overlay is loaded.

o -

The overlay is to be loaded without relocation.

Bits 1-2 - Reserved.

Bit 3 - Delete protected flag. Set as follows:

1 - Overlay may not be deleted until this flag is set to zero (refer to the Modify Overlay Entry (MOE) command in the DNOS System Command Reference (SCI) Reference Manual).

o -

Overlay may be deleted.

Bits 4-5 - Reserved.

Bit 6 - Task/Segment flag. Set as follows:

1 - Associated segment 10 is a program segment 10.

o -

Associated segment 10 is a task segment 10.

Bit 7 - Special install flag. Set to zero. The flag is set to one only by the system to install an overlay when the program image is already on the program file. Installation consists of writing the file directory entry.

Associated segment 10. Installed 10 of the segment associated with the overlay. Overlay and segment must be on the same program file. Overlay is deleted automatically when the segment is deleted.

Object file LUNO. The LUNO assigned to the object file. This LUNO must not be open.

Reserved.

Reserved. When special install flag is set to one, load address of overlay.

Reserved. When special install flag is set to one, length of overlay in bytes.

Reserved.

2270507·9701

Program File Management 3.5

The following is an example of coding for a supervisor call block for an Install Overlay SVC:

IOVLY IOERR OVUD

EVEN BYTE >27 BYTE 0 BYTE >CA BYTE 0 TEXT 'OLAY1 BYTE >80 BYTE >83 DATA >OA DATA 0 DATA 0 DATA 0

INSTALL OVERLAY ON PROGRAM FILE ASSIGNED TO LUNO >CA (LUNO IS NOT OPEN). OVERLAY ID IS ASSIGNED BY THE SYSTEM. OVERLAY NAME IS OLAY1. OBJECT FILE LUNO IS >OA.

OVERLAY IS RELOCATABLE AND IS ASSOCIATED WITH TASK >83.

Dans le document Manual Call (Page 48-59)