DSIC FM PULL LIST

TITLEVALUE
NAMEDSIC FM PULL LIST
DESCRIPTIONReturns values to populate a list box of choices for a field that is
SET OF CODES or POINTER or VARIABLE POINTER type.
VARIABLE POINTER.
TAGPULL
ROUTINEDSICFM
INPUT PARAMETERSSEQUENCE NUMBER1
INPUT PARAMETERFILE
DESCRIPTIONFile or subfile number (canonic).
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH20
INPUT PARAMETERSSEQUENCE NUMBER2
INPUT PARAMETERFIELD
DESCRIPTIONField number (canonic) of field for which choices are desired.
Field must be set of codes or pointer or variable pointer.
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH20
INPUT PARAMETERSSEQUENCE NUMBER3
INPUT PARAMETERSTART
DESCRIPTIONThis parameter is optional and applies only to POINTER and VARIABLE
POINTER field types. It is not used with SET OF CODES type.

Starting value for search. If specified this is usually the last
value returned from the previous call. If the field is a POINTER
only the value should be argued. If the field is a VARIABLE
POINTER, both value and file should be argued, as VALUE^FILE.
Both "^"-pieces can be copied from the last returned value.
PARAMETER TYPELITERAL
REQUIREDNO
MAXIMUM DATA LENGTH245
INPUT PARAMETERSSEQUENCE NUMBER4
INPUT PARAMETERMAX
DESCRIPTIONThe maximum number of values to return. The default is 200.
For VARIABLE POINTER fields the sum accumulates across pointed-to
files.
PARAMETER TYPELITERAL
REQUIREDNO
MAXIMUM DATA LENGTH20
INPUT PARAMETERSSEQUENCE NUMBER5
INPUT PARAMETERMASK
DESCRIPTIONAn optional mask that constrains the values to be returned.
For example, "SMI" returns all values that start with the "SMI"
like SMITH, filtering out values that do not start with the
specified mask like SAM.
value, not the external value of a field. PART is often a partial match
to FROM. For example, FROM(1)="ZTMMGR", and PART(1)="ZTM" would return
only entries that began with "ZTM" and came after "ZTMMGR". It would not
include "ZTZERO", even though it comes after "ZTMMGR".
PARAMETER TYPELITERAL
REQUIREDNO
MAXIMUM DATA LENGTH245
RETURN VALUE TYPEGLOBAL ARRAY
RETURN PARAMETER DESCRIPTIONGlobal array of values in the format IEN^NAME[^FILE], where the
third "^"-piece applies only to the VARIABLE POINTER field type.
List[0] := ^code where code equals:
S:set of codes P:pointer V:variable pointer
List[i] := value for i=1,2,3,4,5,...,n+1 for n entries
value equals:
for set of codes field type, value = code:code meaning
for pointer field type, value = p1^p2
for variable pointer field type, value = p1^p2^p3
where for pointer type fields,
p1 = ien of pointed to file
p2 = external representation of .01 field from pointer to file
p3 = file number of pointed file [only returned for var ptr]

If problems or no records found, return List[0] = -1^message
AVAILABILITYAGREEMENT
INACTIVE
CLIENT MANAGER
WORD WRAP ONTRUE
VERSION
SUPPRESS RDV USER SETUP
APP PROXY ALLOWED