ROR TASK INFO (1765)    REMOTE PROCEDURE (8994)

Name Value
NAME ROR TASK INFO
TAG TASKINFO
ROUTINE RORRP010
RETURN VALUE TYPE ARRAY
AVAILABILITY RESTRICTED
WORD WRAP ON TRUE
VERSION 1
DESCRIPTION
The ROR TASK INFO remote procedure returns the information about the task
started from the GUI.
INPUT PARAMETER
  • TASK
    PARAMETER TYPE:   LITERAL
    REQUIRED:   YES
    SEQUENCE NUMBER:   1
    DESCRIPTION:   
    A valid task number should be assigned to the TASK parameter.
    
RETURN PARAMETER DESCRIPTION
A negative value of the first "^"-piece of the Results[0] indicates that
  Results[i]            Error Descriptor
                          ^01: Error code
                          ^02: Message
                          ^03: Place of the error
 
Error descriptors are returned in reverse chronological order (most recent
error first).                                                 
 
Otherwise, the Results[0] contains number of task descriptors returned
in the Results array (always 1) and number of elements that comprise a
an error occurred during the execution of the remote procedure. In this
task descriptor:
 
  Results[0]            Result Descriptor
                          ^01: 1
                          ^02: Number of elements that comprise a task
                               descriptor (TIN)
 
The subsequent nodes of the Results array (from 1 to TIN) contain the
information about the scheduled task:
 
case, the second piece of the Results[0] will contain number of the error
  Results[1]            Task Number
  Results[2]            Task Type           (internal^external)
  Results[3]            Registry            (IEN^Name)
  Results[4]            Report              (Code^Name)
  Results[5]            Task Description
  Results[6]            Task Status         (internal^external)
  Results[7]            Creation Time       (FileMan)
  Results[8]            User                (DUZ^Name)
  Results[9]            Completion Time     (FileMan)
  Results[10]           Progress Percentage
descriptors returned in the subsequent nodes of the Results array.
  Results[11]           Scheduled to Run at (FileMan)
  Results[12]           Task Log IEN
  Results[13]           Job Number
  Results[14]           User Comment
 
  Results[0]            Result Descriptor
                          ^01: The last error code (LASTERR)
                          ^02: Number of the error descriptors