Guardian Procedure Calls Reference Manual

The system specified could not be accessed.4

Parameter error.99

Considerations

• The device name is returned in network form whenever the sysnum parameter is supplied

(except when the local system number is specified).

• If the sysnum parameter is supplied, devices whose names contain seven characters are not

accessible using this procedure. This is because internal-form network names are limited to

six characters.

• A process name is returned as a device name if you specify a logical device number that

corresponds to a destination control table (DCT) entry for a process.

• If the devname being returned is that of a demountable disk, and the disk has been demounted

or is down, GETDEVNAME returns a status of 0, and the name returned will be one of these:

◦ 4 words of blanks (" "," "," "," ")

◦ 4 words of zero (0,0,0,0)

◦ 1 word identifying the node number and 3 words of blanks, for example, "\n"," "," ","

" (n is the value in SYSNUM)

◦ 1 word identifying the node number and 3 words of zero for example, "\n",0,0,0 (n is

the value in SYSNUM)

Example

INT system; !target system

INT ldev; !ldev to start search

INT name [0:3] := [" "];

STRING names = name;

INT status;

! get next disk name

BEGIN

ldev := ldev + 1;

status := getdevname ( ldev, name, system, 3 );

END

UNTIL (status '>' 1)

OR (name AND name <> " "

AND NOT (names = "\" AND (name[1] = " "

OR name[1] = 0)));

GETDEVNAME Procedure (Superseded by FILENAME_FINDNEXT_ Procedure) 659