/sys$common/syshlp/helplib.hlb FDL Routines, FDL$GENERATE, Arguments *Conan The Librarian (sorry for the slow response - running on an old VAX) |
flags OpenVMS usage:mask_longword type: longword (unsigned) access: read only mechanism: by reference Flags (or masks) that control how the fdl_str_dst argument is interpreted and how errors are signaled. The flags argument is the address of a longword containing the control flags (or a mask). If you omit this argument or specify it as zero, no flags are set. The flags and their meanings are as follows: Flag Function FDL$V_FDL_ Interprets the fdl_str_dst argument as an FDL STRING specification in string form. By default, the fdl_str_dst argument is interpreted as the file name of an FDL file. FDL$V_FULL_ Includes the FDL attributes to describe all OUTPUT the bits and fields in the OpenVMS RMS control blocks, including run-time options. If this flag is set, every field is inspected before being written. By default, only the FDL attributes that describe permanent file attributes are included (producing a much shorter FDL specification). FDL$V_LONG_ Returns the FDL_FILE_RESNAME using the long NAMES result name from a long name access block (NAML). By default, the FDL_FILE_RESNAM is returned from the short fields of a name access block (NAM) and thus may have a generated specification. This flag is valid for OpenVMS Alpha only. FDL$V_SIGNAL Signals any error. By default, the status code is returned to the calling image. By default, an error status is returned rather than signaled. fab_pointer OpenVMS usage:address type: longword (unsigned) access: read only mechanism: by reference RMS file access block (FAB). The fab_pointer argument is the address of a longword containing the address of a FAB. rab_pointer OpenVMS usage:address type: longword (unsigned) access: read only mechanism: by reference RMS record access block (RAB). The rab_pointer argument is the address of a longword containing the address of a RAB. fdl_file_dst OpenVMS usage:char_string type: character-coded text string access: read only mechanism: by descriptor Name of the FDL file to be created. The fdl_file_dst argument is the address of a character-string descriptor containing the file name of the FDL file to be created. If the FDL$V_FDL_STRING flag is set in the flags argument, this argument is ignored; otherwise, it is required. The FDL specification is written to the file named in this argument. fdl_file_resnam OpenVMS usage:char_string type: character-coded text string access: write only mechanism: by descriptor-fixed-length string descriptor Resultant name of the FDL file created. The fdl_file_resnam argument is the address of a variable character-string descriptor that receives the resultant name of the FDL file created (if FDL$GENERATE is directed to create an FDL file). fdl_str_dst OpenVMS usage:char_string type: character-coded text string access: write only mechanism: by descriptor-fixed-length string descriptor FDL specification. The fdl_str_dst argument is the address of a variable character string descriptor that receives the FDL specification created. If the FDL$V_FDL_STRING bit is set in the flags argument, this argument is required; otherwise, it is ignored. bad_blk_addr OpenVMS usage:address type: longword (unsigned) access: write only mechanism: by reference Address of an invalid RMS control block. The bad_blk_addr argument is the address of a longword that receives the address of an invalid control block (a fatal error). If an invalid control block is detected, this argument is returned; otherwise, it is ignored. retlen OpenVMS usage:longword_unsigned type: longword (unsigned) access: write only mechanism: by reference Number of characters received in either the fdl_file_resnam or the fdl_str_dst argument. The retlen argument is the address of a longword that receives this number.
|