DSTAT

This routine is called to obtain status information for all mounted cartridges in the cartridge directory. DSTAT is equivalent to the FMGR routine FSTAT.

DSTAT(stat,err,dest[,erlc][len][,form][,op][,add])

statInteger array. Status buffer. An array to which the cartridge directory status is returned. Default is 125 words.

err

16-bit integer. Error return variable. (See •RFA

 

Common Parameters" for more information.)

dest

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

 

destination node. A variable that contains a decimal value

 

specifying the nodal address for which the status information is

 

to be obtained. The value of this parameter may either be

 

positive to denote the node number or negative to denote the

 

communications line logical unit number.

erlc

16-bit integer. Error condition location. (See •RFA

 

Common Parameters" for more information.)

len

16-bit integer. Length in words of buffer stat. Default

 

is 125 words.

form

16-bit integer. If form is zero, the disk directory will be

 

written in FORMAT I (default). If it is nonzero, the disk

 

directory will be written into the buffer in FORMAT II. This is

 

exactly as it appears on disk. (Refer to the following tables for

 

information on the two formats.)

op

16-bit integer. A oneword variable specifying the type of

 

cartridges about which information is to be returned. If equal

 

to 1, all disks mounted to the system are returned in stat. If

 

equal to 0, system disks and nonsession disks are returned in

 

that order. (If op is equal to 0 and the remote node is an

 

RTE6/VM system with Session Monitor, private and group

 

disks mounted to the session and system disks are returned, in

 

that order.)

add

16-bit integer. Returned nonzero by the system if not all

 

of the cartridge list could be returned in stat (buffer not large

 

enough).

Remote File Access 1013