DSIV DDR GETS EXTENDED DATA (3634)    REMOTE PROCEDURE (8994)

Name Value
NAME DSIV DDR GETS EXTENDED DATA
TAG GET2
ROUTINE DSIVDDR0
RETURN VALUE TYPE GLOBAL ARRAY
AVAILABILITY AGREEMENT
WORD WRAP ON TRUE
APP PROXY ALLOWED Yes
DESCRIPTION
This calls GETS^DIQ to get a list of field values for a record.
 
This variant returns data in chunks if greater than 255 characters rather 
than cutting the data off.
INPUT PARAMETER
  • FILE
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   20
    REQUIRED:   YES
    SEQUENCE NUMBER:   1
    DESCRIPTION:   
    This is the number of the file in which you wish to search.
    
  • IENS
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   20
    REQUIRED:   YES
    SEQUENCE NUMBER:   2
    DESCRIPTION:   
    This is the IENS for the search. See the instructions on constructing an 
    IENS in the FileMan Programmer's Manual
    
  • FIELD
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   250
    REQUIRED:   YES
    SEQUENCE NUMBER:   3
    DESCRIPTION:   
    This is an ^ (or ";") delimited list of field numbers to return from the 
    entry identified in IENS
    
  • FLAGS
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   20
    REQUIRED:   YES
    SEQUENCE NUMBER:   4
    DESCRIPTION:   
     This is a string containing up to 3 characters that will modify how
     
     If the W flag is passed, then this call expects that the Field parameter
     will have a single field number only.  The W flag must be sent by
     itself.  It cannot be combined with other flags.  W introduced 12/9/2003.
     
     If the result for a particular field is greater than 255 characters, it 
     will be broken into two nodes with the continuing data being denoted by 
     $$CONT$$.
     FileMan presents the results of this operation:
     
            E: Return data in external format
            I: Return data in internal format
     
            N: Do NOT return null values - not to be used by DSS GUI
            R: Resolves field numbers to field names
            W: Input field is a word processing field
    
RETURN PARAMETER DESCRIPTION
 Returns an array with the following format:
 For a word processing field, return List[n] := text   n=1,2,3,...
 
 For non-word processing fields, List[n] := p1^p2^p3^p4^p5   n=1,2,3,...
   p1 = file number (or subfile#)
   p2 = iens
   p3 = field number or field name
   p4 = value for that field
   p5 = I if value in internal format, else E if in external format