| TITLE | VALUE | |
|---|---|---|
| NAME | DSIC LOCK | |
| DESCRIPTION | This will allow a GUI application issue a LOCK or UNLOCK on a global node or a record in a file. If the LOCK is issued, it is the responsibility of the application to issue the UNLOCK. | |
| TAG | LOCK | |
| ROUTINE | DSICLOCK | |
| INPUT PARAMETERS | SEQUENCE NUMBER | 1 |
| INPUT PARAMETER | REF | |
| DESCRIPTION | This can be a closed form of a global or it can be a file number. If it is a file number, then IFN is also required. The file number can be the file number of the entire file or the subfile number of corresponding to the ^DD() value. If it is a subfile, then the IFN parameter must be set accordingly. Examples of globals: ^DSI(19621,0) - since there is no record number the global name has to be passed ^DSI(19621,"B") | |
| PARAMETER TYPE | LITERAL | |
| REQUIRED | YES | |
| MAXIMUM DATA LENGTH | 128 | |
| INPUT PARAMETERS | SEQUENCE NUMBER | 2 |
| INPUT PARAMETER | IFN | |
| DESCRIPTION | This is the internal entry number (record number) of the record that you wish to lock or unlock in the file specified in the REF parameter. IFN is required if the REF parameter is a file or subfile number. IFN is the IEN if you are locking the entire record. If you are locking a subrecord in a multiple, the IFN must be a proper IENS at the appropriate level as documented in the Fileman DBS manuals. | |
| PARAMETER TYPE | LITERAL | |
| REQUIRED | NO | |
| MAXIMUM DATA LENGTH | 15 | |
| INPUT PARAMETERS | SEQUENCE NUMBER | 3 |
| INPUT PARAMETER | FLAG | |
| DESCRIPTION | This flag indicates whether or not the global reference should be locked or unlocked. The default value is 1 which means to lock the global. If it has a value of -1 then unlock the global reference. | |
| PARAMETER TYPE | LITERAL | |
| REQUIRED | NO | |
| MAXIMUM DATA LENGTH | 2 | |
| RETURN VALUE TYPE | SINGLE VALUE | |
| RETURN PARAMETER DESCRIPTION | If the operation was successful, return 1 Else return -1^message | |
| AVAILABILITY | AGREEMENT | |
| INACTIVE | ||
| CLIENT MANAGER | ||
| WORD WRAP ON | ||
| VERSION | ||
| SUPPRESS RDV USER SETUP | ||
| APP PROXY ALLOWED | ||