Guardian Procedure Calls Reference Manual

incorrectly formatted, the FILE_GETINFOBYNAME_ caller receives device type and subtype
values of 0. The REPLY caller (the subtype 30 process) receives an error 2.
A deadlock occurs if a subtype 30 process calls FILE_GETINFOBYNAME_ on its own process
name.
• Using the nowait option
If you call FILE_INFOBYNAME_ procedure in a nowait manner, the results are returned in the
nowait FILE_GETINFOBYNAME_ completion message (-108), not in the output parameters of
the procedure. The format of this completion message is described in the Guardian Procedure
Errors and Messages Manual. If error is not 0, no completion message is sent to $RECEIVE.
Errors can be reported either on return from the procedure, in which case error might be
meaningful, or through the completion message sent to $RECEIVE.
The system reports a path error only after automatically making retries.
When the nowait option is used, any step of the inquiry operation might be asynchronous to
the caller. However, only simulation inquiries to subtype 30 processes are guaranteed to be
asynchronous.
When a process pair uses the nowait option, the nowait FILE_GETINFOBYNAME_ completion
message is sent only to the process that made the call, not to the other member of the pair.
Switching ownership from the primary to the backup process can leave outstanding inquiries.
The CHECKSWITCH procedure automatically discards these as it becomes the backup process.
OSS Considerations
• Use the flags parameter of FILE_GETINFO_ or FILE_GETINFOBYNAME_ or use item code
161 of FILE_GETINFOLIST_ or FILE_GETINFOLISTBYNAME_ to determine whether the file is
an OSS file.
• Use the item-list parameter of FILE_GETINFOLIST_ or FILE_GETINFOLISTBYNAME_ to
specify which OSS file attribute values are to be returned.
Example
error := FILE_GETINFOBYNAME_ ( name:length,typeinfo,reclen );
Related Programming Manuals
For programming information about the FILE_GETINFOBYNAME_ procedure, see the Guardian
Programmer's Guide. For information on the SQL objects and programs, see the HP NonStop
SQL/MP Programming Manual for C and the HP NonStop SQL/MP Programming Manual for
COBOL.
410 Guardian Procedure Calls (F)