DSSO FM GETS (5070)    REMOTE PROCEDURE (8994)

Name Value
NAME DSSO FM GETS
TAG GETS
ROUTINE DSSOFM2
RETURN VALUE TYPE GLOBAL ARRAY
WORD WRAP ON TRUE
DESCRIPTION 
This RPC provides GETS^DIQ functionality.  File and fields to be returned 
are specified by the GUI.  NOTE:  This RPC does not handle subfiles.
INPUT PARAMETER
  • DSSOFILE
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   15
    REQUIRED:   YES
    SEQUENCE NUMBER:   1
    DESCRIPTION:   
    File number
NOTE:  Subfiles are not handled by this RPC.
  • DSSOIEN
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   15
    REQUIRED:   YES
    SEQUENCE NUMBER:   2
    DESCRIPTION:   
    Standard IEN indicating internal entry number of input file.
  • DSSOFLDS
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   245
    REQUIRED:   YES
    SEQUENCE NUMBER:   3
    DESCRIPTION:   
    A single field number or a list of field numbers separated by 
semicolons(;)
  • DSSOFLGS
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   2
    REQUIRED:   NO
    SEQUENCE NUMBER:   4
    DESCRIPTION:   
    Optional - flags to control processing:
   E  - returns External value (this is the default)
   I  - returns Internal value
   EI - returns External and Internal values.  If both values
        are requested ("EI" or "IE"), they will always be 
        returned in "EI" order.
RETURN PARAMETER DESCRIPTION 
Output:  Error:    "-1^"_error message up to 245 characters
                                "~" internal value (if requested)
                                The format of field number and
                                external/internal values repeats 
                                for each requested field number.
                                n=line number
                             NOTE:  Every field number is preceded
                                      by a "^".
                                    Each value is preceded by a "~".
         Success:  All data is returned in this format -
                   multiple lines may be returned depending
                   on the number of fields and whether both
                   external and internal values are requested:
                   
                   DSSORET(n) = line number 
                                "^" field number
                                "~" external value (if requested)