DEXEC 6 (Remote Program Termination)

Using this DEXEC call your program can inform an RTE operating system that it wants to terminate execution of itself or another program. DEXEC 6 works only on programs that were originally started by a DEXEC 9, 10, 23, or 24 call.

DEXEC(dest,code,name,numb)

If the program is to terminate itself (local operation only), optional parameters can be used as follows:

DEXEC(dest,code,name,numb[,op1][,op2][,op3][,op4][,op5])

dest

16-bit integer. The Router/1000 node address of the

 

node where the call is executed. A value of -1 indicates the

 

local node. Local execution will also be performed whenever

 

dest equals the local node address.

code

16-bit integer. Remote program termination code = 6.

name

Integer array (FORTRAN); Packed character

 

array (PASCAL). A 3word array containing the program

 

name to be terminated in the first five bytes (the sixth byte is

 

not significant). name can be the value zero which causes a

 

program to terminate itself (local operations only). Contrary to

 

usage in an EXEC call, this parameter is not optional.

numb

16-bit integer. Completion type code. Contrary to usage

 

in an EXEC call, this parameter is not optional. The

 

completion type codes follow. Note that only 0 and 1 can be

 

executed remotely.

 

–1

Serial reusability completion. When

 

 

rescheduled, the program is not reloaded if it

 

 

remained resident in memory. If this call is a

 

 

•father" program's request, it is the same as

 

 

numb = 0.

 

0

Normalcompletion.

 

1

Place program in dormant state; save current

 

 

suspension point and resources.

 

2

Terminate and remove named program from

 

 

the time list. If program is in I/O suspend

 

 

state, system waits until I/O completes before

 

 

terminating program. However, this call does

 

 

not wait. The program's disk tracks are not

 

 

released.

 

3

Terminate named program immediately,

 

 

remove it from the time list, and release

 

 

program's disk tracks. If program is in I/O

 

 

suspend state, a systemgenerated clear

 

 

request is issued to the driver. An abort

 

 

message is printed at the system console.

op1,...,op5

Up to five parameters that can be passed to the caller the next

(input/output)

time the program executes. Works when name = 0 only.

116 DEXEC