| TITLE | VALUE | |
|---|---|---|
| NAME | DSIC FM DINUM | |
| DESCRIPTION | This will do a lookup on the inputted file for the requested value. This is only for files whose .01 field is defined to be a DINUM pointer to a file. If the lookup value in not in the inputted file, then this will add that pointer to that file. | |
| TAG | DINUM | |
| ROUTINE | DSICFM02 | |
| INPUT PARAMETERS | SEQUENCE NUMBER | 1 |
| INPUT PARAMETER | FILE | |
| DESCRIPTION | This is the file number of the DSS file which has a .01 DINUM'd field | |
| PARAMETER TYPE | LITERAL | |
| REQUIRED | YES | |
| MAXIMUM DATA LENGTH | 20 | |
| INPUT PARAMETERS | SEQUENCE NUMBER | 2 |
| INPUT PARAMETER | IEN | |
| DESCRIPTION | This is the ien of the pointed to file. If the .01 field is not a pointer field then this parameter should not be passed when trying to add a new entry to the file. | |
| PARAMETER TYPE | LITERAL | |
| REQUIRED | NO | |
| MAXIMUM DATA LENGTH | 20 | |
| INPUT PARAMETERS | SEQUENCE NUMBER | 3 |
| INPUT PARAMETER | VAL | |
| DESCRIPTION | This is the external value of the .01 field. If the .01 field is a pointer field, then this would be some external lookup value for the pointed to file. If the .01 field is not a pointer, then this must numeric. | |
| PARAMETER TYPE | LITERAL | |
| REQUIRED | NO | |
| MAXIMUM DATA LENGTH | 80 | |
| INPUT PARAMETERS | SEQUENCE NUMBER | 4 |
| INPUT PARAMETER | IENS | |
| DESCRIPTION | This field is only valid if you are trying to add a DINUM'd value to a multiple in the FILE. The syntax of iens is ,S1,S2,S3, See M programmers for precise syntax to use if you need this. | |
| PARAMETER TYPE | LITERAL | |
| REQUIRED | NO | |
| MAXIMUM DATA LENGTH | 30 | |
| RETURN VALUE TYPE | SINGLE VALUE | |
| RETURN PARAMETER DESCRIPTION | Return the internal entry number (ien) of the item looked up or added. On error, return -1^error message | |
| AVAILABILITY | AGREEMENT | |
| INACTIVE | ||
| CLIENT MANAGER | ||
| WORD WRAP ON | ||
| VERSION | ||
| SUPPRESS RDV USER SETUP | ||
| APP PROXY ALLOWED | ||