Calling sequences and return codes

In all the routines listed below, a return code of zero indicates success and non-zero returns codes indicate failure. Some routines use the IQUEST vector to return error information. To test on results returned via IQUEST, the following definition should be added to the calling routine.

      COMMON/QUEST/IQUEST(100)

In the following descriptions, the generic name argument GENAM or path name PATH should be declared as CHARACTER*255. All other arguments are of type INTEGER unless otherwise specified. Arguments followed by an asterisk (*) are output parameters. Arguments both preceeded and followed by asterisks are input parameters which are overwritten on output. All other arguments are input only. Optional arguments are specified by passing an INTEGER zero or a blank character, depending on the datatype.

Generic names and path names

Given the generic name //CERN/DELPHI/P01ALLD/CDST/S2PR/Y91V02/E091.3/L0678/R023808F01C1 the path name is //CERN/DELPHI/P01ALLD/CDST/S2PR/Y91V02/E091.3/L0678. That is, the path name contains only the names of the directories where a file resides, whereas the generic name contains the full name.